前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在 Web UI 的使用場景中,語言支持直接影響調試效率。默認僅支持中文和英文,對於需要繁體中文或非母語開發者來說,存在閱讀障礙。下面介紹 dsh-multi-lang-ui 插件,它通過客戶端注入的方式,爲 Web UI 添加了多語言選項。
插件簡介¶
該插件由 asd13006 維護,開源協議爲 MIT。它是一個純客戶端插件,不修改上游代碼,通過覆蓋語言翻譯邏輯和 DOM 節點轉換,實現多語言支持。
核心功能¶
插件在“設置 → 通用 → 語言”菜單中新增了 6 種語言:繁體中文、日本語、한국어、Français、Deutsch、Español。
- 手譯文本
每種語言都包含逐字符串翻譯的官方詞典(基於英文基線),確保 UI 關鍵信息準確顯示。 - 自動回退機制
對於新增或第三方插件引入的未翻譯字符串,插件會根據語言策略自動回退:- 繁體中文:通過內置的簡體到繁體字符表(720+ 字符)在運行時轉換。
- 其他語言:回退到英文。
- DOM 級轉換
在繁體中文模式下,插件使用MutationObserver監聽 DOM 變化,將非詞典內容(如插件市場描述)從簡體轉換爲繁體。輸入框、代碼塊和用戶內容始終被排除,僅做只讀顯示轉換。 - 持久化
語言偏好存儲在瀏覽器的localStorage中,刷新頁面後依然保留。 - 零入侵與零供應鏈風險
插件不包含任何網絡請求、遙測或數據收集。依賴項爲空,安裝過程不引入新的第三方代碼。
安裝與配置¶
安裝插件需要使用 dsh 命令行工具。
- 安裝
在終端中執行以下命令,將插件添加到 Web 配置文件:
dsh plugin --profile web add https://github.com/asd13006/dsh-multi-lang-ui
- 啓用
安裝完成後,必須重啓dsh web進程才能生效:
dsh web
- 選擇語言
在瀏覽器打開的 Web UI 中,進入“設置 → 通用 → 語言”,從下拉列表中選擇目標語言。 - 卸載
如需移除插件,請使用remove命令,避免手動刪除文件導致引用殘留:
dsh plugin --profile web remove dsh-multi-lang-ui
注意事項¶
- 字符映射限制
簡體到繁體的一對多字符映射(例如“復”字在不同語境下對應不同的繁體字)目前使用單一映射(如“復”)。雖然核心 UI 字典已覆蓋,但在部分新增字符串中可能出現轉換不完美的情況。 - 存儲位置
語言設置僅存儲在當前瀏覽器的localStorage中,不跨設備同步。 - 安全特性
插件不會訪問敏感數據(如憑證、Token),也不會修改文件系統。所有轉換僅針對 DOM 中的文本節點。
結語¶
dsh-multi-lang-ui 解決了 DSH Web UI 在多語言環境下的顯示問題,通過“手譯 + 自動回退”的模式,平衡了翻譯準確性和維護成本。適合需要使用繁體中文或非英語環境進行調試的開發者。
目錄頁: dsh-multi-lang-ui - SkillHub
源碼: https://github.com/asd13006/dsh-multi-lang-ui