dsh-plugin-colorscheme

English

为 DeepSeek Harness 提供配色方案（colorscheme）：内置多款知名开源主题的 配色，加载后可在 设置 → 插件 → 插件配置 → 配色方案 卡片中一键切换，选择会持久化并 在刷新后自动恢复。

• 内置 8 个预设主题（Dracula、Nord、One Dark/Light、Tokyo Night、 Catppuccin Mocha、VS Code Dark/Light），许可与署名见 THIRD_PARTY_NOTICES.md
• 支持三种用户扩展方式（见下），也可以在 设置 → 插件 → 配色方案 页签里 直接「新增主题」（填几个颜色即可，自动写入主题目录）、删除自定义主题， 并可在 设置 → 插件 → 插件配置 → 配色方案 卡片内在线修改主题目录。

安装

本仓库已包含构建产物（client.js 与 dist/），克隆后可直接使用；只有修改过 源码才需要先执行 npm install && npm run build。

1. 克隆并进入目录：

   git clone https://github.com/Civitasv/dsh-plugin-colorscheme.git
   cd dsh-plugin-colorscheme
   

2. 让 DSH 能解析它：把插件链接进 profile 的依赖目录（与 dsh 安装的包 同层）：

   ln -sfn "$PWD" ~/.dsh/profiles/node_modules/dsh-plugin-colorscheme
   

3. 注册到配置：编辑 ~/.dsh/profiles/web/cordis.patch.yml：

   - insert:
       - id: colorscheme
         name: dsh-plugin-colorscheme
   

4. 重启 dsh web，打开 设置 → 插件 → 插件配置 → 配色方案 卡片即可切换主题。

装了 pnpm 的话，也可以用 dsh plugin 代替第 2 步：它会把这些参数原样 转交给 pnpm，在 profile 目录里安装。用插件目录的绝对路径执行：

dsh plugin --profile web add /绝对/路径/dsh-plugin-colorscheme

这会把这插件登记为 profile 的依赖（写入 profile 的 package.json 并安装到 其 node_modules），与第 2 步的软链接效果等价；之后仍需执行第 3、4 步。

预览

设置 → 插件 → 插件配置 → 配色方案 卡片（点击即切换并持久化）：

各主题效果：

主题	预览
VS Code Dark
VS Code Light
Dracula
Nord
One Dark
One Light
Tokyo Night Storm
Catppuccin Mocha

扩展方式

1. 主题目录（推荐）

把主题 JSON 文件放进 ~/.dsh/themes/（或通过 themesDir 配置指向其他 目录），每个文件一个主题：

{
  "id": "my-solarized-dark",
  "name": "My Solarized Dark",
  "colorScheme": "dark",
  "roles": {
    "bg": "#002b36",
    "fg": "#839496",
    "accent": "#268bd2"
  }
}

上面的示例用 roles 描述配色（背景、文字、强调色等），通常够用；想 进一步微调时，也可以直接写展开后的 tokens（键以 --dsw- 开头）。 id 不能与内置主题重名。

2. 插件配置

编辑 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
    - id: colorscheme
      name: dsh-plugin-colorscheme
      config:
        themesDir: /abs/path/to/my/themes   # 默认 ~/.dsh/themes
        defaultTheme: dracula               # 未手动选择时的默认主题

3. settings 用户层

直接编辑 ~/.dsh/settings.yaml：

colorscheme:
  selection: dracula
  customThemes:
    - id: my-inline-theme
      name: My Inline Theme
      colorScheme: light
      tokens:
        --dsw-alias-bg-base: "#ffffff"
        --dsw-alias-label-primary: "#333333"

保存后重启 dsh web（或等待 HMR）。customThemes 与主题目录文件等价。

贡献主题

• 想让主题随插件开箱即用（所有用户装上就有）：作为内置预设提交，在 src/themes/presets.ts 新增条目，并在 THIRD_PARTY_NOTICES.md 与 presets-licenses/ 中补充署名与许可。
• 只想分享一个自定义主题文件：放进 example-themes/ 作为示例即可 （注意：示例不会被自动加载，使用者需复制到 ~/.dsh/themes/ 才会生效）。

许可

插件代码为 MIT（LICENSE）。内置预设的原色板归属与许可见 THIRD_PARTY_NOTICES.md 与 presets-licenses/。