前言¶
用 DeepSeek Harness(DSH)跑智能体时,Web 界面往往就是长时间盯着的「工作台」:功能够用,但视觉千篇一律。社区里有人做任务看板、有人做成本统计,也有人专门在「好看」这件事上发力——把聊天窗口背后换成实时渲染的海面,对话时波浪起伏、日光流转,Harness 立刻有了辨识度。
今天要介绍的是维护者 d-dev0101 开源的 Open Sea Skin(仓库名 open-sea-skin)。它在 SkillHub 插件库 中归类为「趣味换装」,GitHub 上截至核实已有约 188 颗星。插件用 WebGPU 在 Harness 背后绘制五组 Gerstner 波浪海面,并保留半透明玻璃 UI,不挡操作,只换氛围。
需要说明的是:DSH 的核心理念是「一切皆插件」,SkillHub 等社区目录由爱好者维护,与 DeepSeek / 幻方并无官方从属关系;安装任何插件前,建议自行阅读源码与许可证。
这是什么¶
Open Sea Skin 是一套面向 DeepSeek Harness 的自包含 WebGPU 海洋皮肤方案。它保留原版五波 Gerstner/TSL 海面视觉,叠加半透明 Harness 主题,并提供四种接入方式:
- DSH 插件(官方 README 推荐,一行命令安装)
- 仅作用于 Harness 的 Chrome / Edge 扩展
- 无需编译源码的 静态 dist 安装脚本
- 写入 Harness 源码树的 原生集成(设置项出现在「通用设置」里)
一句话定位:让本地运行的 dsh web 界面背后出现可交互、可调的实时海洋,而不是静态壁纸。
核心功能与亮点¶
根据 GitHub 仓库 与中文 README 的说明,已核实的主要能力如下。
渲染与视觉
- 基于 WebGPU + three.js 0.178.0 + TSL,五组 Gerstner 波、解析法线、FBM 细节、Fresnel 天空反射、太阳闪烁、浪尖泡沫、地平线雾、天空云带,以及 bloom 与 ACES 色调映射。
- 默认 40% 玻璃不透明度,Harness 三栏布局保持可用;超宽窗口下设置对话框会叠在输入框之上,海洋始终位于界面之后。
交互与控制
- 左下角 「皮肤设置」 快捷入口,可调波浪大小、日光、玻璃不透明度,以及 12 分钟自动昼夜循环(手动拖动日光会固定当前时间,可再开启自动循环)。
- 中英双语 UI,支持键盘焦点循环、Esc 关闭、
prefers-reduced-motion降级。
性能与隐私
- 资源全部本地化:three.js 与 Geist 字体已 vendored,扩展与安装器 不请求 CDN、不含分析遥测。
- 256×256 网格(低端/减少动态模式 160×160),DPR 上限 1.5,自适应分辨率 0.5–1.0,60/30/20 FPS 档位,标签页隐藏时暂停渲染。
- 扩展仅申请
storage与127.0.0.1/localhost权限;项目声明 不收集、不上传任何数据。源码采用 MIT 许可证。
多种安装路径
- 普通 DSH 用户优先用插件命令;不想动
dsh plugin可用浏览器扩展或curl | bash静态安装;需要设置页原生入口的开发者再走源码集成。各路径有重复渲染防护,但 README 建议 只选一种,便于更新与卸载。
安装与启用¶
推荐:DSH 插件方式¶
在已安装 DeepSeek Harness CLI 的环境中执行(安装命令以仓库 README 为准):
dsh plugin --profile web add 'github:d-dev0101/open-sea-skin#v1.2.1'
然后重启 Web 服务:
dsh web
该包在 DeepSeek Harness 0.1.0-rc.6 上实测通过。安装完成后,浏览器打开 Harness 页面,背景应出现海洋皮肤;左下角可见 Skin settings / 皮肤设置 按钮。
卸载命令:
dsh plugin --profile web remove open-sea-skin
若需固定某一版本,可在 add 时带上 release tag(如上文的 #v1.2.1);更新时重新执行带新 tag 的 add 即可。
验证是否加载成功¶
DSH 插件安装指南 建议确认 profile 中出现 open-sea-skin 行,且以下同源 URL 返回 HTTP 200:
/plugins/open-sea-skin/client.js
/open-sea-skin/skin.html
/open-sea-skin/styles.css
/open-sea-skin/ocean.js
若按钮未出现,先确认 dsh plugin add 使用的 --profile web 与当前 dsh web 一致,重启 Web 进程后再刷新页面。
其他安装方式(按需选用)¶
Chrome / Edge 扩展:下载 Release 中的 open-sea-skin-extension-*.zip 或克隆仓库,在 chrome://extensions 开启开发者模式后加载 extension/ 目录,再访问本机 Harness 并刷新。扩展会校验页面标题与 Harness 启动标记,避免误改其他本地站点。
静态 dist 注入(无需编译 Harness 源码):
curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash
执行前需停止 Harness;完成后重新 dsh web 并保持终端进程运行,再刷新浏览器。Harness 升级后应加 --update 重跑;卸载用 --uninstall。
原生源码集成(控制项进入「设置 → 通用设置」):
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 特定提交做过锚点校验(README 记载为 47f943859bef),上游结构变化时安装脚本会主动停止,避免盲目改文件。
典型用法示例¶
完成 DSH 插件安装并重启 dsh web 后,日常调节可以全部在界面完成:
- 打开本机 Harness(通常为
http://127.0.0.1或http://localhost对应端口)。 - 点击左下角 皮肤设置,调整 波浪大小(README 示例基准值为 56)、日光(如「下午 55」)、玻璃不透明度(动图统一以 40% 展示)。
- 需要氛围变化时开启 自动昼夜循环;若手动拖动日光滑块,循环会暂停,直到再次启用自动模式。
- 想恢复默认外观时执行
dsh plugin --profile web remove open-sea-skin;浏览器里残留的ossEnabled、ossSea等 localStorage 键可选手动清理。
仓库 README 提供了深色/浅色 Harness 全景、调波浪、从正午到黄昏等 GIF 演示,也可访问 交互式展示站 预览效果。
适用场景与注意事项¶
适合谁用
- 长期在本地跑
dsh web、希望工作台有点「活」的视觉反馈的开发者。 - 做 Harness 主题/插件生态探索、需要参考 WebGPU 皮肤接入方式的贡献者。
- 接受适度 GPU 占用、且浏览器支持 WebGPU 的环境(README 面向 Chrome/Edge 场景设计)。
注意事项
- 插件与 DSH 进程权限一致,安装前应阅读 GitHub 源码 与 MIT 许可证,确认可接受其文件注入与本地存储行为。
- 不要混用多种安装路径(插件 + 扩展 + 静态注入同时存在),虽有重复渲染防护,但更新和排障会复杂得多。
- 静态安装或卸载后若页面提示 Failed to load plugins,先确认
dsh web是否仍在运行——安装器只改前端文件,不会替你维持服务进程。 - 若需要控制项嵌入 Harness 原生「通用设置」页,应选源码集成;仅换背景、快速尝鲜则 DSH 插件方式最简单。
- WebGPU 实时渲染对显卡与驱动有一定要求;低端设备会自动降档,也可依赖
prefers-reduced-motion走简化模式。
结尾¶
Open Sea Skin 把 DeepSeek Harness 从「纯工具界面」拉向「可定制的沉浸式工作台」:一行 dsh plugin 命令就能在聊天窗口背后铺开实时海面,左下角随时调波浪与日光。对注重本地隐私的用户来说,全程无 CDN、无遥测的设计也比较干净。
- 插件目录页:https://www.skillhub.cn/plugins/d-dev0101/open-sea-skin
- GitHub 仓库:https://github.com/d-dev0101/open-sea-skin
- DSH 安装与排障:docs/dsh-plugin.md
如果你已经在用 DSH 装了一堆实用插件,不妨再加这一个「趣味换装」——写代码累了抬头看一眼海,也许比换主题色更解压。