前言¶

DeepSeek Harness (DSH) 提供了模塊化的開發環境，默認配置通常能滿足基礎需求。對於需要更精細控制顯示效果的場景，手動修改樣式往往涉及繁瑣的構建步驟或引入大量依賴。

@hmkk/dsh-appearance 旨在解決這個問題。這是一個專爲 DSH 設計的輕量級插件，它不打包任何字體文件，通過修改官方 token（變量）來實現界面與代碼塊的樣式覆蓋。它沒有複雜的構建流程，僅包含兩個 JS 文件和一個配置覆蓋層，直接修改字體棧與配色即可生效。

核心功能¶

該插件主要解決兩個核心問題：字體顯示與界面配色。

零依賴與輕量化¶

• 無文件依賴：不打包任何字體文件，僅使用系統字體棧。
• 零構建步驟：倉庫根目錄即爲插件包，無需編譯。
• 零運行時依賴：沒有額外的 JS 庫依賴。

字體與配色¶

• 字體分離選擇：中文字體與西文字體（界面與正文）分開選擇，代碼字體單獨列選。候選列表僅顯示本機已安裝的字體。
• 官方色板預設：內置 One Dark Pro / Dracula / Nord / GitHub / Catppuccin 五套官方色板，包含深色與淺色模式。
• 深度覆蓋：覆蓋 42 個 token，包括底色、表面、文字、邊框、狀態、卡片、代碼塊等，確保側欄、菜單、卡片與代碼塊風格統一。
• 質量校驗：內置對比度檢查機制，確保配色符合可讀性標準。

安裝與啓用¶

安裝前請確保 DSH 版本爲 0.2.0-rc.2 或更新。

使用官方 CLI 安裝（推薦）：

npx -y --package @deepseek-ai/dsh dsh plugin --profile desktop add @hmkk/dsh-appearance

安裝完成後，在 DSH 的「設置」頁面中找到「外觀」區域即可進行配置。

配置說明¶

在設置頁中主要分爲三個區域：

1. 字體設置：
   • 界面與正文字體（支持中英文分選）。
   • 代碼字體。
   • 正文字號（範圍 10-22px）。
2. 配色設置：
   • 選擇預設主題（One Dark Pro / Dracula / Nord / GitHub / Catppuccin）。
   • 手動調整強調色、背景色與文字色。
3. 高級設置：
   • 導入或導出配置（格式爲 dsh-appearance-v1:{...}）。
   • 重置全部設置。

注意事項¶

• 版本要求：需要 DSH 0.2.0-rc.2 或更新版本。
• 覆蓋範圍：不覆蓋終端字體與 ANSI 色彩；不覆蓋 UI 全局字號（僅支持 10-22px）。
• 字體來源：插件僅使用系統字體棧，不包含任何字體文件，不會出現字體缺失報錯。
• 首屏過渡：由於配色是明暗雙態切換，插件加載後纔會應用配色，刷新頁面時會有極短的默認配色過渡。

結語¶

@hmkk/dsh-appearance 通過複用官方主題擴展點與 token 機制，爲 DSH 提供了一套輕量、無構建、即插即用的外觀增強方案。適合希望快速統一界面風格、進行深度主題定製的開發者。

GitHub 倉庫 | 插件目錄頁