DeepSeek Harness (DSH) 支持 Web UI 的插件化擴展。在開發或調試智能體時,編輯器和代碼區域的字體樣式直接影響閱讀體驗。現有主題設置往往無法滿足精細化定製需求,或者需要修改底層源碼。下面介紹一款專注於字體控制的 DSH 插件。
這是什麼¶
dsh-font-plugin 是一個 DeepSeek Harness 插件,由用戶 wtksana 維護。它通過覆蓋 CSS 變量,實現對 Web UI 中編輯器正文和代碼區域的字體族與連字設置的控制。
核心功能¶
該插件提供以下三個核心配置項:
- Font Family : Editor:覆蓋 CSS 變量
--dsw-font-family,同時作用於 UI 文本和 Markdown 正文。 - Font Family : Code:覆蓋 CSS 變量
--ds-font-family-code,作用於代碼塊、命令和日誌區域。 - Font Ligatures:支持三種狀態:
Auto:跟隨主題默認設置。On:開啓連字。Off:關閉連字。
安裝與啓用¶
該插件以 web 爲目標平臺。安裝後需要在 Web UI 中手動啓用。
- 從 npm 安裝:
dsh plugin --profile web add dsh-font-plugin
- 從 GitHub 安裝:
dsh plugin --profile web add github:wtksana/dsh-font-plugin
- 本地開發安裝:
dsh plugin --profile web add ./path/to/dsh-font-plugin
安裝完成後,啓動 dsh 時會自動計算客戶端包的修訂號。如果在本地修改了代碼,需要重啓 dsh。
典型用法¶
字體棧配置¶
字體名稱可以以逗號分隔的形式輸入(例如 MiSans, Microsoft YaHei, sans-serif)。名稱是否加引號均可,單個名稱會被系統自動添加引號和回退字體。
通過 UI 配置¶
- 在 DSH Web UI 中打開 Settings → Plugins。
- 找到 Plugin configuration。
- 展開
dsh-font-plugin卡片。 - 修改字段後點擊 Save。
通過 YAML 直接配置¶
也可以直接編輯 $DSH_HOME/settings.yaml 文件:
dsh-font:
editorFont: MiSans
codeFont: MiSans
ligatures: auto
保存行爲:保存操作會將你輸入的確切值寫入用戶層配置。即使該值等於官方默認值,只要字段存在,即被視爲一次覆蓋。點擊 Reset 會將該字段清除,使其回退到主題默認值。
適用場景與注意¶
- 權限與依賴:DSH 插件以當前進程權限運行。安裝前建議檢查源碼與許可證(本項目爲 MIT 許可證)。
- 字體粗細與大小:字體的粗細和大小由 DSH 0.1.2 及以上版本的官方主題設置(Appearance)提供,本插件僅負責字體族和連字,不干預粗細與大小。
- 本地化:界面文案通過官方
ctx.locale機制進行中英文本地化。 - 卸載:執行
dsh plugin remove dsh-font-plugin會同時移除插件包及其補丁層。
總結¶
該插件通過標準的 DSH 插件配置契約,爲 Web UI 提供了非侵入式的字體定製能力。開發者可以通過 UI 或 YAML 文件快速調整編輯器和代碼區域的顯示效果。