dsh-skin-manager · 皮肤管理器

English | 中文

面向 DeepSeek Harness Web GUI 的轻量皮肤管理器：自动发现所有已安装的 皮肤（任何带 skin.json 且附带预构建 client bundle 的包），在独立的 设置 → 皮肤 页面列出全部皮肤，一键切换——互斥生效，热载入无需重启 dsh web。

特性

• 动态发现：扫描 web profile 的 node_modules，找出所有带 skin.json 和预构建 lib/client.js 的包；也能识别市场下载的无 skin.json 主题 （带 client bundle 且 cordis.patch.yml 插入 theme/skin 行，例如 dsh-skin / Codex 风格皮肤、dsh-kimino-theme）。新装的皮肤自动出现， 无需重新生成清单、无需改代码。
• 独立设置页：注册 settings.section（id skins，order 20），出现在 设置侧栏，与「通用」「模型」平级。
• 一键应用：选中皮肤点「应用」，profile patch 被重写，DSH 配置 watcher 秒级热载入；刷新页面即生效。
• 互斥切换：同一时刻只激活一个皮肤（激活者写 insert 行，其余写 disabled: true 行）。
• 恢复默认：「官方默认」关闭全部皮肤，回到 DeepSeek Harness 原生外观。

安装

dsh plugin --profile web add github:xiaoyangcheng84-svg/dsh-skin-manager

然后重启 dsh web（或走插件市场热安装）。刷新页面后打开 设置 → 皮肤。

github: 源安装需要本机有 git；也可以本地 checkout 后用 dsh plugin --profile web add link:<路径> 安装。

使用

1. 打开 设置 → 皮肤
2. 看到「官方默认」+ 所有已安装皮肤（如 深海女仆工坊 / maid-atelier）
3. 点某皮肤的「应用」→ 提示成功后点「刷新」→ 皮肤切换
4. 点「官方默认」的「应用」→ 恢复原生外观

皮肤包协议

任意包满足以下条件即被识别为皮肤并出现在列表：

• 位于 profile 的 node_modules（顶层或 @scope/name）
• 带 skin.json（id、name、package、accent、bodyAttr、 tagline，可选 wiring.id——与 dsh-deep-whale / dsh-web-ui 皮肤字段一致）
• 带预构建 client bundle（exports["./client"] 或 lib/client.js）

没有 skin.json 的市场主题也会被识别，条件如下：

• 有 dsh.client 和 dsh.bundle.patch
• cordis.patch.yml 里是简单的 insert 行
• 包名、loader 行 id，或（immediately 加载的 client bundle）描述/关键词 包含 theme/skin
• 带预构建 client bundle

与插件市场（dsh-market）的联动

安装 dsh-market 时，用本管理器应用皮肤会同时：

• 重写 cordis.patch.yml 的 managed 段（重启后仍生效）
• 更新 dsh-market 的 .dsh-market/state.json，防止它在下次启动时把刚 选中的皮肤再禁用
• 卸载 dsh-market 残留的 hot mount，避免多个皮肤叠在一起
• 在改写 patch 前先同步 dsh-market 的内存禁用状态，防止市场的自愈逻辑 把你刚应用的皮肤立刻又禁用掉——不需要再手动去市场里点“使用”

切换原理

切换 = 重写 profile 的 cordis.patch.yml 中由 # --- dsh-skin-manager managed --- 标记的 managed 段：

• 激活皮肤 → - insert: 行
• 其他皮肤 → - id: <rowId> + disabled: true 行

非皮肤的用户 patch 行（如 dsh-market）原样保留。

API

host 半区在 /api/skin-manager 下挂三个路由：

路由	方法	用途
/api/skin-manager/list	GET	列出已装皮肤 + 当前激活 id
/api/skin-manager/apply	POST	{ id } 或 { id: "official" } 切换
/api/skin-manager/bundle	GET	?id=<skinId> 提供皮肤的 client bundle

开发

client bundle 直接用 __ModuleLoader__ bundle 格式手写（与官方 ui-* 包 tsdown 产物的形状一致），无需构建步骤。lib/client.js 只能 require 模块表实体（平台种子词如 react、已注册的 client bundle）。

许可

MIT