🌊 先看海动起来
Open Sea 在 DeepSeek Harness 中的深色海洋动态实录，玻璃不透明度 40%
🎬 原有 Harness 实录 · 40% 玻璃不透明度 · 浅色、海浪与夕阳动图 · 亲手调节官网效果
🛠️ 当前维护状态
GitHub 修复版：v1.2.7 · npm 可安装版：v1.2.6。 v1.2.7 已修复浅色面板、侧栏叠色和新版聊天卡片透明度；npm 发布等待维护者登录，下面的复制包名暂时保留可用的 1.2.6。需要修复版可按本地包安装步骤安装，勿把 GitHub 下载链接直接填进安装器。
🔎 已核对官方 Harness 0.2.1-rc.5。验证覆盖官方 Mac 包内运行时与真实 Web 页面、安装/卸载和浅深色；Windows 原生客户端尚未实测。查看兼容性记录与已知问题 →
🚀 官方客户端，三步开始
🖥️ 用官方客户端？直接安装 Harness 插件即可。 Windows / Mac 操作相同，不用终端，也不用先装浏览器扩展。
- 🧩 点击侧栏 「插件 → 添加插件」。
- 📋 复制下方包名，粘贴后点击 「安装」。
- ✅ 安装完成后 「立即启用」；出现重启提示时按提示操作。
open-sea-skin@1.2.6
🇨🇳 大陆用户可选中国大陆镜像源；找不到版本时切换官方 npm 源。
🌐 用的是 Harness Web？跳到 Web 插件安装。遇到问题？查看中文排错指南。
💡 只选一种安装方式。 Harness 插件和浏览器扩展是两条不同路径，不要在同一个 Harness 中重复安装。
🛍️ 已经装了社区插件市场？
搜索 Open Sea / open-sea-skin，核对项目为 d-dev0101/open-sea-skin，再检查版本并安装。
市场尚未同步时，改用官方客户端的「添加插件」。不需要为了安装 Open Sea 先安装第三方市场。
Open Sea 是为 DeepSeek Harness（DSH）制作的开源海洋皮肤与界面美化插件。
🌊 让真实流动的海浪成为背景。
🌅 从白天调到夕阳，选择你喜欢的光线。
🫧 自由调节玻璃不透明度，让海洋与工作界面自然融合。
本项目为社区作品，不是 DeepSeek 官方产品。适用对象是 DeepSeek Harness，不是 DeepSeek 网页聊天站点；也与 OpenSea NFT 交易平台无关。
特色功能 · 实拍动图 · 选择安装方式 · 常见问题 · 开发文档
✨ 不只是换一张壁纸
| 特色 | 你能体验到什么 |
|---|
| 🌊 实时海洋 | 实时渲染海浪与反射，不是循环播放的壁纸视频。 |
| 🌅 阳光与夕阳 | 自己选择光照，或开启 12 分钟自动昼夜循环。 |
| 🫧 透明玻璃界面 | 玻璃不透明度可在 40%–90% 间调整，适配 Harness 深色与浅色布局。 |
| 🎛️ 快捷调节 | 左下角打开皮肤设置，即时调整波浪、日光和透明度。 |
| 🏠 保留你的主页 | 不接管浏览器新标签页，不改掉原来安装的主页插件。 |
| 🔒 本地资源 | 海洋脚本、three.js 与字体随包提供，无皮肤遥测或运行时 CDN 请求。 |
| ⌨️ 顺手的交互 | 中英文界面、键盘操作、Esc 关闭，以及减少动态效果支持。 |
🎬 DeepSeek Harness 真实效果
以下动图来自原生 Harness 集成，统一为 40% 玻璃不透明度。全景基准：波浪大小 56、日光 下午（55）。想自己调？先打开官网实时预览。
🌙 深色模式 · 在海面上专注对话
DeepSeek Harness 深色海洋主题，玻璃不透明度 40%
☀️ 浅色模式 · 给工作空间一点阳光
DeepSeek Harness 浅色海洋主题，玻璃不透明度 40%
🌊 调整海浪 · 从平静到涌浪
日光固定为下午，波浪大小变化后回到基准值 56。
在 DeepSeek Harness 皮肤设置中调整海浪大小
🌅 调整光照 · 从正午走向夕阳
波浪固定为 56，日光从正午平滑变化到黄昏。
将 DeepSeek Harness 动态海洋背景从白天调整到夕阳
📦 安装指南 · 只选一种方式
1. 🖥️ 官方客户端（Windows / Mac）——优先推荐
Windows 和 Mac 使用相同的界面步骤，不需要安装 Node.js，也不需要打开终端。
-
打开 DeepSeek Harness，点击左侧 「插件」，再点 「添加插件」。
-
复制下面这一行，粘贴到插件名称输入框：
open-sea-skin@1.2.6
-
中国大陆用户可选择 「中国大陆镜像源」；下载失败时可切换 「官方 npm 源」。
-
点击 「安装」，检查安装信息，完成后点击 「立即启用」；如果客户端提示重启，按提示操作。
-
点击左下角 「皮肤设置」，建议先试 40% 玻璃不透明度。
💡 入口是侧栏的「插件」，不是「设置 → 内置插件」。安装时填写包名，不要填写 GitHub 仓库或远程压缩包链接。
🌐 三种安装源，怎么选？
插件名称一栏填 open-sea-skin@1.2.6；源地址在「安装源」里选择或填写，两者不要填反。 Windows 和 Mac 步骤相同。
| 安装源选项 | 完整地址 / 填写内容 | 适用情况 |
|---|
| 🌍 npm 官方源 | https://registry.npmjs.org | 首选官方发布源，新版本从这里发布。 |
| 🇨🇳 中国大陆镜像源 | https://registry.npmmirror.com | 大陆网络可尝试；镜像同步可能晚于官方源。 |
| 🏢 自定义地址 | 填你使用的 npm registry 完整地址；也可填 https://registry.npmjs.org 使用官方源 | 适合企业/内网代理。它不是额外的固定公共镜像，需要能访问或代理 open-sea-skin。 |
📦 公开源目前可安装 1.2.6；1.2.7 的 npm 发布尚未完成。 GitHub 修复包请按本地安装步骤使用。选择镜像不会加速另行粘贴的 GitHub URL。
🛟 遇到 404 / 找不到版本，先换官方源；自定义源出现 401 / 403，请按该源要求登录。更详细的源选择与排错 →
🔄 更新、暂停与卸载
- 更新旧版： 在「插件」页卸载旧版 Open Sea，再按上述步骤安装。已核对的官方安装器暂不支持第三方插件原地升级。
- 暂时关闭： 在皮肤面板关闭海洋，或在「插件」页停用 Open Sea。
- 完整卸载： 在「插件」页找到 Open Sea，选择卸载。无需运行 Web 卸载命令。
🛟 不要删除整个 Harness 配置目录、会话目录或锁文件。安装报错时先看中文恢复与排错指南。
📖 Windows / Mac 中文详细指南与常见报错 · 下载官方客户端
2. 🌐 Harness Web ——一条命令安装
在启动 dsh web 的那台电脑上运行。Windows PowerShell 与 macOS 终端使用同一条命令：
dsh plugin --profile web add open-sea-skin@1.2.6
安装完成后，重启正在运行的 dsh web，刷新浏览器页面。
这个入口只安装到 Web 配置，不会给官方客户端安装插件。
📖 Web 安装与排错
3. 🧩 Chrome / Edge 浏览器扩展
适用于在浏览器中打开的本机 Harness，Windows / Mac 均可使用。
- 下载扩展 ZIP，先解压。
- 打开
chrome://extensions 或 edge://extensions，开启 「开发者模式」。
- 点击 「加载已解压的扩展程序」，选择包含
manifest.json 的目录。
- 回到
127.0.0.1 或 localhost 上的 Harness 页面，刷新一次。
🏠 保留你原来的主页和新标签页插件。浏览器扩展不会安装到官方桌面客户端里。
4. 🔧 静态前端安装（进阶备用）
仅当你的已构建 Harness 前端不支持插件时，展开操作
此方式会修改前端文件。先停止 Harness，查看脚本，再在 macOS / Linux 的 Bash 中执行：
curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash
随后重新启动 dsh web。Harness 前端升级后，使用 bash -s -- --update 重新应用皮肤。
不是 Windows PowerShell 命令，也不适用于修改官方桌面客户端安装目录。
📖 指定路径、备份与恢复
5. 🛠️ Harness 源码接入（开发者）
仅当你自己开发、编译 Harness 时，展开说明
可将海洋控制接入 Harness 的设置与插槽，需要自行构建前后端。
验证基线是 0.1.2-alpha.3，不是适用于所有新版的一键安装方案。
📖 原生源码接入指南
💡 安装前，你可能想知道
会替换浏览器新标签页，或者修改 DeepSeek 网页版吗？
不会。扩展只作用于经过验证的本地 DeepSeek Harness 页面，不接管浏览器主页，也不会为 chat.deepseek.com 换肤。
如何关闭或卸载？
官方客户端： 在左侧「插件」中停用或卸载 Open Sea。
Harness Web： 临时关闭可用快捷面板；卸载使用：
dsh plugin --profile web remove open-sea-skin
随后重启 Harness。浏览器扩展可在扩展管理页移除。静态安装用户先停止 Harness，再运行：
curl -fsSL https://raw.githubusercontent.com/d-dev0101/open-sea-skin/main/install.sh | bash -s -- --uninstall
之后重新启动 Harness。静态卸载器删除自己的加载标记与资源，不删除你的会话。页面无法加载时，请参阅恢复指南。
是否保证兼容所有最新版 Harness / Desktop？
已核对最新发布通道的 Harness 0.2.1-rc.5，并用官方 macOS 包内运行时完成隔离安装、真实 Web 页面加载、皮肤调节和卸载重启。页面回归覆盖 macOS / Windows 的浅深色与 40% / 90% 玻璃组合。这不等于 Windows 原生客户端端到端测试，也不是所有未来版本的兼容承诺。
📋 版本、测试方法、历史验证基线与未解决问题。
如果升级后遇到问题，请提供 Harness 版本、安装方式，以及去除敏感信息的截图或日志。
会占用很多性能吗？聊天数据安全吗？
渲染器支持自适应分辨率、隐藏标签页暂停和减少动态效果。动态 3D 海洋仍会使用 GPU，建议先在官网用自己的设备体验。
皮肤不收集或上传聊天数据；扩展权限仅用于存储设置和访问本地 Harness。这描述的是 Open Sea，不代表宿主应用自身的数据处理行为。隐私与权限说明 →
🔒 权限与隐私
Open Sea 没有聊天数据上传或分析功能。安装版的海洋渲染脚本、three.js 与字体随包提供。
浏览器扩展读取页面标记以识别 Harness，并修改界面样式；视觉偏好使用 Chrome / Edge 的同步存储，开启浏览器同步时可能跨设备同步。
仓库里的旧版 site/ 演示会从 jsDelivr 加载依赖，不属于安装包或当前官网。详见中文隐私说明。
🛠️ 开发与开源生态
基于 WebGPU、three.js 与 TSL，包含五组 Gerstner 波、海面反射、泡沫与天空光照。共享源码位于 shared/，生成的插件、扩展和静态加载器保持同步；site/ 保留最初版展示。
使用 Node.js 20+：
npm ci
npm run build
npm run check
npx playwright install chromium
npm run test:browser
npm run test:desktop
npm run test:website
🤝 反馈与许可
💬 遇到问题？欢迎用中文提问。 提交 Issue 时，附上以下信息，方便定位：
- 🖥️ 系统：Windows / macOS，以及 Harness 版本。
- 📦 安装：皮肤版本、安装方式（客户端插件 / Web 插件 / 浏览器扩展等）。
- 🔎 现象：操作步骤、报错原文，以及去除敏感信息的截图。
🔐 请勿公开密码、Token 或私人对话。
💡 有改进建议也欢迎交流；想参与开发，可提交 Pull request。
项目代码使用 MIT 开源许可，第三方代码与字体遵循各自许可，详见第三方声明。
🌊 找到你的那片海，先去官网试试看
