dsh-one-dark-pro：One Dark Pro 配色與外觀切換

前言¶

DSH（DeepSeek Harness）採用插件化架構，允許開發者通過配置文件和插件擴展功能。在視覺體驗上，開發者可能需要更符合習慣的界面配色。One Dark Pro 是一款在 VSCode 端廣泛使用的主題，本插件旨在將 One Dark Pro 的配色方案引入 DSH 環境，並將原本有限的外觀選項擴展爲淺色、深色、跟隨系統、One Dark Pro 四宮格選擇。

插件定位¶

名稱：theheartfickle/dsh-one-dark-pro
維護者：TheHeartFickle
類別：趣味換裝
功能：註冊 One Dark Pro 配色，持久化外觀偏好設置。
許可證：MIT

安裝與啓用¶

安裝該插件需要手動修改 profile 的 package.json 並重啓 host。

    pnpm install

在 DSH profile 的 package.json 中添加依賴與 bundles 配置。注意 link: 需指向本插件在磁盤上的絕對路徑：

    {
      "dependencies": {
        "@the-heart-fickle/dsh-one-dark-pro": "link:<本插件絕對路徑>"
      },
      "dsh": {
        "profile": {
          "bundles": [
            "...",
            "@the-heart-fickle/dsh-one-dark-pro"
          ]
        }
      }
    }

執行上述配置後，重啓 dsh web。由於 host 半邊包含核心邏輯代碼，必須重啓 host 才能生效。

典型用法¶

安裝並重啓後，外觀設置已集成 One Dark Pro 選項。

打開設置 → 常規 → 外觀。
在主題列表中點選「One Dark Pro」應用。
隨後可點擊「淺色」、「深色」、「跟隨系統」進行快速切換。
選中的主題偏好會被持久化保存至 DSH host 的 ~/.dsh/settings.yaml 文件中，具體字段爲 dsh-one-dark-pro.preference，重啓後保持。

技術說明¶

Host 半邊（lib/index.js）：
- 註冊 dsh-one-dark-pro settings 命名空間。
- 暴露 /api/one-dark-pro/preference 路由，用於處理主題偏好請求。
Client 半邊（lib/client.js）：
- 註冊 One Dark Pro 主題。
- 使用 priority: -1 覆蓋 shadow 自帶的 settings.general.item[appearance] 行。
- 將主題渲染爲四宮格，固定尺寸，選中態使用品牌色邊框。
- 監聽 theme/change 事件以刷新界面。
圖標設計：One Dark Pro 的圖標取自官方 icon.svg，表現爲三條 3D 軌道帶路徑加上實心原子核圓點（24px）。

注意事項¶

本插件以 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
插件的 cordis.patch.yml 會通過 dsh.bundle.patch 自動應用，無需在 profile 的 cordis.patch.yml 中手動添加掛載行。
安裝後務必重啓 dsh web，否則 host 半邊的路由註冊與命名空間配置無法生效。

總結¶

dsh-one-dark-pro 爲 DSH 環境帶來了 One Dark Pro 配色，並豐富了外觀切換的交互方式。通過持久化配置，開發者可以穩定地使用自己喜歡的視覺風格。