前言¶
DeepSeek Harness（DSH）支持通过皮肤包替换控制台外观。皮肤多了之后，版本对照、逐个下载、再手动装包会占不少时间；若默认走海外 npm，国内环境还容易出现拉包慢或失败。社区插件 dsh-skin-updater（维护者 ggxx001，npm 包名 @ggxx/dsh-skin-updater，当前资料版本 0.1.0，MIT）的做法是：不改动第三方皮肤管理器包，只在 设置 → 皮肤管理 页面底部追加一张「更新」卡片，并在宿主侧提供 /api/dsh/skin-updates，把检查、下载与安装接到 DSH 自带的 bundle 安装流程上。
下面介绍它是什么、能做什么，以及如何安装与日常使用。
这是什么¶
dsh-skin-updater 属于 DSH 社区目录中的 趣味换装 类插件。它在皮肤管理页内提供手动与可选的自动更新；下载优先使用国内镜像 https://registry.npmmirror.com，失败时回退官方 npm 源，不依赖 GitHub 拉包。
实现上，客户端用 MutationObserver 监听带 [data-dsh-skin-manager] 的页面，把卡片插在页面内容之后；设置保存在 <DSH_HOME>/skin-updater/settings.json。
核心功能¶
版本对照与手动更新¶
每款已安装皮肤会显示 已装版本 · 最新版本。当存在较新版本时，可在卡片上点击 更新 触发安装。
自动更新¶
勾选 自动更新 后：
- DSH 启动约 90 秒 后会检查一次；
- 此后每 6 小时 检查并在有新版本时更新。
下载与安装路径¶
- 下载固定优先使用
https://registry.npmmirror.com，失败自动回退官方源。 - 更新复用 DSH 自带的
pluginManager.installBundle；包清单、锁文件与皮肤的启用状态仍由 DSH 维护。
安装与启用¶
插件在 SkillHub 目录页 标注为可安装（资料版本 v0.1.0）。该页说明：由 DeepSeek Harness 读取后端安装计划后执行安装，具体命令以目录页与当前 DSH 版本展示的为准，不要自行拼接未在文档中出现的安装字符串。
安装前建议：
- 在 GitHub 仓库 浏览源码与
cordis.patch.yml补丁内容； - 确认许可证（MIT）与权限范围——插件以当前 DSH 进程权限运行。
包通过 cordis.patch.yml 注入客户端：在 @deepseek-ai/dsh-client-ui-settings 上加载 ./client 模块（见 package.json 中的 dsh.client 配置）。
典型用法¶
- 安装并启用插件后，打开 DSH 设置 → 皮肤管理。
- 滚动到页面底部，找到插件追加的 更新 卡片。
- 对照各皮肤的已装版本与最新版本；需要时点击对应 更新。
- 若希望后台定期检查，勾选 自动更新（启动约 90 秒首次检查，之后每 6 小时）。
无需单独编辑 lock 文件或手动调用 npm；宿主 API 为 /api/dsh/skin-updates，与卡片上的操作配合完成检查与安装。
适用场景与注意¶
适合谁
- 常换 DSH 皮肤、希望在一页里完成版本对比与升级的用户；
- 在国内网络下希望优先走 npmmirror、减少拉包失败的情况。
注意
- 自动更新会周期性改写已安装皮肤 bundle，若你固定某一版本做演示或排错，可先关闭自动更新，改用手动 更新。
- SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系；安装第三方插件前请自行审阅源码与许可证。
- 资料中该仓库 GitHub 星标为 0，不代表功能不可用，仅说明社区关注度尚低，问题反馈可走仓库 Issues。
结尾¶
dsh-skin-updater 把皮肤更新的入口收进 皮肤管理 页：版本一目了然，下载走国内镜像并回退官方源，安装走 DSH 原生 installBundle。需要安装或查看说明时，可访问 SkillHub 目录页 与 GitHub 仓库。
