zhtx2024/dsh-skin-switcher

README 摘要

dsh-skin-switcher DeepSeek Harness Web GUI 的皮肤切换插件：在设置界面新增「皮肤」页，列出所有已安装的皮肤并提供一键切换按钮，支持一键恢复官方默认外观。 特性 - 设置界面内切换 ：官方设置面板新增「皮肤」页（ settings.section ），已安装皮肤自动列出，无需改代码 - 统一管理所有皮肤 ：自动发现 profile 中所有 dsh-client-ui-skin- 皮肤包（支持任意 npm scope，如 @dsh-external/dsh-client-ui-skin-maid-atelier ），以及 dsh-web-ui 的 dsh-skins 聚合载体（qq98 / ths / xp / minecraft / blue-fantasy / whale-song / trading / dragon-heir / miku 等） - 热切换，无需重启 ：切换写入 /.dsh/cordis.patch.yml 的 managed section（原子重写），DSH 配置监视器数秒内热重载，页面自动刷新生效 - 一键恢复默认 ：「恢复默认」回到官方原版外观 - 单一管理权威 ：自动禁用 dsh-web-ui 自带的皮肤中心（ ui-skin-center ），避免两个管理器写入冲突的配置 安装 从 npm 安装（推荐） 从 GitHub 仓库安装（改代码调试） 然后重启 dsh web （或依赖热重载），打开 设置 → 皮肤。 卸载 卸载后如仍残留 /.dsh/cordis.patch.yml 中的 managed section，可手动删除 dsh-skin-switcher managed 与 end dsh-skin-switcher managed 之间的内容。 工作原理 半 文件 职责 Host lib/index.js 挂载 /api/skin-switcher/state 与 /api/skin-switcher/use 路由；扫描 /.dsh/profiles/web/node modules 发现皮肤；管理 boot patch 的 managed section Browser lib/client.js 注册设置面板 settings.section 「皮肤」页；切换后轮询 state 直至配置监视器确认，再刷新页面加载新的客户端插件图 皮肤切换协议 - 非激活皮肤 → 写入 - id: + disabled: true （DSH 官方 loader patch 语法） - 激活皮肤（bundle-wired，即其包名在 dsh.profile.bundles 中）→ 不写行，解除禁用即恢复 - 激活皮肤（未 bundle-wired，如 dsh-skins 载体中的皮肤）→ 自…

分类