前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於開發者而言，在本地調試或運行時直接替換界面樣式，往往需要修改源碼或編寫複雜的 CSS。DSH Theme Lab 提供了一套現成的主題集合和開發模板，讓樣式定製從零開始變爲可配置的模塊。
這是什麼¶
這是一個爲 DeepSeek Harness 預覽版（0.1.1-rc.2）提供的非官方模塊化主題集合與啓動包。作者爲 Slymaster。它解決了原生 DSH 缺乏多主題切換和持久化設置的問題，通過注入原生設置選擇器和語義化 Token 調色板，提供了一套包含 4 個自定義主題和默認主題的完整方案。
核心功能¶
- 多主題支持：包含 4 個自定義主題（Event Horizon、Cyber Sakura、Obsidian Gold、Digital Rain）以及 DeepSeek Harness 默認主題。
- 數據驅動註冊表：建立單一數據驅動的註冊表，管理卡片、調色板、藝術作品和資源路由。
- 語義化 Token：每個自定義主題精確包含 16 個語義 Token，並包含淺色和深色值。
- 原生持久化：利用 Harness 連接服務實現原生設置持久化，不依賴
localStorage。 - 限定範圍的藝術作品：響應式 WebP 英雄藝術作品，僅限定作用域在
[data-phase='hero']。 - 安全卸載：選擇默認主題或卸載時，可逆向應用 Token 覆蓋並執行完整清理。
- Creator 回退：提供一個輕量級的 Creator 回退，用於在不包含藝術作品或設置的情況下測試 Event Horizon 調色板。
安裝與啓用¶
- 克隆倉庫並構建：
git clone https://github.com/Slymaster/dsh-theme-lab.git
cd dsh-theme-lab
corepack enable
pnpm install --frozen-lockfile
pnpm bundle
pnpm link --global
- 將插件鏈接到 Harness 配置目錄：
pnpm link --global dsh-theme-lab
- 在 Harness 的
cordis.patch.yml中合併單行配置：
- insert:
- id: dsh-theme-lab-live
name: dsh-theme-lab
典型用法¶
啓動 Harness 後，進入 Settings（設置） -> General（通用） -> Interface theme（界面主題）。在列表中選擇以下任一主題：
- DeepSeek original（默認）
- Event Horizon
- Cyber Sakura
- Obsidian Gold
- Digital Rain
適用場景與注意¶
此插件適合需要在 DSH 環境下快速切換界面風格或作爲開發新主題起點的開發者。
- 依賴環境：需要 DeepSeek Harness 版本 0.1.1-rc.2 以及 Node.js 22。
- 權限說明：插件以 DSH 進程權限運行，安裝前請檢查源碼與許可證（MIT）。
- 更新注意：升級 Harness 或 Node 版本前，請留意兼容性說明。若需更新已安裝的主題，建議按文檔描述的兩階段流程操作，避免緩存衝突。
- 殘留設置：卸載後，保存的 dsh-theme-lab 首選項可能會無害地保留在 Harness Settings 文檔中。
短結尾¶
DSH Theme Lab 將界面定製標準化，降低了主題開發門檻。更多細節或報告問題，請訪問 項目目錄 或 GitHub 倉庫。
