在使用 DeepSeek Harness(DSH)進行開發或交互時,如果界面語言是中文,查看搜索結果、會話標題或插件文本時可能需要頻繁切換翻譯工具。Chrome 的自動翻譯雖然方便,但會全局影響頁面體驗且隱私風險較高。dsh-ui-translate 插件旨在解決這一問題,它能在不啓用瀏覽器自動翻譯的情況下,僅對可見的中文 UI 和內容進行本地翻譯。
核心功能¶
該插件由 RadicalGitter 維護,提供以下能力:
- 多後端支持:支持三種翻譯模式。默認使用離線詞彙表;可選“瀏覽器本地 OPUS-MT”,在首次使用時會從 Hugging Face 下載約 110MB 的模型並緩存,在瀏覽器 Worker 中進行本地推理;也可選擇 OpenAI 兼容接口。
- 隱私保護:在“瀏覽器本地 OPUS-MT”模式下,源文本和譯文完全停留在瀏覽器本地,不會上傳到任何服務器。
- 可視化交互:翻譯後的文本會通過自定義標記顯示。默認爲紫色覆蓋層,也可配置爲虛線下劃線或兩者兼有。鼠標懸停約 0.65 秒後,會暴露“顯示原文”或“重新翻譯”的操作。
- 內容保護:插件會自動識別並跳過可編輯字段(如輸入框、下拉菜單)、代碼塊以及帶有
translate="no"屬性的元素,避免破壞已輸入內容或可執行代碼。
安裝與啓用¶
安裝該插件需要使用官方提供的命令。安裝後,插件默認處於關閉狀態,需在設置中手動開啓。
dsh plugin --profile web add dsh-ui-translate
配置與用法¶
在 DSH 的設置頁面中,你可以配置目標語言、後端選擇、標記樣式等參數。也可以通過 Cordis 補丁進行配置,例如指定 OpenAI 兼容端點或模型:
- id: ui-translate
config:
enabled: true
sourceLanguage: zh
targetLanguage: en
backend: openai-compatible
markerStyle: overlay
endpoint: http://127.0.0.1:11434/v1
model: qwen2.5:7b
allowRemoteEndpoint: false
對於動態掛載的插件文本,如果需要翻譯特定的只讀內容(如注入的上下文摘要),可以在對應的 HTML 元素上添加屬性進行選擇加入:
<pre data-dsh-translate="prose">可供用戶閱讀的注入上下文</pre>
適用場景與注意¶
該插件適合需要在 DSH Web 界面中查看中文內容但需要英文對照的開發者。插件僅修改 Text.data,不影響 DOM 結構、屬性、ID、鏈接或監聽器。請確保在安裝前檢查源碼與許可證(MIT)。
更多細節可查閱插件目錄:https://www.skillhub.cn/plugins/RadicalGitter/dsh-ui-translate
源碼地址:https://github.com/RadicalGitter/dsh-ui-translate