前言¶
DeepSeek Harness（DSH）的 Web GUI 默認爲英文界面。對於習慣使用巴西葡萄牙語的開發者，閱讀英文界面會增加認知負擔。DSH 採用插件化架構，允許通過第三方插件擴展功能。grstein/dsh-locale-ptbr 就是這樣一個插件，它爲 DSH 的 Web GUI 提供巴西葡萄牙語語言包，在不修改 Harness 源碼的情況下實現界面本地化。
插件定位¶
這是一個由用戶 grstein 維護的開源插件（MIT 許可證），旨在覆蓋 DSH Web 界面中的特定文本。
核心功能¶
- 添加巴西葡萄牙語語言包。
- 實時翻譯 Web GUI 界面。
- 覆蓋 33 個命名空間和 1,029 個鍵，包括對話、軌跡、工具卡片、工作區、配置、審批、任務、子代理和命令。
- 支持配置文件（通過
--profile web或dsh web命令使用）。 - 自動回退到英語（如果未翻譯的鍵）。
- 包含通過
npm test進行的一致性檢查。
安裝與啓用¶
使用 dsh plugin 命令安裝。該命令會將操作轉發給 profile 目錄下的 pnpm，因此支持 github:、本地路徑或內部 registry。
dsh plugin --profile web add github:grstein/dsh-locale-ptbr
安裝後，進入 GUI 的「配置」→「常規」→「語言」選項即可選擇「Português (Brasil)」。
典型用法¶
安裝後，可以通過以下方式啓用或管理：
# 啓用插件後，檢查配置層是否包含該插件
dsh --profile web --dump-config
# 啓動 Web 服務
dsh web
如需移除：
dsh plugin --profile web remove @grstein/dsh-locale-ptbr
適用場景與限制¶
適用場景：主要面向習慣使用巴西葡萄牙語的 DSH 用戶。
限制：
1. 不修改 Harness 代碼：插件僅通過運行時注入實現翻譯，不修改 DSH 源碼。
2. 翻譯範圍：僅翻譯 GUI 產品副本。不翻譯模型輸出、終端輸出、文檔、引導畫面或註冊表中的原始文本。
3. 環境依賴：構建和測試依賴 Node.js 環境。
4. 回退機制：未翻譯的鍵會自動顯示爲英文，不會顯示原始鍵名。
維護與同步¶
該插件維護了 dicts/<ns>.json 作爲翻譯源。開發者可以使用 npm run build 重新生成客戶端代碼，並使用 npm test 驗證鍵值一致性。
隨着官方 Harness 版本更新，可能引入新的鍵或修改現有鍵。該插件提供 tools/sync.mjs 腳本，用於比對官方 Harness 代碼並生成更新報告。若需跟進版本，可使用 --apply 參數應用更新。
生態背景¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。本插件並非官方維護，而是社區生態的一部分。相關插件信息可參考 SkillHub。
