跳到正文
  • 首页
  • 插件说明
  • dsh-skin-switcher

zhtx2024/dsh-skin-switcher

40最近提交 2026年8月14日

dsh-skin-switcher DSH 插件

该插件在 DeepSeek Harness Web GUI 官方设置面板中新增一个「皮肤」页面，自动发现所有已安装的皮肤包（包括不同 npm scope 的皮肤和 dsh-skins 聚合载体中的皮肤），并提供一键切换按钮。切换无需重启服务器，借助 DSH 的配置监视器热重载机制即可生效。同时支持一键恢复官方默认外观，并自动禁用内置皮肤中心以避免冲突。

ui-productivity

如何安装 dsh-skin-switcher DSH 插件

dsh plugin --profile web add dsh-skin-switcher

复制不会执行命令。安装 dsh-skin-switcher DSH 插件前请核对仓库和版本。

dsh-skin-switcher DSH 插件数据来源

dsh-skin-switcher DSH 插件快照日期：2026年8月16日

discovered

dsh-skin-switcher DSH 插件能做什么

  • 在官方设置面板新增「皮肤」设置页
  • 自动发现所有已安装的皮肤包（dsh-client-ui-skin-* 及 dsh-skins 聚合载体中的皮肤）
  • 热切换皮肤，无需重启 DSH 服务
  • 一键恢复官方默认外观
  • 自动禁用内置皮肤中心（ui-skin-center），防止配置冲突

dsh-skin-switcher DSH 插件适合哪些场景

  • 用户希望更换 DSH Web GUI 外观，但不想手动编辑配置文件
  • 用户安装了多个皮肤包，需要一个统一的管理界面来切换
  • 用户希望快速切换皮肤，并能够一键恢复官方默认外观
  • 开发者在测试自定义皮肤时，需要即时生效而无需重启服务
  • 管理员管理 DSH 实例，希望为最终用户提供皮肤选择功能

dsh-skin-switcher DSH 插件适合谁

  • 希望自定义 DSH Web GUI 界面外观的普通用户
  • 开发 DSH 皮肤包的插件开发者，需要在开发过程中便捷切换皮肤

dsh-skin-switcher DSH 插件的限制

  • 仅支持 web profile（安装命令指定了 --profile web）
  • 皮肤包必须符合特定命名和元数据规范（包名以 dsh-client-ui-skin- 开头，需包含 skin.json）
  • 依赖 DSH 配置监视器的热重载机制；若监视器未正常工作，皮肤切换可能无法立即生效
  • 卸载后可能需要手动清理 ~/.dsh/cordis.patch.yml 中残留的 managed section 内容

dsh-skin-switcher DSH 插件的仓库 README 摘录

以下文字摘自 dsh-skin-switcher DSH 插件的上游仓库 zhtx2024/dsh-skin-switcher 的 README，版权归原作者，仅作引用。

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 安装（推荐） ```sh dsh plugin --profile web add dsh-skin-switcher ``` ### 从 GitHub 仓库安装（改代码调试） ```sh # 1. 克隆本仓库 git clone https://github.com/zhtx2024/dsh-skin-switcher.git # 2. 安装进 web profile dsh plugin --profile web add link:<克隆路径>/dsh-skin-switcher ``` 然后重启 `dsh web`（或依赖热重载），打开 设置 → 皮肤。 ## 卸载 ```sh dsh plugin --profile web remove dsh-skin-switcher ``` 卸载后如仍残留 `~/.dsh/cordis.patch.yml` 中的 managed section，可手动删除 `# --- dsh-skin-switcher managed ---` 与 `# --- end dsh-skin-switcher managed ---` 之间的内容。 ## 工作原理 | 半 | 文件 | 职责 | |---|---|---| | Host | `lib/index.js` | 挂载 `/api/skin-sw

阅读完整 README仓库许可: NOASSERTION

dsh-skin-switcher DSH 插件常见问题

dsh-skin-switcher 如何安装？

执行命令 `dsh plugin --profile web add dsh-skin-switcher` 即可将其添加到您的 web profile 中。安装后重启 DSH web 服务（或等待热重载），然后打开设置 → 皮肤即可看到新的页面。

为什么皮肤页面看不到任何皮肤？

您需要先安装至少一个皮肤包。皮肤包必须以 `dsh-client-ui-skin-` 开头并包含 `skin.json` 文件。通过 `dsh plugin --profile web add <包名>` 安装皮肤包后，皮肤页面会自动列出它们。

切换皮肤需要重启 DSH 服务吗？

不需要。dsh-skin-switcher 利用 DSH 的配置监视器和热重载机制。当您选择皮肤时，插件会将配置写入 `~/.dsh/cordis.patch.yml`，监视器会在数秒内应用更改，页面会自动刷新以加载新皮肤。

如何恢复 DSH 默认外观？

在皮肤页面点击「恢复默认」按钮即可。该操作会移除所有皮肤特定配置，并重新启用官方默认的客户端插件。更改通过热重载生效，无需重启。

可以同时使用这个插件和内置的皮肤中心吗？

不可以。dsh-skin-switcher 会自动禁用内置皮肤中心（`ui-skin-center`），以防止两个管理器写入冲突的配置。本插件是皮肤管理的唯一权威。如果您想使用内置皮肤中心，必须先卸载 dsh-skin-switcher。