d-dev0101/open-sea-skin

English · 技术架构 · 发布说明

把实时 WebGPU 海洋同时带到浏览器新标签页和 DeepSeek Harness。保留五组 Gerstner 波与 TSL 海面视觉，增加半透明玻璃界面，并提供浏览器扩展、无需编译的 dist 安装脚本、可一行安装的 DSH 插件，以及真正接入 Harness slots/settings 的原生源码集成。

推荐：作为 DSH 插件安装

直接从 GitHub 安装完整的本地海洋运行时与左下角快捷控制：

dsh plugin --profile web add 'github:d-dev0101/open-sea-skin#v1.2.0'

重启 dsh web 后，点击左下角的皮肤设置即可调节波浪大小、日光、40% 玻璃不透明度和自动昼夜循环。卸载命令：

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

该安装包已在 DeepSeek Harness 0.1.0-rc.6 实测通过。如果还希望控制项原生 嵌入「通用设置」页面，再使用后文的源码集成方式。安装验证与排障方法见 DSH 插件安装指南。

效果图

以下动图全部来自真实 DeepSeek Harness 原生插件，统一使用 40% 玻璃不透明度。 全景基准参数为波浪大小 56、日光 下午（55）。

1 — 深色 Harness 全景

2 — 浅色 Harness 全景

3 — 调整波浪大小

日光固定为下午（55），波浪从中等变为平静，再升至大浪，最后回到基准值 56。

4 — 从白天调到夕阳

波浪固定为 56，日光从正午平滑变化到黄昏。

安装方式一：Chrome / Edge 扩展

1. 下载并解压 Release 中的 open-sea-skin-extension-*.zip，或克隆本仓库。
2. 打开 chrome://extensions（Edge 为 edge://extensions），开启右上角 开发者模式。
3. 点击加载已解压的扩展程序，选择本仓库的 extension/ 文件夹。
4. 新建标签页可看到完整海洋；打开 127.0.0.1 或 localhost 上的 Harness 即可看到玻璃海洋背景。

工具栏弹窗可以只关闭 Harness 皮肤。左下角的波浪图标可调波浪、日光和玻璃 不透明度，数值会保存到 chrome.storage.sync。

安装方式二：Harness dist 注入（无需编译源码）

可以在任意目录执行。命令会把固定版本 v1.2.0 下载到临时目录，运行安装器 后自动清理下载内容。执行前先停止 Harness；执行完成后重新运行 dsh web， 保持该终端进程运行，再刷新浏览器：

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

脚本会自动寻找已构建/已安装的 Harness 前端，先备份 index.html，再复制本地 资源并注入一段带标记的加载代码。找不到时可显式指定：

curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash -s -- --dist /绝对路径/apps/web/dist

每次 Harness 升级后必须重跑：

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

安全卸载：

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

这条命令在终端位于 ~ 时也能直接复制执行，不要求用户预先克隆仓库。运行前可 查看引导脚本源码。脚本只删除自己的标记块和 open-sea-skin/ 目录，不会用旧备份覆盖 Harness 后续更新。克隆安装、自动定位和恢复细节见 native-dist/README.md。

如果安装或卸载后出现 Failed to load plugins，先确认 dsh web 是否仍在运行。 静态安装器只修改前端文件，不会代替用户启动或维持 Harness 服务进程。

Harness 原生源码插件

希望设置项直接出现在 Harness「通用设置」中，可接入原生包：

git clone https://github.com/deepseek-ai/deepseek-harness.git
bash harness-plugin/install-into-harness.sh /绝对路径/deepseek-harness
cd /绝对路径/deepseek-harness
corepack pnpm install
corepack pnpm run build
corepack pnpm dsh web

启动后可直接点击左下角原生的皮肤设置快捷入口，也可打开 设置 → 通用设置 → 海洋皮肤查看完整选项。两处都使用 Harness 自己的 settings、locale、slots 和可逆主题令牌 API，不依赖 CSS Modules 哈希。接入 脚本已在 Harness 提交 47f943859bef（2026-08-13）验证；若上游结构变化， 脚本会停止并明确报错，不会猜测改文件。详见 harness-plugin/README.zh.md。

已完成优化

• WebGPU + three.js 0.178.0 + TSL；五组 Gerstner 波、解析法线、FBM 细节、 Fresnel 天空反射、太阳闪烁、浪尖泡沫、地平线雾、天空云带、bloom 与 ACES。
• 扩展和两种 Harness 安装均为本地资源，不请求 CDN，不含分析或遥测。
• 256×256 网格；低端/减少动态模式为 160×160；DPR 上限 1.5；0.5–1.0 自适应分辨率；60/30/20 FPS 档；标签隐藏暂停；远处跳过昂贵片元细节；皮肤 模式降低 bloom；自动识别低端设备。
• 12 分钟自动昼夜循环；手动拖动「日光」会固定当前时间，可再次开启自动循环。
• 扩展和 dist 方案共用同一个 host controller，仅持久化适配层不同。
• 三条安装路径共用 DOM 标记，避免同时安装时重复启动 WebGPU 渲染器。
• 中英双语、键盘焦点循环、Esc 关闭、ARIA、prefers-reduced-motion 降级。
• 修正超宽窗口下的层叠上下文：设置对话框始终位于聊天输入框之上，海洋始终 位于三栏界面之后。

site/ 是最初版展示站点，按要求逐字节保留。优化版的唯一源码在 shared/， 执行 npm run build 后生成三份安装资源。

开发与验证

Node.js 20+：

npm run build
npm run check
npm run package:extension

真实浏览器验收需要 Chrome for Testing 与 Playwright：

npm ci
npx playwright install chromium
npm run test:browser

测试使用持久化浏览器目录、--load-extension，并设置 ignoreDefaultArgs: ['--disable-extensions']。这是 Chrome 137+ 环境加载未打包 扩展所需方式。npm run capture 会从正在运行的原生 Harness 重新录制四张全宽 README 动图，并通过 FFmpeg 生成统一调色板的优化 GIF。

隐私与权限

本项目不收集、不上传、不出售、不共享任何数据。扩展仅申请 storage，以及 http://127.0.0.1/*、http://localhost/* 两个本机地址权限，用于给本地 Harness 换肤；没有远程网站权限。详见 docs/privacy.md。

许可

项目源码使用 MIT License。three.js 0.178.0 仍为 MIT；自托管 Geist 字体仍为 SIL OFL 1.1。完整说明见 THIRD_PARTY_NOTICES.md。