前言¶
DeepSeek Harness（DSH）的網頁界面由多個界面插件組成，不同區域的文字樣式可能來自不同的插件。對看小字費勁的使用者來說，單純調大頁面並不總是夠用，也需要單獨調整某個區域。
dsh-ui-font 是一個 DSH 社區插件，用來給 DSH 網頁界面換字體、調字號。它把字體、字號、區域偏移和快捷鍵設置放到同一個設置入口裏，並在運行時自動發現 DSH 界面插件的樣式和描述，不捆綁字體文件。
倉庫地址：https://github.com/warmwine/dsh-ui-font
許可證：MIT
這是什麼¶
dsh-ui-font 是一個面向 DSH Web GUI 的字體與字號設置插件。
它主要解決三類問題：
- 想把普通文字或代碼區域換成自己系統裏已安裝的字體；
- 想整體調大 DSH 網頁界面字號；
- 某個區域太大或太小時，希望只調那個區域，不影響其他區域。
核心功能¶
字體選擇¶
插件支持從系統已安裝字體中分別選擇普通文字字體和代碼字體。
全局字號¶
全局字號由一個滑桿控制，範圍是 -3 到 +20 像素，拖動後立即生效。
準星選取¶
設置頁提供「選取區域」入口，也可以使用自定義快捷鍵召喚紅色準星。移動鼠標選中目標區域後，點擊 − 或 + 即可調整該區域字號。
準星選取會根據字號聲明點選擇調整方式：
- 如果目標文字由設計令牌定義，則按設計令牌調整；
- 如果目標文字來自單條 CSS 規則，則按該規則調整；
- 否則進入全局偏移。
區域微調¶
插件提供「按界面區域微調」列表，可以對單個插件區域單獨調整。
某個區域的最終效果是該區域的個體偏移與全局偏移疊加後的結果。
快捷鍵¶
插件提供三個可自由錄製的快捷鍵槽位：
- UI 捕捉；
- 字號放大；
- 字號縮小。
錄製快捷鍵時，組合鍵需包含 Ctrl、Alt 或 Meta 之一。正常使用時建議先關閉設置面板，再按下快捷鍵。
設置持久化¶
設置會寫入 DSH 服務端 settings.yaml。在離線或舊版本場景下，插件會使用 localStorage 回退。
早期版本（< 0.9.3）使用 localStorage 鍵名 dsh.uiFont.v1；升級後首次打開 Web GUI 時，會把該值遷移到服務端。插件每次寫設置會同時落到 settings.yaml 和 localStorage，服務恢復後以服務端爲準。
安裝與啓用¶
安裝遠程倉庫版本：
dsh plugin --profile web add github:warmwine/dsh-ui-font
本地開發時可以從倉庫路徑安裝：
dsh plugin --profile web add link:<本倉庫路徑>
安裝或卸載後，需要重啓 dsh web。
卸載命令：
dsh plugin --profile web remove dsh-ui-font
典型用法¶
下面是一個常規操作順序：
1、安裝插件並重啓 dsh web。
2、打開 DSH 設置頁，進入字體相關設置。
3、先用全局滑桿調整整體字號。
4、如果某個區域仍不滿意，點「選取區域」或按已錄製的 UI 捕捉快捷鍵，召喚紅色準星。
5、將準星移到目標區域，點擊 − 或 + 調整。
6、在「按界面區域微調」列表中單獨調整對應插件區域。
7、如果需要快捷操作，在設置頁爲 UI 捕捉、字號放大、字號縮小錄製快捷鍵。
技術邊界¶
宿主半邊使用 Node 內置模塊；瀏覽器半邊依賴平臺提供的 react，package.json 中聲明的 peerDependencies 爲：
"react": "^18.2.0"
插件不捆綁字體文件，並在運行時自動發現 DSH 界面插件的樣式和描述。
注意與邊界¶
dsh-ssh的 xterm 網頁終端使用內置字體，不參與縮放。- 換膚插件（qq98 之類）激活時會接管字體變量，最終以皮膚爲準。
- 網頁預覽面板裏 iframe 渲染的內容不是本頁元素，準星選不到。
- 設置面板本身會擋住後面的界面，正常用法是關閉設置面板後再按快捷鍵。
- 焦點在文件預覽等 iframe 中時，按鍵可能無法到達主頁面；點一下主界面後再按即可。
- 卸載插件後，
ui-font設置 key 會留在settings.yaml中，需要手動刪除。
適用場景¶
這個插件適合以下情況：
- 希望在 DSH Web 界面中換成自己系統裏已安裝的字體；
- 希望整體調大 DSH 網頁界面字號；
- 需要單獨調整某個插件區域，而不是讓整個頁面一起變化；
- 希望通過快捷鍵快速放大或縮小字號，而不是每次都打開設置頁。
DSH 插件會在當前 DSH 運行環境中執行。安裝前建議檢查倉庫源碼和 MIT 許可證，並確認插件行爲符合當前使用場景。
結尾¶
dsh-ui-font 把 DSH Web 界面的字體、字號、區域偏移和快捷鍵放到一組可配置項裏，並用準星選取降低“不知道改哪個設置”的成本。它的設置落在 DSH 服務端 settings.yaml，也保留離線與舊版本場景下的 localStorage 回退路徑。
GitHub：https://github.com/warmwine/dsh-ui-font
