Open Sea Skin:给 DeepSeek Harness 换上 WebGPU 实时海洋皮肤

前言

用 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 主题,并提供四种接入方式:

  1. DSH 插件(官方 README 推荐,一行命令安装)
  2. 仅作用于 Harness 的 Chrome / Edge 扩展
  3. 无需编译源码的 静态 dist 安装脚本
  4. 写入 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 档位,标签页隐藏时暂停渲染。
  • 扩展仅申请 storage127.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 后,日常调节可以全部在界面完成:

  1. 打开本机 Harness(通常为 http://127.0.0.1http://localhost 对应端口)。
  2. 点击左下角 皮肤设置,调整 波浪大小(README 示例基准值为 56)、日光(如「下午 55」)、玻璃不透明度(动图统一以 40% 展示)。
  3. 需要氛围变化时开启 自动昼夜循环;若手动拖动日光滑块,循环会暂停,直到再次启用自动模式。
  4. 想恢复默认外观时执行 dsh plugin --profile web remove open-sea-skin;浏览器里残留的 ossEnabledossSea 等 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、无遥测的设计也比较干净。

如果你已经在用 DSH 装了一堆实用插件,不妨再加这一个「趣味换装」——写代码累了抬头看一眼海,也许比换主题色更解压。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜