DeepSeek Harness (DSH) 提供了智能體開發的命令行環境,其 Web UI 的默認字體在處理中英文混排或代碼展示時,可能無法滿足所有開發者的閱讀習慣。dsh-custom-fonts 插件通過注入全局樣式,允許在不重啓進程的情況下,直接在設置頁調整界面字體、代碼字體及全局字號。
插件定位¶
這是一個由維護者 lsh2002 開發的純客戶端插件。安裝後,DSH 的 Web 界面設置中會新增一個“Fonts (字體)”頁面,提供中/英 UI 字體、代碼字體及字號偏移的配置項,所有修改即刻生效且無需重啓。
核心功能¶
- 設置入口:在 Settings 下新增 Fonts 頁面,提供可視化的配置界面。
- 字體定製:
- UI 字體 · English:用於拉丁字符。
- UI 字體 · Chinese:用於漢字。
- Code font:用於代碼塊和行內代碼。
- 字號偏移:提供 -4 到 +8 px 的全局滑塊。該插件通過相對計算(
calc(1em + Npx))確保內核文本保持清晰,且不會導致頁面佈局崩壞。 - 實時預覽:在設置頁即可查看中英文混排 UI 示例及代碼字體渲染效果,支持逗號分隔的字體列表或自由名稱。
- 重置:一鍵清除所有注入樣式,恢復默認。
安裝與啓用¶
通過 DSH 的插件命令行安裝,安裝後刷新頁面即可激活,無需重啓主機。
dsh plugin --profile web add dsh-custom-fonts
或直接從倉庫安裝:
dsh plugin --profile web add github:lsh2002/dsh-custom-fonts
工作原理¶
插件通過注入一個全局 CSS 樣式表來實現字體與字號的控制。
字體棧採用標準腳本分離策略:英文字符優先匹配指定的英文字體,而英文字體中不包含的漢字會自動回退到指定的中文字體,無需複雜的 DOM 邏輯或語言檢測。
字號偏移通過 calc(1em + Npx) 相對計算,即每個元素在其自身大小基礎上增加 N 像素,這使得多級嵌套元素的尺寸變化保持一致且精確。
修改會立即全局應用,覆蓋消息體、側邊欄、輸入框等所有區域。
注意事項¶
- 這是一個純客戶端插件,不包含主機端邏輯。
- 修改會直接覆蓋瀏覽器渲染的默認字體,建議在調整前記錄默認配置以便重置。
- 代碼字體與 UI 字體獨立配置,可分別選擇適合的等寬字體。
總結¶
dsh-custom-fonts 解決了 DSH Web UI 字體配置不靈活的問題。通過客戶端樣式注入,它提供了一種低侵入、零重啓的方案,讓開發者可以根據個人偏好或特定場景(如代碼開發)定製界面的視覺體驗。
- GitHub 倉庫: https://github.com/lsh2002/dsh-custom-fonts