dsh-whale-atelier
为 DeepSeek Harness 的 Web GUI 做的鲸鱼皮肤包：把鲸鱼娘立绘铺成整个界面的壁纸，再叠一层金/银描边装饰、蕾丝、蝴蝶结与角落立绘，并带环境粒子与 Agent 状态联动。
零侵入：不改任何内置包文件，不写产品元素的属性；所有效果都挂在 html[data-ww="on"] 下，关掉即回到出厂外观。
女仆工坊 · 暗色
更多截图
特性
- 五套内置皮肤：女仆工坊 / 夜庭银饰 / 深海 / 雪夜庭（季节）/ 桂月夜庭（季节）。每套 = 壁纸场景 + 描边金属 + 蕾丝蝴蝶结 + 角落立绘 + 环境粒子，整套切换、即时生效
- 第三方皮肤包：一个目录 + 一份
skin.json 就是一套皮肤，支持三条安装路径（详见 docs/SKIN-PACKS.md）。仓库自带示例包 skins/sakura（樱吹雪）
- 覆盖范围：全界面（侧栏 + 标题栏 + 工作区）/ 仅工作区
- 明暗策略：跟随 GUI 主题 / 按时段自动切昼夜（07:00–18:30 用白天版）/ 固定深色 / 固定浅色
- 画面三维度：遮罩浓度、暗角强度、景深模糊
- 环境粒子：花瓣 / 萤火 / 气泡 / 雪花 / 桂花 / 樱花，随皮肤切换，遵循
prefers-reduced-motion
- 角落立绘联动 Agent 状态：等待审批 / 生成中 / 出错 / 刚完成各换一个形象，呼吸节奏随之变化
- 设置导出 / 导入：一段自包含 JSON，可复制到别的机器一键套用
- 全部资源由插件自己的只读路由提供，零外部请求、零遥测
安装
1) 作为插件装进某个 profile
# GitHub 直装（pnpm 支持 git spec）
cd ~/.dsh/profiles/<profile>
"<runtime>/dependencies/node/bin/node.exe" \
"<runtime>/dependencies/pnpm/bin/pnpm.mjs" add "github:Cicero010/dsh-whale-atelier"
# 再把 "dsh-whale-atelier" 追加到 package.json 的 dsh.profile.bundles 末尾
也可以直接在 GUI 的插件页安装该组合包。
2) 本地目录链接
git clone https://github.com/Cicero010/dsh-whale-atelier ~/.dsh/plugins/dsh-whale-atelier
cd ~/.dsh/profiles/<profile>
"<node>" "<pnpm>" add "link:C:/Users/<you>/.dsh/plugins/dsh-whale-atelier"
# 同样把包名加进 dsh.profile.bundles
profile 里 dsh-hmr 默认启用，所以追加 bundles 后宿主半边就地挂载；浏览器半边在刷新页面时重新组合启动图。
3) 只想试一下壁纸
把 lib/ 与 assets/ 复制进任意已注册的插件目录，或参考 docs/PLUGIN.md 里的原理自己接。
装示例皮肤包（可选）
python tools/install_skin_pack.py skins/sakura # 免重启，刷新页面即生效
或者把 skins/sakura/ 复制到 $DSH_HOME/whale-wallpaper-skins/（宿主发现路径，需重启一次宿主）。
仓库自带的 skins/ 目录也是宿主启动时会扫描的内置皮肤包目录。
目录结构
lib/ 宿主半边（三条只读路由：assets / skins / pack）+ 浏览器半边
assets/ 内置皮肤素材：wallpaper.css、24 张壁纸、饰件、立绘、缩略图
skins/ 随仓库分发的皮肤包（sakura = 樱吹雪）
docs/ 皮肤包格式说明、插件原理与限制、截图
tools/ 生成与安装工具（见下）
tests/ 四个可跑的测试
工具
| 脚本 | 用途 |
|---|
tools/make_wallpapers.py --set abyss|interior|snow|moonfest|sakura|all | 用 Pillow 合成壁纸底图（all = 内置 4 套共 24 张） |
tools/make_ornaments.py | 生成金/银藤蔓角花、蕾丝、蝴蝶结、分隔饰件 |
tools/make_thumbs.py [--pack <目录>] | 生成皮肤选择器缩略图 |
tools/install_skin_pack.py <目录> | --uninstall <id> | --list | 皮肤包装进/移出插件索引（免重启） |
壁纸依赖 dsh-whale-musume 的立绘素材，生成前请先安装它（见 THIRD-PARTY-NOTICES.md）。
测试
node tests/run.mjs
| 测试 | 覆盖 |
|---|
test_skin_pack.mjs | skin.json 解析与校验：默认值、枚举回落、缺字段、坏 JSON、非法 id、超长截断 |
test_pack_routes.mjs | 三条路由的集成测试（真 http server + 桩 ctx）：清单合并、坏包记录、包内取图、双根解析、目录穿越与非法 id 一律 404 |
test_normalize_pref.mjs | 设置导入的白名单与类型校验 |
test_state.mjs | Agent 状态判定（含"生成中 + 旧错误行"、隐藏节点与非误判） |
兼容与限制
- 目标运行时：DSH
0.2.0-rc.2（桌面端内嵌运行时）
- 依赖内置客户端的 CSS-module 类名后缀（
_frame、_centerCol、_sidebarCol、_composerSeat、_header、_running、_turnErrorRow、_reject）与 --dsw-alias-bg-base、--dsw-specific-sidebar-fill 令牌。DSH 改名后对应效果会静默失效（界面回到出厂外观，不报错）
- 装饰层只读外壳几何，不做像素级锁定；布局变化由
resize + 1.5s 低频同步兜住
- 皮肤包的宿主发现路径（投放目录 / 插件声明
dsh.whaleWallpaperSkins）需要重启一次宿主；索引安装路径不需要
- 立绘与壁纸衍生自
dsh-whale-musume（MIT），仅本地使用，请遵守其许可
许可
MIT © Cicero010
第三方素材与代码的许可见 THIRD-PARTY-NOTICES.md
