终端配色 wnanbei/dsh-terminal-theme

dsh-terminal-theme

给 DeepSeek Harness 的终端面板换配色：选一个内置主题，或从 JSON 导入自己的主题。颜色只作用于终端面板，DSH 其余界面继续使用当前主题。

特性

- 只改终端：所有规则都限定在终端面板子树内，侧边栏、对话区和设置页仍然读取 DSH 的主题 token。
- 不受亮暗切换影响：应用在亮色/暗色之间切换时，终端保持自己选定的配色。
- 可导入：粘贴 JSON 或选择文件导入，导入时校验并规整格式，主题保存在浏览器里。
- 可完全还原：选「跟随应用主题」即恢复 DSH 默认外观，其余设置一概不动。

安装

用 DSH 原生的插件页安装：添加插件 → 粘贴一个 spec → 安装。以下三种都可用：

| Spec | 适用场景 |
| dsh-terminal-theme | 包发布到 npm 之后 |
| https://github.com/wnanbei/dsh-terminal-theme | 直接从 GitHub 装；pnpm 克隆仓库，无需构建 |
| /Users/wnanbei/code/dsh-terminal-theme | 从本地 clone 装，之后继续改代码（装成 link: 依赖） |

对话框还接受 tarball、git+https://… 地址，以及只为这一次安装指定 registry。没有声明 bundle patch 的包会被拒绝，所以仓库根目录必须始终是一个完整可装的包。

本地目录安装会把该目录软链进当前 profile（~/.dsh/profiles/<profile>/node_modules/dsh-terminal-theme），之后在 clone 里改动，重载页面即生效，不用重新打包；从 GitHub 安装则是把包复制进 profile，更新需要先卸载再重装。两种方式下，已安装的包都会被识别为“已安装”，要换安装来源请先卸载。

git clone https://github.com/wnanbei/dsh-terminal-theme.git

Agent 走的是同一个操作：plugin_manager 的 install_bundle，参数填上面任意一个 spec。

使用

1. 打开右侧终端面板，进入设置 → 终端配色。
2. 在颜色主题里点选一张卡片，终端立即改用该配色。
3. 选跟随应用主题即可恢复默认（含亮/暗切换）。

导入主题：

- 在导入颜色主题里粘贴 JSON 后点导入并应用，或点从文件导入选择 .json 文件。
- 填入模板会写入一份可直接修改的完整示例。
- 复制当前主题把当前配色导出为 JSON，改个名字再导入就是新主题。
- 自定义主题卡片右上角的 × 用于删除。

主题保存在本机浏览器（localStorage），不写入 profile 配置，因此不会随 DSH 升级丢失，也不会同步到其他浏览器。

主题 JSON 格式

{
"name": "My Theme",
"background": "#101216",
"foreground": "#d5dae2",
"cursor": "#7aa2f7",
"selection": "#26303f",
"ansi": [
"#101216", "#e05f65", "#78bb7b", "#f1cf8a",
"#70a5eb", "#c68aee", "#74e0c8", "#d5dae2",
"#5b6270", "#ff8a8f", "#9be59d", "#ffe0a3",
"#9ac2ff", "#e0aaff", "#9ff3e0", "#ffffff"
]
}

| 字段 | 必填 | 说明 |
| name | 是 | 显示名，1–60 个字符 |
| background / foreground | 是 | 终端底色与默认文字色 |
| cursor | 否 | 光标色，默认取 foreground |
| selection | 否 | 选区底色，默认取 foreground 的 30% |
| ansi | 是 | 16 个颜色：黑、红、绿、黄、蓝、洋红、青、白，再接 8 个亮色。也可只写 8 个，亮色沿用前 8 个 |
| extended | 否 | 最多 240 个颜色，对应 256 色里的 16–255 |

颜色必须写成十六进制（#rgb 或 #rrggbb，会统一规整为小写 #rrggbb）；其他写法在导入时会被拒绝，并在页面上显示原因。

实现说明

- 所有规则都限定在 [data-sidebar-terminal] 子树内：在这个子树重新绑定 --dsw-alias-bg-base、--dsw-alias-label-primary，并覆盖 xterm DOM 渲染器的 .xterm-fg-N / .xterm-bg-N 规则，不会改动 DSH 全局主题 token。
- 不替换、不包裹终端组件，也不读写终端的私有状态；取消选择时只是移除注入的样式表。
- 终端自带的 OSC 颜色处理、对比度调整、光标可见性逻辑均保持原样。
- 新增内置主题只需在 client.js 的 BUILTINS 里追加一项；其余主题走设置页导入即可。

内置主题

Dracula、Nord、Solarized Dark / Light、Gruvbox Dark、One Dark、Tokyo Night、Catppuccin Mocha、GitHub Light。

开发

client.js 浏览器半：限定作用域的配色样式表 + 设置页 index.js Host 半：空实现，仅用于注册 bundle 行 locale/ 插件管理器里的显示名与描述 icon.svg 插件图标 scripts/ 预检脚本（CI 与打 tag 前共用） .github/ verify / release 工作流

改完 client.js 后重载页面即可：插件管理器的安装记录指向本目录，不需要重新安装。

发版

版本遵循语义化版本：主题 JSON 结构或已发布的内置主题 id 发生不兼容变化时升 major；新增内置主题、设置页新功能升 minor；修 bug 升 patch。

package.json 的 version 是唯一版本来源，tag 为 v<version>：

node scripts/check.mjs # 与 CI 相同的预检
npm version patch -m "chore(release): v%s" # 或 minor / major
git push --follow-tags

推 tag 会触发 .github/workflows/release.yml：tag 与 package.json 版本不一致则直接失败；随后重跑预检、打包，并创建一个以 tag 命名的 GitHub Release，附带 .tgz，说明由上一个 tag 以来的提交生成。

这个 tarball 本身也是可安装的 spec，所以不发 npm 也能锁版本：

- https://github.com/wnanbei/dsh-terminal-theme/releases/download/v1.2.0/dsh-terminal-theme-1.2.0.tgz 固定到该版本
- https://github.com/wnanbei/dsh-terminal-theme 跟随默认分支

每次推 main 会跑 .github/workflows/verify.yml，内容就是 node scripts/check.mjs。

License

MIT