前言¶
長時間在 DeepSeek Harness（DSH）裏寫提示、看回復和讀代碼塊時，界面字體和主題往往只能跟着宿主默認走。系統級縮放或換顯示器之後，字號和對比度不一定合適；想給側邊欄和內容區各定一套顏色，原生設置也未必夠用。社區插件 dsh-stylebook（倉庫 tsuixl/dsh-stylebook）把「界面文字 / 代碼字體」和「三項主色 + 命名方案」收到 設置 → 外觀 裏，改完即時生效並寫入 DSH Host。下面介紹它做什麼、怎麼裝、怎麼用，以及停用與卸載時要注意的點。
這是什麼¶
dsh-stylebook 是 DSH 的外觀插件：分別設置界面與代碼的字體、字號、字重；用主題底色、側邊欄色、強調色三項調整主題（其餘表面、文字和邊框自動派生）；支持淺色、深色、跟隨系統，以及內置與自定義的命名外觀方案。維護者爲 tsuixl。首個預覽版本爲 0.1.0-beta.1，通過 GitHub Releases 分發預構建包，尚未發佈到 npm 或插件源；兼容範圍暫定爲 DSH 0.2.1-rc.5。項目在 SkillHub 目錄頁 可檢索；該目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
字體¶
- 界面文字、代碼字體分別選擇字體、字號（10–22 px）和字重（Regular / Medium / SemiBold / Bold）。
- 字體菜單支持搜索名稱、「讀取系統字體」和手動輸入；不支持或未授權時可搜索或輸入名稱。
- 保存的是字體名稱，不會打包或上傳字體文件；換設備缺少字體時使用回退字體。終端獨立字體不在當前設置範圍內。
配色與主題模式¶
- 在「配色」中通過色塊或 HEX 編輯主題底色（主內容與浮層）、側邊欄、強調色；淺色與深色色板分別保存。
- 「主題模式」可選淺色、深色或跟隨系統。
外觀方案¶
- 提供四個內置方案，以及自定義方案的保存、選擇、刪除；修改不會覆蓋原方案，僅自定義方案可刪除。
- 修改即時應用並保存到 DSH Host；界面會顯示保存狀態，寫入失敗會以宿主實際接受值爲準。
生命週期¶
- 恢復默認會保留自定義方案；停用插件會撤銷 Stylebook 的界面和樣式覆蓋，原生明暗模式偏好仍保留。
- 從舊「七色」版本升級時，主內容區顏色遷移爲主題底色，完整舊設置保留在插件
legacyBackup字段中（詳見 README）。
安裝與啓用¶
安裝和移除前應從托盤完整退出 DSH。從 v0.1.0-beta.1 Release 下載 .tgz，或使用自行構建的安裝包。
在 PowerShell 中將路徑替換爲自己的桌面應用安裝目錄與安裝包位置，使用該桌面版本自帶的 CLI（不要使用另一套 npm DSH 管理桌面的保留 profile，也不要修改 app.asar）：
$dshCli = 'C:\path\to\DeepSeekHarness\resources\runtime\cli\bin\dsh.cmd'
& $dshCli plugin --profile desktop add 'C:\Downloads\dsh-stylebook-0.1.0-beta.1.tgz'
重新打開 DSH，進入「設置 → 外觀」即可使用。
典型用法¶
經過上面的安裝步驟後，可按 README 中的順序調整：
- 在「主題模式」選擇淺色、深色或跟隨系統。
- 在「字體」分別調整界面文字和代碼字體；需要時可點擊「讀取系統字體」。
- 在「配色」調整三項主色；其餘區域由插件派生。
- 在「外觀方案」選擇已有方案，或「另存爲方案」。
- 等待「已保存」後再認爲設置完成；快速連續修改會按順序保存，「完成」會等待期間新增的保存請求。
方案寫入涉及插件配置與原生主題兩個條目，不提供跨條目原子事務；部分失敗時界面會明確提示。
適用場景與注意¶
適合誰：需要在 DSH 桌面版上細調閱讀體驗、統一代碼塊與界面字體，並希望用少量主色快速搭出可複用的淺色 / 深色方案的用戶。
平臺與驗收：README 寫明本項目以 Windows 桌面版驗收爲準；Web、macOS、Linux 尚未實測，代碼共用不代表其他平臺已通過驗收。詳情見倉庫 驗證記錄（GitHub 上路徑）。
安全與信任：插件在當前 DSH 進程權限下運行，會改寫 Host 配置與界面注入；安裝前應閱讀 源碼與 MIT 許可證，並只從 Release 或可信構建獲取 .tgz。
卸載：完整退出 DSH 後執行：
& $dshCli plugin --profile desktop remove dsh-stylebook
需要保留個人方案時，先備份該 profile 的配置（尤其是 cordis.patch.yml）以及上一個可用的 .tgz；恢復時覈對插件條目，避免用整份舊 profile 覆蓋期間的其他修改。
結尾¶
dsh-stylebook 把 DSH 外觀從「跟着默認走」變成可命名的字體與三色主題方案，適合在 Windows 桌面 DSH 0.2.1-rc.5 上先行試用。更多信息見 GitHub 倉庫 與 SkillHub 目錄頁。
