前言¶

在 DSH 的 Web GUI 裏，主題調整通常不只是改一個 accent 顏色：背景、前景、字體、側邊欄和對比度都會影響長時間閱讀的可用性。dsh-theme-plugin 面向這類需求，提供 5 套預設和按 light/dark 模式自定義的入口，並在當前 Web 會話中即時應用。

這是什麼¶

dsh-theme-plugin 是 DeepSeek Harness（DSH）Web GUI 的主題插件。它提供 5 套內置預設，並支持按 light/dark 模式自定義 accent、background、foreground、UI 字體、代碼字體、半透明側邊欄和對比度。

倉庫 owner 爲 BeiZi6，package.json 中 author 爲 Xu Yuanshan，許可證爲 MIT。

核心功能¶

下面介紹已覈實資料中的能力。

• 內置預設：stock、codex-warm、nord、solarized、graphite。
• 按模式自定義：light.* 與 dark.* 可設置 accent、background、foreground、UI 字體、代碼字體、半透明側邊欄和對比度。
• 即時應用：通過官方 ctx.theme.overrideTokens API 應用更改，無需刷新頁面。
• 本地保留：選擇保存在瀏覽器 localStorage 中，刷新後保留。
• 令牌推導：從背景、前景、強調色和對比度推導 70+ 個語義令牌。
• 注入方式：通過官方 webServer.tapIndex 接縫向 index.html 注入主題樣式，不修改 vendor 文件。
• 設置界面：提供 Settings → Theme Studio GUI，支持預設、顏色、字體、半透明側邊欄和對比度控制。

另外，stock 預設不派生調色板，顏色控制禁用，僅可覆蓋字體；custom 模式從 codex-warm 調色板開始，並使用 light.* / dark.* 中的值。

安裝與啓用¶

前提是使用啓用 web profile 的 DSH，並且安裝後需要重啓 dsh web。

安裝命令：

dsh plugin --profile web add github:BeiZi6/dsh-theme-plugin

然後重啓或啓動 dsh web：

dsh web

如需移除插件，可以執行：

dsh plugin --profile web remove dsh-theme-plugin

環境要求：

• Node.js >= 22.19
• 許可證爲 MIT

典型用法¶

使用設置界面¶

重啓後打開 Settings → Theme Studio。可以選擇 Preset，並調整 Colors、Fonts、Translucent sidebar 和 Contrast。GUI 選擇優先於 host config。

每次更改即時應用，並保存在本地。

在 web profile patch 中配置¶

也可以在 web profile patch 中添加 theme-plugin 配置。路徑爲：

$DSH_HOME/profiles/web/cordis.patch.yml

示例配置如下。這裏以 codex-warm 爲預設，並同時設置 light/dark 的關鍵字段：

- id: theme-plugin
  config:
    preset: codex-warm
    light:
      accent: '#FF6B35'
      background: '#FFFAF0'
      foreground: '#1A1A1A'
      uiFont: '"Inter", "PingFang SC", sans-serif'
      codeFont: '"JetBrains Mono", Consolas, monospace'
      translucentSidebar: off
      contrast: 70
    dark:
      accent: '#FFB07A'
      background: '#1A1A1A'
      foreground: '#F5F5F5'
      uiFont: '"Inter", "PingFang SC", sans-serif'
      codeFont: '"JetBrains Mono", Consolas, monospace'
      translucentSidebar: on
      contrast: 70

只設置需要改動的字段。空字符串表示保留預設值；未設置字段不會被覆蓋。

適用場景與注意¶

適合在 DSH Web GUI 中按個人習慣調整深淺色主題、字體、側邊欄和對比度的場景。使用插件前，建議先檢查源碼、許可證和行爲範圍；插件會隨當前 dsh 進程權限運行。

需要注意：

• 安裝後需要重啓 dsh web。
• GUI 選擇優先於 host config。
• stock 預設下顏色控制不可用，只能覆蓋字體。
• custom 模式基於 codex-warm 調色板開始，並使用 light.* / dark.* 字段。

鏈接¶

dsh-theme-plugin 的價值在於把 DSH Web GUI 的主題調整集中到預設與模式化配置中：先選預設，再按 light/dark 調顏色、字體、側邊欄和對比度，最後即時生效並保留。

GitHub 倉庫：

https://github.com/BeiZi6/dsh-theme-plugin

目錄頁 URL 未在已覈實資料中出現，本文不給出鏈接。