前言¶
DeepSeek Harness（DSH）的生態裏，很多社區插件直接寫死中文菜單、設置項和說明，並不附帶英文 locale 文件。若你習慣用英文 Web UI 開發或調試智能體，界面會中英混雜，讀設置和點菜單都要多掃一眼。
常見做法是等作者補 i18n，或自己 fork 改文案。dsh-auto-i18n 走另一條路：在瀏覽器裏對已渲染的界面文本做就地翻譯，不依賴插件是否提供語言包。下面介紹它是什麼、怎麼裝、怎麼用，以及翻譯範圍與限制。
這是什麼¶
dsh-auto-i18n 由維護者 x01Jin 發佈，分類爲客戶端插件。一句話定位：在使用 DSH Web UI 時，把已安裝插件界面上的中文按鈕、標籤、菜單等翻成英文。
插件託管於 GitHub：x01Jin/dsh-auto-i18n。社區目錄頁（與 DeepSeek / 幻方無官方從屬關係的獨立站點）見 SkillHub 條目。當前 package 版本爲 0.1.0，許可證 MIT。
核心功能¶
根據 README 與 package.json，已覈實能力如下。
就地翻譯界面文案¶
覆蓋按鈕、標籤、菜單項、設置行、對話框、工具提示、佔位符、卡片文字，以及插件市場與插件管理器裏的短說明。對硬編碼中文字符串同樣有效，不限於帶 locale 文件的插件。
有意跳過的區域¶
爲保護代碼與長文檔，以下不會翻譯：
pre、code、kbd內的內容；- 文本域與
contenteditable編輯器； - Markdown 渲染區（含聊天消息、插件 README 正文），避免流式輸出被半截翻譯；
- CodeMirror、Monaco 編輯器內容。
動態頁面與緩存¶
客戶端掃描 DOM，批量（最多 24 條）提交宿主路由；宿主經捆綁的 @deepseek-ai/dsh-experimental-translator 調用 Google，失敗時回退 Bing，並在 $DSH_HOME/auto-i18n-cache.json（默認 ~/.dsh/auto-i18n-cache.json）持久化緩存。瀏覽器側也有緩存，下次加載可少發請求。MutationObserver 處理後續插入的節點；React 重渲染可能覆蓋譯文時，會從緩存再應用。
隱私說明（作者聲明）¶
待翻譯文本經 Harness 翻譯服務訪問 Google / Bing 的匿名翻譯端點，無需 API Key 或賬號；結果僅本地緩存，作者稱無其他存儲或上報。
安裝與啓用¶
安裝方式來自官方 README：通過 Harness 插件管理器以 bundle 安裝本目錄，可在 Plugins 頁面操作，或使用 plugin_manager 工具的 install_bundle。插件市場也支持 GitHub 源，指向：
https://github.com/x01Jin/dsh-auto-i18n
bundle 會掛載隨包提供的翻譯服務 @deepseek-ai/dsh-experimental-translator，無需單獨再裝該服務。
環境要求（資料原文）：
- DeepSeek Harness 0.2.1-rc.5 或更新，且使用 Web UI；
- Node.js 22.19+ 或 24+（與 Desktop 捆綁運行時一致）；
- 能訪問翻譯服務端點。
插件以當前 DSH 進程權限運行；安裝前請自行查看倉庫源碼與 MIT 許可證，確認可接受網絡翻譯與緩存行爲。
典型用法¶
- 按上文方式安裝 bundle 並確保 Web UI 可用。
- 打開 Settings，進入 General，找到 Auto translate 開關。
- 默認開啓翻譯；關閉開關會恢復原文且無需刷新頁面；選擇保存在瀏覽器
localStorage。
開發時若改本地副本，README 建議安裝前先檢查語法：
node --check index.js
node --check client.js
將工作目錄作爲 bundle 安裝後刷新頁面；僅改 client.js 需刷新頁面，改宿主側 index.js 需重新安裝插件或重啓應用。
適用場景與注意¶
適合：主要用英文讀 DSH Web UI，但裝了大量中文界面的第三方插件；不想等作者補 locale，又只需要界面可讀而非專業譯稿。
限制（README 原文）：
- 機器翻譯缺少上下文，短標籤通常清楚，長句可能生硬；
- 每個唯一字符串首次出現時各請求一次，中文標籤多的頁面可能需要數秒才穩定；
- Google 與 Bing 均失敗時，該會話內相關字符串保持中文；
- 僅作用於 Web UI，不覆蓋 CLI 或其他界面。
實現結構（便於排查）¶
| 文件 | 作用 |
|---|---|
index.js |
宿主側：翻譯路由、調用提供商、磁盤緩存 |
client.js |
DOM 掃描、分批、瀏覽器緩存、設置項 |
cordis.patch.yml |
插入翻譯服務行與插件行 |
結尾¶
dsh-auto-i18n 用客戶端掃描 + 宿主翻譯 + 雙層緩存，把社區插件裏常見的中文 UI 在瀏覽器裏翻成英文，並用設置開關控制，默認開啓。若你正在擴展 DSH 插件或日常在 Web UI 裏調智能體，可先裝 bundle，在 General 裏確認 Auto translate 是否符合預期。
- 目錄頁：https://www.skillhub.cn/plugins/x01Jin/dsh-auto-i18n
- 倉庫：https://github.com/x01Jin/dsh-auto-i18n
