open-sea-skin README

The project's README from github.com/d-dev0101/open-sea-skin. As one markdown file: README.md.

Open Sea Skin

Interactive website · 中文 · Architecture · Release guide

Before installing, preview the official website first

Open the live demo, tune the waves, sunset, and glass transparency, then install only after you like the result.

Official website · Install guide · Releases · Source code · DSH plugin directory · Support / Issues

Need login or installation help? Leave a message in Issues and mention @d-dev0101.

A self-contained WebGPU ocean skin for DeepSeek Harness. It keeps the original five-wave Gerstner/TSL look, adds a translucent Harness theme, and is available as a one-line DSH plugin, Harness-only Chrome/Edge extension, one-command static installer, or native Harness source integration.

Open Sea for DeepSeek Harness

Install the complete local-only ocean runtime and lower-left quick controls from npm (no Git checkout or install-time build required):

dsh plugin --profile web add [email protected]

Restart dsh web, then use Skin settings at the lower left to adjust wave size, daylight, 40% glass opacity, and the automatic day/night cycle. Remove it with:

dsh plugin --profile web remove open-sea-skin

This package is tested with DeepSeek Harness 0.1.2-alpha.3. Use the source integration below only when you also want the controls embedded inside the native General settings page. See the DSH installation and troubleshooting guide for verification and recovery details.

Every animation below is recorded from the native DeepSeek Harness integration at 40% glass opacity. The overview baseline is wave size 56 and daylight Afternoon (55).

1 — Dark Harness overview

Open Sea inside DeepSeek Harness in dark mode

2 — Light Harness overview

Open Sea inside DeepSeek Harness in light mode

3 — Adjusting wave size

Daylight stays at Afternoon (55) while the wave control moves from moderate to calm, through high sea, and back to the baseline of 56.

Adjusting wave size in DeepSeek Harness

4 — Daylight to sunset

Wave size stays at 56 while daylight moves smoothly from Midday to Dusk.

Adjusting daylight from midday to sunset

Install option 1 — Chrome or Edge extension

  1. Download and unzip the latest open-sea-skin-extension-*.zip release, or clone this repository.
  2. Open chrome://extensions (Edge: edge://extensions) and enable Developer mode.
  3. Select Load unpacked and choose this repository's extension/ folder.
  4. Open DeepSeek Harness on 127.0.0.1 or localhost, then reload it once.

The extension does not replace Chrome or Edge's new-tab page, change the browser homepage, or interfere with an existing new-tab extension. It verifies the Harness title, root, and server-injected boot marker before changing a page, so other local development sites also remain untouched. Use the toolbar popup to disable the Harness skin. The lower-left wave button opens sea-state, daylight, and glass-opacity controls. Values are saved with chrome.storage.sync.

Install option 2 — Harness static build (no source compilation)

Run this from any directory. It downloads the pinned v1.2.4 source archive to a temporary directory, runs the installer, and removes the download when it finishes. Stop Harness before running it, then start dsh web again, keep that terminal process running, and reload the browser:

curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash

The script finds a built/installed Harness frontend, makes a local backup, copies the self-contained assets, and injects one marked loader block. If automatic detection cannot find the frontend, pass it explicitly:

curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash -s -- --dist /absolute/path/to/apps/web/dist

Re-run the bootstrap with --update after every Harness upgrade:

curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash -s -- --update

Remove only Open Sea's marker and assets with:

curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash -s -- --uninstall

The command is safe to copy while your terminal is in ~; it does not assume that this repository already exists locally. You can inspect the bootstrap script before running it. See native-dist/README.md for clone-based installation, detection, and recovery details.

If the browser says Failed to load plugins immediately after installation or removal, first confirm that dsh web is still running. The static installer changes files only; it does not start or keep the Harness server alive.

Native Harness source plugin

For a first-class General-settings row and layout slot, integrate the package into a Harness source checkout:

git clone https://github.com/deepseek-ai/deepseek-harness.git
bash harness-plugin/install-into-harness.sh /absolute/path/to/deepseek-harness
cd /absolute/path/to/deepseek-harness
corepack pnpm install --no-frozen-lockfile
corepack pnpm run build
corepack pnpm dsh web

Use the native Skin settings action at the lower left for fast adjustments, or open Settings → General → Open Sea Skin for every option. Both surfaces use Harness settings, locale, slots, and reversible theme-token APIs; neither depends on CSS-module hashes. The integration is tested against Harness 0.1.2-alpha.3, commit dd6322d60 (2026-08-31), and deliberately stops if upstream anchors have changed. More details are in harness-plugin/README.md.

What is included

site/ preserves the original CDN-backed showcase byte-for-byte. The optimized self-contained runtime has its canonical source in shared/; npm run build produces the three installable copies.

Development and verification

Node.js 20+ is required for repository checks:

npm run build
npm run check
npm run package:extension

The full browser acceptance run requires Chrome for Testing and Playwright:

npm ci
npx playwright install chromium
npm run test:browser

The launcher uses a persistent profile, --load-extension, and ignoreDefaultArgs: ['--disable-extensions'], which is required because branded Chrome 137+ removed the old extension-loading path. The four full-width README GIFs are regenerated from a running native Harness with npm run capture; FFmpeg is required for palette-optimized output.

Privacy and permissions

Open Sea Skin collects, transmits, sells, or shares no data. The extension requests only storage plus access to http://127.0.0.1/* and http://localhost/* so it can skin a local Harness page. It has no remote host permission. See docs/privacy.md.

License

Project code is MIT licensed. three.js 0.178.0 remains under MIT; the self-hosted Geist fonts remain under SIL OFL 1.1. See THIRD_PARTY_NOTICES.md and the vendored license copies.

open-sea-skin (d-dev0101/open-sea-skin)

Searching Database…

395 ·GitHub
Open-sea-skin
What is this?Open Sea Skin is an animated, WebGPU-powered ocean theme for DeepSeek Harness (DSH) that adds adjustable waves, a sunset cycle, and glass opacity to the Harness new-tab/homepage.
Is this a browser extension or a DSH plugin?Both: it ships as a one-line DSH plugin installed via npm, as a Chrome/Edge browser extension, as a one-command static installer, or as a native Harness source integration.
How do I install it on my DeepSeek Harness?The recommended path is installing the package as a DSH plugin from npm, then restarting `dsh web`; after that you adjust wave size, daylight and glass opacity from the lower-left Skin settings panel.
Does it need Harness running, or anything else?You need a running DeepSeek Harness instance (tested against 0.1.2-alpha.3); for development/build/testing tasks Node.js 20+ is required.
Any install pitfalls I should know about?The static installer only edits files on disk; it does not start or keep the Harness server running, so you must stop Harness, run the bootstrap, then manually restart `dsh web` yourself.
Does it work on Windows, macOS, and Linux?Yes — since it runs inside your local DeepSeek Harness instance (via plugin or static install) or as a Chrome/Edge extension, it works on any OS that runs Harness and a Chromium-based browser.
Does the extension send any data out?No. It collects, transmits, sells, or shares no data, and the extension requests only storage access plus permission to run on your local Harness page — there is no remote host permission.
What rendering tech powers the ocean effect?It uses WebGPU with three.js 0.178.0 and TSL to render five Gerstner waves with analytic normals, Fresnel sky reflection, sun glitter, foam, fog, bloom and ACES tone mapping.
Will the extension mess with my other new-tab pages or sites?No — it verifies the Harness title, root element, and a server-injected boot marker before modifying any page, so it leaves the browser's native new-tab page and other local dev sites untouched.
Can I preview the theme before installing?Yes, the README links to a live interactive demo where you can tune waves, sunset, and glass transparency before deciding to install.
Is performance tuned for lower-end machines?Yes — it includes a reduced mesh mode, adaptive render scale, FPS caps (60/30/20), hidden-tab pause, and automatic low-end device detection to keep the effect light.
What are similar projects?dsh-dream-skin, DSH-Transparent-UI-Plugin, gal-view, Youtube-Pro-Plus, dsh-liang-skin, dsh-dafeiyu, natural-disasters, dsh-damage-pulse
Which topics is it in?edge-extension, glassmorphism, webgpu, threejs, chrome-extension, browser-extension, theme, dsh, dsh-plugin, deepseek-harness, deepseek, animation
Creator
d-dev0101
Size
79 MB
Stars
395
Updated
CommitOct 11Releasev1.2.5Oct 10
Age
2mo
Commits · 90 Days