主题色板管理器 n0pe-sled/herdr-themes

dsh-herdr-themes

Settings → Themes。 把 herdr 自带的全部主题（18 个内置主题）加进 DSH 网页 GUI，并新增一个 Themes 设置页。每个主题在页面上显示真实色板，点击即可实时预览，再点 Use theme 保存。保存的选择在每次重新加载后自动重新应用。

主题

| 主题 | 配色方案 |
| Catppuccin Mocha（herdr 默认） | 深色 |
| Catppuccin Latte | 浅色 |
| Terminal（ANSI 近似） | 深色 |
| Tokyo Night | 深色 |
| Tokyo Night Day | 浅色 |
| Dracula | 深色 |
| Nord | 深色 |
| Gruvbox | 深色 |
| Gruvbox Light | 浅色 |
| One Dark | 深色 |
| One Light | 浅色 |
| Solarized Dark | 深色 |
| Solarized Light | 浅色 |
| Kanagawa | 深色 |
| Kanagawa Lotus | 浅色 |
| Rosé Pine | 深色 |
| Rosé Pine Dawn | 浅色 |
| Vesper | 深色 |

工作原理

DSH 自带的主题系统（dsh-client-ui-theme）就是注册表。插件的浏览器端把每个 herdr 调色板注册为 ThemeDefinition（id + 配色方案 + --dsw-alias- token 覆盖），调用 ctx.theme.register(...)，因此色板、token 和呈现器机制全部沿用官方实现。herdr 调色板按角色映射到 DSH token（accent → brand-primary，text → label-primary，panel background → bg-base，surfaces → bg-layer-，states → state-），派生值（边框、悬停、滚动条）用 color-mix 从同一调色板算出，保证在深色和浅色底上都清晰可读。

持久化放在插件自己的宿主端命名空间（herdr-themes → themeId，写入 $DSH_HOME/settings.yaml，由官方文件服务商管理）。内置的 ui-theme 偏好 schema 只接受 light/dark/system，第三方 id 有意排除在外，所以插件自己保存选择，并在启动时重新应用。

有一处上游行为需要防护。只要设置文档重新推导，ThemeRuntime 就会重新采用持久化的内置偏好（light/dark/system）；任何设置写入或推送都会触发，不只是本插件。正是这次重置让保存的主题在保存后立刻消失。因此插件把已保存的 herdr 主题视为用户的明确选择，在每次重置后重新应用；只有用户自己执行应用/预览操作时才跳过这次重新应用，这样预览或保存系统选项仍然正常。

安装

git clone --recurse-submodules https://github.com/n0pe-sled/deepseek-harness.git ~/deepseek-harness

dsh plugin --profile web add ~/deepseek-harness/plugins/herdr-themes
restart dsh web, then Settings → Themes

用法

- 打开 Settings → Themes。每张卡片预览该主题自己的调色板（base、surface、accent、text、red、green、yellow）。
- 点击卡片立即应用。这就是预览；整个 GUI 通过标准主题呈现器重绘。
- 点击 Use theme 保存（宿主会确认写入，写入被拒会报错，不会静默丢失）。Cancel 回到已保存的选择。
- 跟随系统会回到内置系统行为，并清除已保存的主题。
- 预览时关闭设置，预览只在本次会话保留，不会保存；下次重新加载会恢复已保存的选择。

验证

cd herdr-themes
pnpm install
pnpm build # builds lib/index.js (node) and lib/client.js (browser bundle)
node tests/smoke.mjs # node half + catalog + bundle shape
node tests/client-smoke.mjs # real client bundle against a stubbed context

安装到配置档后，运行中的 dsh web 会提供 bundle，宿主会注册命名空间（在第二个实例上检查）：

curl -s -o /dev/null -w "%{http_code}\n" \
http://127.0.0.1:<port>/plugins/dsh-herdr-themes/client.js # 200

说明与限制

- 终端主题使用固定的类 ANSI 色集。 Herdr 的 Terminal 主题引用宿主终端的 16 个调色板颜色；Web GUI 没有终端调色板，所以插件改用标准的近黑 xterm 风格近似值（在 src/shared/themes.ts 的 README 中有说明）。
- 远程浏览器无法保存。 选择只在本次会话有效；宿主设置 RPC 仅限回环地址（与内置 Appearance 行规则相同）。
- Appearance 行不再覆盖已保存的主题。 在那里点击 light/dark/system 会短暂改变内置偏好，但已保存的 herdr 主题会立即重新应用；要清除主题得去 Themes 页面（跟随系统或使用系统）。Appearance 方块显示的是内置偏好，不是当前生效的第三方主题。
- 并非每个 --dsw- token 都被覆盖。 遮罩、少数冷门按钮填充和反色表面仍用基础调色板；覆盖集包括表面、文本、品牌、状态、markdown、滚动条和侧边栏座位。

文件

- src/shared/themes.ts — herdr 调色板（逐字取自 herdrdev/herdr/src/app/state.rs）+ DSH token 构建器。
- src/index.ts — 宿主部分：注册 herdr-themes 设置命名空间。
- src/client/index.ts — 注册主题、采用已保存的选择、注册 Themes 区块。
- src/client/ThemesPanel.tsx — 设置页面。