前言¶
DeepSeek Harness（DSH）的 Web GUI 自帶明暗與系統外觀切換，但預設配色、字體棧和界面字號往往不能滿足長期盯屏或品牌統一的需求。改瀏覽器樣式或本地 CSS 既難持久，也容易在 DSH 升級後失效。下面介紹社區插件 DSH Theme（@solvashq/dsh-theme）：在 Harness 側邊欄和設置頁內完成主題與外觀個性化，並把選擇寫入 DSH Host 配置，重啓後仍有效。
這是什麼¶
DSH Theme 由 SolvasHQ 維護，在 SkillHub 插件目錄 中歸類爲「趣味換裝」。它面向 DeepSeek Harness Web 客戶端，提供輕量主題色、DIY 調色板、字體與界面文字大小等能力；入口是側邊欄左下角的調色板圖標，與 Settings → 個性化 / Personalization 中的同一套面板。npm 包當前版本爲 1.4.0，許可證 MIT。
核心功能¶
入口與界面語言¶
側邊欄底部、Settings 按鈕上方一行的調色板圖標，單擊打開左下角錨定的緊湊面板；相同選項也出現在設置的「個性化 / Personalization」頁。界面文案隨應用語言在簡體中文與英文之間切換。
預設與自定義主題¶
內置 10 套預設：Default（Harness 原樣）、Warm、Mono、Claude、Claude+、Vermillion、Amber Mono、MX Brutalist、Tiesen、Vescrow，以及 Custom 卡片。明暗模式均爲一等公民：每個預設和 DIY 顏色都包含 light / dark 兩套值，在原生外觀於淺色、深色與跟隨系統之間切換時仍可用。
DIY 主題編輯器 按明暗模式分別設置 background、card、popover、sidebar、text、border 及該模式的 accent；error / success / warning 共用；另有 Bold borders 開關（全局 1 px 邊框並使用 ink-strength 邊框 token）。未固定的色槽會從 background / text 自動推導，保持單模式內協調。
字體與字號¶
拉丁與中文界面字體棧可獨立配置，另有代碼字體，分別作用於界面、對話與代碼文本。文字大小可在 10–22 px 範圍內調節，通過原生 theme 服務的 setFontSize('text', px) 持久化，與 Ctrl/Cmd + / - 快捷鍵一致。
持久化方式¶
選項保存在 DSH Host settings 文檔中（插件 Host 側聲明 .volatile() 字符串字段，客戶端經 ctx.configForms 讀寫），隨 profile 與 localhost 端口配置保留，不依賴 localStorage。明暗偏好與字號仍走 Harness 原生 theme 設置。
實現要點（便於排查）¶
客戶端通過 ctx.theme.overrideTokens('@solvashq/dsh-theme', tokens) 註冊單層主題；每個 token 爲 { light, dark } 對。每套 palette / 模式約 14 個錨色擴展爲約 97 個 --dsw-alias-* / --dsw-specific-* 語義 token，並帶對比度約束。字體經 --dsh-font-family-text / --dsh-font-family-code 寫入同一 token 層。
安裝與啓用¶
DSH 生態採用「一切皆插件」；社區目錄與 npm / jsDelivr 索引由維護者與社區提供，與 DeepSeek / 幻方無官方從屬關係。安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證；插件在當前 DSH 進程權限下運行，僅安裝你信任的來源。
推薦：Plugins → Discover¶
無需 npm 賬號，也無需手改 profile：
- 打開 Plugins → Discover。
- 添加索引源（版本已固定，便於立即可用）：
https://cdn.jsdelivr.net/gh/SolvasHQ/dsh-theme@v1.4.0/market/index.json
若跟蹤 @main 分支，可將 URL 中的 tag 改爲 @main；jsDelivr 對 @main 最長緩存約 12 小時，需要時可 purge https://purge.jsdelivr.net/gh/SolvasHQ/dsh-theme@main/market/index.json。
- 在列表中找到 DSH Theme，進入詳情頁後點擊 Install。
Discover 會安裝該 release 對應的 Git commit；同一 release 亦發佈爲 @solvashq/dsh-theme@1.4.0，並在 GitHub Release 附帶預構建的 dsh-theme.tgz。
npm¶
npm install @solvashq/dsh-theme
也可讓 DSH agent 使用 spec @solvashq/dsh-theme@1.4.0 從 npm 安裝 bundle。
安裝完成後重啓或刷新 Web GUI：側邊欄左下應出現調色板圖標，Settings → 個性化 / Personalization 應出現相同頁面。
典型用法¶
- 單擊側邊欄左下角調色板圖標，或進入 Settings → 個性化 / Personalization。
- 在預設卡片中選擇 Warm、Mono、Claude 等之一，觀察明暗模式下界面是否滿意。
- 選擇 Custom，在 DIY 編輯器中分別調整淺色與深色的背景、卡片、側邊欄、文字與 accent；需要清晰邊界時打開 Bold borders。
- 在字體區域分別設置拉丁、中文與代碼字體棧；用字號滑塊或控件將界面文字調到 10–22 px 範圍內。
- 切換 Harness 原生淺色 / 深色 / 系統外觀，確認預設或 Custom 在兩種模式下仍一致可用。
經上述步驟，個性化結果應寫入 Host settings，關閉瀏覽器或重啓 DSH 後仍保留（同一 profile 與認證身份下）。
適用場景與注意¶
- 適合：長期在 DSH Web GUI 上工作的開發者或使用者，需要多套可讀配色、自定義品牌色、中英字體分離或更大界面字號。
- 注意：DIY 未固定色槽會隨背景 / 文字自動推導；若某槽位需要固定，應在編輯器中明確指定。Host 側插件邏輯變更需重啓 DSH；僅改客戶端 bundle 時，DSH 客戶端 HMR 可在約一秒內熱更新
client.js（開發場景）。 - 版本：本文安裝索引與 npm 示例以資料中的 1.4.0 爲準；升級時請改用 release 或 Discover 索引中的新 tag。
結尾¶
DSH Theme 把 Harness Web 界面的配色、DIY 調色、字體與字號收進側邊欄與設置頁，並與明暗模式、原生字號快捷鍵和 Host 持久化對齊。目錄頁：SkillHub — SolvasHQ/dsh-theme；源碼與說明：github.com/SolvasHQ/dsh-theme。
