主题配色切换 guillaumemeyer/dsh-themes

🎨 DeepSeek Harness 主题

一组可供选择的 DeepSeek Harness (DSH) 配色主题。

它在 常规 设置页面中添加了一个 主题 区块，展示六张主题卡片——Tokyo Night、Catppuccin、Dracula、Gruvbox、Nord、One Dark——每张卡片都带有实时颜色预览。点击卡片即可立即应用主题；点击另一张即可切换。调色板以令牌覆盖层的形式叠加，因此应用的背景、表面、边框、品牌/文本颜色、状态颜色以及侧边栏会一起重新着色。

功能特性

- 六款主题，采用上游项目的经典调色板：Tokyo Night、Catppuccin (Mocha)、Dracula、Gruvbox (dark)、Nord、One Dark。
- 实时预览卡片 位于常规设置行中——每张卡片的色板取自该主题的 字面 颜色，因此在应用主题之前/期间都保持清晰可辨。
- 即时应用：一次点击即可叠加一个 theme.overrideTokens 层；所选卡片会高亮显示，重新选择另一张会就地替换该层。
- 撤销 / 还原：该行按需应用主题；停止插件（或不选择任何主题）会让应用保持默认主题。

安装

最简单的方式是使用 DSH 插件 CLI。将插件添加到默认的 web 配置：

dsh plugin --profile web add github:guillaumemeyer/dsh-themes

注意： web 是默认配置，因此可以调整。使用 --profile 来指定不同的配置（或项目特定的配置），或者省略 --profile web 以使用默认配置。CLI 会将插件接入部署的 web 表面组合中，并为你重新构建浏览器 bundle。

手动安装

更愿意手动接入？这是一个 dsh.client 浏览器插件，因此必须安装并挂载到 DSH 组合其 web 表面（host/web 组合）的位置，然后重启宿主，以便客户端模块的 node 半部分生成 bundle。

1. 将包安装 到 DSH 部署的 web 应用中：

npm i @guillaumemeyer/dsh-themes

2. 找到 web 表面（浏览器名册）组合。 这是 DSH web 应用中的 cordis.yml / cordis.patch.yml，其中列出了其他浏览器名册行（ui-settings-general、ui-theme 等）。（随附的 @deepseek-ai/dsh-web-app cordis.patch.yml 是此“浏览器插件名册”部分的参考。）

3. 向该名册添加一行：

- id: ui-themes
name: '@guillaumemeyer/dsh-themes'

4. 重启 DSH 宿主。 @deepseek-ai/dsh-client-modules 的 node 半部分会重新扫描加载器条目，查找声明了 dsh.client 的包，打包 /plugins/@guillaumemeyer/dsh-themes/client.js，然后浏览器会加载它。（使用 pnpm run dev:web 监听器时，bundle 会自动重新构建，无需重启；在生产/已构建的部署中，则需要重启宿主。）

该行 必须 位于 web 表面 dsh.client 名册 中（一个 dsh.client platform: "web" 包）。将其放在 agent 预设或一个非 Web 组合将不会被扫描进 window.__DSH_BOOT__。

验证它已挂载

重启后，该包的浏览器 bundle 会通过 /plugins/@guillaumemeyer/dsh-themes/client.js 提供，并且该插件会出现在 settings.general.item 插槽中。

使用它

1. 打开 Settings（侧边栏底部的齿轮图标）。
2. 打开 General。
3. 在 Themes 下，点击一个主题卡片来应用它。应用会立即重新着色，并且该卡片会显示选中环。
4. 点击另一张卡片进行切换；之前的覆盖会被就地替换。

发布更新

要发布新版本，请确保本地 .env（未跟踪）中保存了你的 npm token，然后：

cp .env.example .env # 一次：编辑以添加 NPM_TOKEN=...
npm run release # 运行 publish:check（preversion），提升 patch 版本，发布到 npm

- token 从 .env 读取，并由已提交的 .npmrc 通过 ${NPM_TOKEN} 引用，因此它永远不会被跟踪。
- preversion 会在版本提升前自动运行 node --check client.js && npm pack --dry-run。
- 该脚本命名为 release，因为 publish 是 npm 的保留生命周期名称：npm 会在 npm publish 期间自动运行 publish 脚本。将其命名为 publish 会导致 npm publish 重新运行该脚本，从而在每次循环中提升版本并发布一个新版本。

说明

- 仅客户端的浏览器插件；node 部分（index.js）是一个空的 apply。
- 选择是内存中的，仅作用于页面会话（DSH 客户端不会向插件代码暴露 localStorage，而一个应用外观的设置 UI 也不需要持久化它）；在重新加载时，应用会恢复默认主题，直到点击某张卡片。
- 全部六个主题都是深色调色板，因此每个主题都会将 token 覆盖的 light 和 dark 槽位映射为相同的值——该主题在两种操作系统配色方案中都完整定义了自己的外观。
- 包以 publishConfig.access: "public" 发布；.npmignore 会丢弃仓库/开发相关的杂物。

许可证

MIT