前言¶
DeepSeek Harness (DSH) 采用插件化架构，Web GUI 的外观主要由挂载在 html[data-ww="on"] 下的样式层决定。dsh-whale-atelier 是由 Cicero010 维护的一个皮肤包插件，它不修改 DSH 内部文件，也不写入产品元素的属性，而是通过挂载样式层来改变界面呈现。
该插件旨在为 DSH 提供一套完整的视觉重写方案，将鲸鱼娘立绘作为壁纸铺满界面，叠加金属描边、蕾丝蝴蝶结与环境粒子，并支持通过第三方皮肤包扩展。
核心功能¶
内置皮肤与第三方扩展¶
插件提供五套开箱即用的皮肤方案：
* 女仆工坊
* 夜庭银饰
* 深海
* 雪夜庭
* 桂月夜庭
每套皮肤包含壁纸场景、金属描边、蕾丝蝴蝶结、角落立绘与环境粒子。此外，插件支持第三方皮肤包格式（skin.json），可通过目录 + 配置文件自行扩展。
视觉与交互细节¶
- 覆盖范围：支持全界面（侧栏、标题栏、工作区）或仅工作区覆盖。
- 明暗策略：支持跟随 GUI 主题、按时段自动切换（07:00–18:30 为白天版）、固定深色或固定浅色。
- 画面三维度：可调节遮罩浓度、暗角强度与景深模糊。
- 环境粒子：提供花瓣、萤火、气泡、雪花、桂花、樱花六种粒子效果，且遵循
prefers-reduced-motion。 - 立绘联动：角落立绘会根据 Agent 状态（等待审批、生成中、出错、刚完成）切换形象与呼吸节奏。
- 设置管理：支持设置导出与导入，可跨设备复用配置。
- 隐私与性能：全部资源由插件自身路由提供，零外部请求、零遥测。
安装与启用¶
1) 作为插件装进某个 profile¶
在目标 profile 目录下执行 pnpm 安装命令，并将插件名追加至 package.json 的 dsh.profile.bundles 字段末尾：
cd ~/.dsh/profiles/<profile>
"<runtime>/dependencies/node/bin/node.exe" \
"<runtime>/dependencies/pnpm/bin/pnpm.mjs" add "github:Cicero010/dsh-whale-atelier"
# 手动编辑 package.json，在 dsh.profile.bundles 中追加 "dsh-whale-atelier"
也可以在 DSH 的 GUI 插件页面直接安装该组合包。
2) 本地目录链接¶
git clone https://github.com/Cicero010/dsh-whale-atelier ~/.dsh/plugins/dsh-whale-atelier
cd ~/.dsh/profiles/<profile>
"<runtime>/dependencies/node/bin/node.exe" \
"<runtime>/dependencies/pnpm/bin/pnpm.mjs" add "link:C:/Users/<you>/.dsh/plugins/dsh-whale-atelier"
# 同样在 dsh.profile.bundles 中追加插件名
典型用法¶
装载皮肤包¶
插件仓库自带示例皮肤包。安装方式有两种：
1. 使用工具脚本（无需重启）：
python tools/install_skin_pack.py skins/sakura
- 复制到宿主发现路径（需重启宿主）：
将skins/sakura/复制到$DSH_HOME/whale-wallpaper-skins/。
切换皮肤¶
在 DSH 的 Web GUI 中切换皮肤即可实时生效。
适用场景与注意事项¶
适用场景：希望为 DSH Web GUI 换肤、需要 Agent 状态视觉反馈的开发者。
运行时依赖：目标运行时为 DSH 0.2.0-rc.2。插件依赖内置客户端的 CSS-module 类名后缀（如 _frame、_centerCol、_composerSeat、_header、_running、_turnErrorRow、_reject）以及 --dsw-alias-bg-base、--dsw-specific-sidebar-fill 令牌。若 DSH 更改这些契约，界面会静默失效并回到出厂外观。
几何与发现：装饰层只读取外壳几何，不做像素级锁定，布局变化通过 resize + 1.5s 同步兜底。皮肤包的宿主发现路径（投放目录或插件声明）在安装后通常需要重启一次宿主才能生效。
素材来源：立绘与壁纸衍生自 dsh-whale-musume（MIT 许可），仅本地使用。
结尾¶
dsh-whale-atelier 提供了一套完全本地化、无遥测的视觉定制方案。若需查看源码或获取更多文档，可访问 GitHub 仓库。
