dsh-whale-aqua-theme
鲸蓝戏水：DeepSeek Harness 的 macOS 风格皮肤 + 水中鲸鱼动态背景 + 点阵鲸鱼发送按钮（可安装 DSH 插件包，适配 DSH 0.2.x / Desktop 版）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dataizu/dsh-whale-aqua-theme#bc9144781e891a985fc73f22842619fa4ade9977
Whale Aqua Theme 以 dsh-whale-aqua-theme 发布，当前版本为 2.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 用的 macOS 风格主题 + 水中鲸鱼动态背景 + 点阵鲸鱼发送按钮，以 DSH 插件形式安装，支持 Desktop 桌面版与 Web 版。
当前版本 v2.3.0：已适配 DeepSeek Harness 0.2.x（Desktop 0.2.1-rc.2 / rc.3 实测）。v2.3 新增运行时选择器自愈——主题内置 120 条「稳定 local 名」绑定，加载时自动把 CSS 中写死的类名哈希改写为当前运行时的实际哈希（
:is(.旧哈希, .当前哈希)），DSH 升级换哈希后主题可自愈，不再需要人工移植；背景鲸鱼改为「磨砂玻璃」材质（缓存微粒替代逐帧点阵，性能更低），并针对 Windows 关闭透明效果的机器提供不透明水景回退；输入框光环动画重做（支持 reduced-motion / forced-colors）。兼容性细节与改造记录见 COMPATIBILITY.md。
主题在真实 DSH 中的效果（截图来自本地 DSH Desktop / Web 运行实例）。
未发送（空闲，静态鲸鱼）：
发送之后（运行中：摆尾游动 + 喷水泡 + 蓝色呼吸光环 + 水母发光）：
demo/preview.html是纯静态演示页（使用主题 CSS 与背景脚本，内容为虚构示例），可作为离线预览；它保留的是 0.1.x 时代的界面结构，仅用于看视觉效果。
dist 文件，插件停止即移除 <style>、canvas、监听与动画循环| DSH 版本 | 主题版本 | 说明 |
|---|---|---|
| 0.2.x（含 Desktop 桌面版） | v2.3.0 | 当前版本，实测 0.2.1-rc.2 / rc.3 |
| 0.1.x（Harmony 早期 Web 版） | v1.0.0 | 旧版，已归档标签 |
0.2.x 相对 0.1.x 重写了整个前端（组件、类名、Desktop 外壳），因此 v2 不是“改几个选择器”，而是重做了皮肤层：
client.js 的模块注册 id 必须等于包名（dsh-whale-aqua-theme），否则 0.2.x 会拒绝加载并显示 “Failed to load plugins”；[data-conversation-tabs]、[role=treeitem][aria-selected]、[data-variant=think]、[data-kind] 等），把不可避免的哈希类名集中在一个“版本适配层”里；--dsw-*、body[data-ds-dark-theme]、[data-composer-card]、button[class*="_primary"]、:has(rect) 运行态判断 → 背景动画与鲸鱼发送按钮无需重写。未来 DSH 升级后若皮肤部分失效，通常只需更新 COMPATIBILITY.md 第 4 节描述的哈希映射；语义选择器部分一般不受影响。
本仓库是一个标准 DSH 插件包（package.json 声明 dsh.bundle manifest 与 dsh.client 浏览器面）。
方式一：插件市场
在 dshmarket 插件市场的「🎭 主题与外观」Tab 中一键安装 / 切换 / 卸载（已提交 awesome-dsh-plugin 收录）。
方式二：命令行
# Desktop 桌面版（profile 名为 desktop）
dsh plugin --profile desktop add https://github.com/dataizu/dsh-whale-aqua-theme
# Web 版（dsh web，profile 名为 web）
dsh plugin --profile web add https://github.com/dataizu/dsh-whale-aqua-theme
安装完成后重启 DSH 生效。停用：删除 profile 的 cordis.patch.yml 中 id: dsh-whale-aqua 的 insert 行（或在市场中移除）。
⚠️ 不要同时启用多个皮肤类插件（例如 open-sea-skin）：两套皮肤会互相覆盖。
# 编辑 src/*.css、src/background.js 等源文件后重新生成 client.js
node scripts/build-client.mjs
| 源文件 | 作用 |
|---|---|
src/whale-icon.css | 发送按钮鲸鱼图标与喷水动画 |
src/tokens.css | Apple 设计令牌层（明/暗两套，含 0.2.x 必需令牌） |
src/shell.css | 水景透明外壳层 + Desktop 窗口适配（Windows 标题栏拖拽带等） |
src/regions.css | 分区皮肤（侧边栏/会话/输入框/设置/轨迹/弹层），顶部为“0.2.1 版本适配层” |
src/background.js | 水中鲸鱼背景 + 发送按钮点阵鲸鱼（生命周期可回收） |
src/apply.js | 浏览器面插件入口：注入样式、启动背景 |
client.js 由上述文件生成，请勿直接编辑。
| 文件 | 作用 |
|---|---|
package.json / cordis.patch.yml | 插件包声明（dsh.bundle manifest 与插入行） |
index.js / client.js | 插件宿主面 / 浏览器面（生成的 bundle） |
src/ + scripts/build-client.mjs | 皮肤源码与构建脚本 |
scripts/theme-regression.mjs | 无依赖的 Node 回归测试（发送按钮生命周期/降动效/清理/回退） |
apple-style.css / whale-icon.css | 旧版 dist 补丁方式使用的合并样式（0.1.x 兼容，v2 由构建脚本生成） |
COMPATIBILITY.md | 0.2.x / Desktop 兼容性报告与改造、维护指南 |
docs/0.2.1-selector-map.json | 0.1.x → 0.2.1 完整选择器映射（升级维护用） |
install/background-snippet.html | 0.1.x 时代的背景脚本补丁（旧 dist 方式） |
whale-path.txt | DeepSeek 官方鲸鱼 SVG path 的压缩版（点阵采样数据源） |
reference/hero-whale.svg | 官方 hero 鲸鱼 SVG 参考 |
| 想调什么 | 在哪里 |
|---|---|
| 发送按钮喷水位置/大小 | src/whale-icon.css 中 ::before / ::after（两粒水泡）的 left/top/width/height |
| 输入框发光强弱/流速 | src/regions.css 中 dsh-jelly-breathe / dsh-jelly-flow 关键帧 |
| 对话区毛玻璃透明度/模糊 | src/regions.css 中 [data-conversation-scroll] 的磨砂规则 |
| 侧边栏 / 底板玻璃色 | src/shell.css 中 --dsh-aqua-sidebar / --dsh-aqua-pane |
| 背景气泡数量/大小/速度 | src/background.js 中 BUB_CAP、newBubble |
| 鲸鱼游速/摆幅/受惊 | 同文件 updateWhale 与 whaleWave 相关参数 |
| 性能档位（DPR/帧率） | 同文件 DPR = Math.min(..., 1.25) 与 ts - lastT < 41 |
LICENSE）。English / 简体中文双语说明，欢迎 PR 与 Issue。