open-sea-skin

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

<div align="center">

<img src="extension/icons/icon128.png" width="80" height="80" alt="Open Sea 海浪标志" />

<h1>Open Sea · DeepSeek Harness 海洋皮肤</h1>

<p><strong>让你的工作空间，拥有自己的海平线。</strong><br>动态海洋主题 · 夕阳光影 · 透明玻璃界面</p>

<p><strong>简体中文</strong> · <a href="README.en.md">English</a></p>

<p>

<a href="https://github.com/d-dev0101/open-sea-skin/releases"><img src="https://img.shields.io/github/v/release/d-dev0101/open-sea-skin?color=138b8b&amp;label=GitHub%20release" alt="GitHub 最新版本" /></a>

<a href="https://www.npmjs.com/package/open-sea-skin"><img src="https://img.shields.io/npm/v/open-sea-skin?color=138b8b&amp;label=npm" alt="npm 已发布版本" /></a>

<a href="https://github.com/d-dev0101/open-sea-skin/actions/workflows/ci.yml"><img src="https://github.com/d-dev0101/open-sea-skin/actions/workflows/ci.yml/badge.svg" alt="构建与回归测试" /></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-138b8b" alt="MIT 开源许可" /></a>

</p>

<h2>👀 安装前，请务必先去官网看效果</h2>

<p>调一调海浪，找一束夕阳，选一层玻璃。<br><strong>亲手体验之后，再选择适合你的安装方式。</strong></p>

<p><a href="https://d-dev0101.github.io/open-sea-skin/"><strong>🌊 官网交互体验</strong></a> · <a href="#install">📦 安装指南</a> · <a href="https://github.com/d-dev0101/open-sea-skin/releases">🚀 下载版本</a> · <a href="https://github.com/d-dev0101/open-sea-skin/issues">💬 问题反馈</a></p>

</div>

🌊 先看海动起来

🎬 原有 Harness 实录 · 40% 玻璃不透明度 · [浅色、海浪与夕阳动图](#gallery) · 亲手调节官网效果

🛠️ 当前维护状态

GitHub 修复版：v1.2.7 · npm 可安装版：v1.2.6。 v1.2.7 已修复浅色面板、侧栏叠色和新版聊天卡片透明度；npm 发布等待维护者登录，下面的复制包名暂时保留可用的 1.2.6。需要修复版可按[本地包安装步骤](docs/install.zh.md#下载本地包备用)安装，勿把 GitHub 下载链接直接填进安装器。

🔎 已核对官方 Harness 0.2.1-rc.5。验证覆盖官方 Mac 包内运行时与真实 Web 页面、安装/卸载和浅深色；Windows 原生客户端尚未实测。[查看兼容性记录与已知问题 →](docs/compatibility.md)

🚀 官方客户端，三步开始

🖥️ 用官方客户端？直接安装 Harness 插件即可。 Windows / Mac 操作相同，不用终端，也不用先装浏览器扩展。

1. 🧩 点击侧栏 「插件 → 添加插件」。

2. 📋 复制下方包名，粘贴后点击 「安装」。

3. ✅ 安装完成后 「立即启用」；出现重启提示时按提示操作。

open-sea-skin@1.2.6

🇨🇳 大陆用户可选中国大陆镜像源；找不到版本时切换官方 npm 源。

🌐 用的是 Harness Web？[跳到 Web 插件安装](#dsh-plugin)。遇到问题？[查看中文排错指南](docs/install.zh.md)。

💡 只选一种安装方式。 Harness 插件和浏览器扩展是两条不同路径，不要在同一个 Harness 中重复安装。

<details>

<summary>🛍️ 已经装了社区插件市场？</summary>

搜索 Open Sea / open-sea-skin，核对项目为 d-dev0101/open-sea-skin，再检查版本并安装。

市场尚未同步时，改用官方客户端的「添加插件」。不需要为了安装 Open Sea 先安装第三方市场。

</details>

Open Sea 是为 DeepSeek Harness（DSH）制作的开源海洋皮肤与界面美化插件。

🌊 让真实流动的海浪成为背景。<br>

🌅 从白天调到夕阳，选择你喜欢的光线。<br>

🫧 自由调节玻璃不透明度，让海洋与工作界面自然融合。

本项目为社区作品，不是 DeepSeek 官方产品。适用对象是 DeepSeek Harness，不是 DeepSeek 网页聊天站点；也与 OpenSea NFT 交易平台无关。

<p align="center"><a href="#features">特色功能</a> · <a href="#gallery">实拍动图</a> · <a href="#install">选择安装方式</a> · <a href="#faq">常见问题</a> · <a href="#development">开发文档</a></p>

<a id="features"></a>

✨ 不只是换一张壁纸

特色 · 你能体验到什么

🌊 实时海洋 · 实时渲染海浪与反射，不是循环播放的壁纸视频。

🌅 阳光与夕阳 · 自己选择光照，或开启 12 分钟自动昼夜循环。

🫧 透明玻璃界面 · 玻璃不透明度可在 40%–90% 间调整，适配 Harness 深色与浅色布局。

🎛️ 快捷调节 · 左下角打开皮肤设置，即时调整波浪、日光和透明度。

🏠 保留你的主页 · 不接管浏览器新标签页，不改掉原来安装的主页插件。

🔒 本地资源 · 海洋脚本、three.js 与字体随包提供，无皮肤遥测或运行时 CDN 请求。

⌨️ 顺手的交互 · 中英文界面、键盘操作、Esc 关闭，以及减少动态效果支持。

<a id="gallery"></a>

🎬 DeepSeek Harness 真实效果

以下动图来自原生 Harness 集成，统一为 40% 玻璃不透明度。全景基准：波浪大小 56、日光 下午（55）。想自己调？先打开官网实时预览。

🌙 深色模式 · 在海面上专注对话

☀️ 浅色模式 · 给工作空间一点阳光

🌊 调整海浪 · 从平静到涌浪

日光固定为下午，波浪大小变化后回到基准值 56。

🌅 调整光照 · 从正午走向夕阳

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

<a id="install"></a>

📦 安装指南 · 只选一种方式

编号 · 你在用什么？ · 从这里开始

1 🖥️ 推荐 · 官方客户端 · Windows / Mac · [客户端内安装，无需终端](#official-desktop)

2 🌐 插件 · 浏览器里运行的 Harness Web · [在运行 Harness 的电脑上安装](#dsh-plugin)

3 🧩 扩展 · 本机 Harness Web，想用浏览器扩展换肤 · [安装 Chrome / Edge 扩展](#browser-extension)

4 🔧 进阶 · 不支持插件的已构建前端 · [静态前端安装](#static-installer)

5 🛠️ 开发者 · 自己编译 Harness 源码 · [原生源码接入](#source-integration)

<a id="official-desktop"></a>

1. 🖥️ 官方客户端（Windows / Mac）——优先推荐

Windows 和 Mac 使用相同的界面步骤，不需要安装 Node.js，也不需要打开终端。

1. 打开 DeepSeek Harness，点击左侧 「插件」，再点 「添加插件」。

2. 复制下面这一行，粘贴到插件名称输入框：

   open-sea-skin@1.2.6

3. 中国大陆用户可选择 「中国大陆镜像源」；下载失败时可切换 「官方 npm 源」。

4. 点击 「安装」，检查安装信息，完成后点击 「立即启用」；如果客户端提示重启，按提示操作。

5. 点击左下角 「皮肤设置」，建议先试 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 修复包请按[本地安装步骤](docs/install.zh.md#下载本地包备用)使用。选择镜像不会加速另行粘贴的 GitHub URL。

🛟 遇到 404 / 找不到版本，先换官方源；自定义源出现 401 / 403，请按该源要求登录。[更详细的源选择与排错 →](docs/install.zh.md#三种安装源如何填写)

🔄 更新、暂停与卸载

• 更新旧版： 在「插件」页卸载旧版 Open Sea，再按上述步骤安装。已核对的官方安装器暂不支持第三方插件原地升级。
• 暂时关闭： 在皮肤面板关闭海洋，或在「插件」页停用 Open Sea。
• 完整卸载： 在「插件」页找到 Open Sea，选择卸载。无需运行 Web 卸载命令。

🛟 不要删除整个 Harness 配置目录、会话目录或锁文件。安装报错时先看[中文恢复与排错指南](docs/install.zh.md)。

📖 [Windows / Mac 中文详细指南与常见报错](docs/install.zh.md) · 下载官方客户端

<a id="dsh-plugin"></a>

2. 🌐 Harness Web ——一条命令安装

在启动 dsh web 的那台电脑上运行。Windows PowerShell 与 macOS 终端使用同一条命令：

dsh plugin --profile web add ope

…(truncated)