前言¶
做 DSH 智能體時，Web UI 裏會直接看到模型的可見 reasoning 和 final answer。如果希望把閱讀顯示切換爲另一種語言，但不想改動原始 session logs，就需要一個只作用在顯示層的翻譯插件。dsh-reasoning-translator 是 pinkllo 提供的 DeepSeek Harness 插件，定位爲“僅在 Web UI 中將可見推理和最終答案做顯示層翻譯”，支持 Chrome Translator 或 OpenAI-compatible API。
這是什麼¶
一句話：它不改寫 session logs，只翻譯 Web UI 中可見的 reasoning 和 final answer。維護者爲 pinkllo，許可證是 MIT。
它解決的是 Web UI 顯示語言問題：原文日誌仍按原樣保留，只在頁面上提供翻譯顯示。DSH 的插件生態強調“一切皆插件”，社區目錄頁可用來查找插件，但它不是官方應用商店，也不代表 DeepSeek 或幻方的官方背書。
核心功能¶
下面介紹它已覈實的能力。
- 僅翻譯 Web UI 中可見的
reasoning和final answer，不重寫 session logs。 - 支持 Chrome Translator / LanguageDetector 後端。要求桌面 Chrome 138+ 或較新 Edge；免費、本地設備運行、無需 API key。首次使用某個語言對時，可能下載 pack 並需要點擊。
- 支持 OpenAI-compatible API 後端。由 Host 進程調用 Settings 中配置的 endpoint；API key 可來自
TRANSLATION_OPENAI_API_KEY或OPENAI_API_KEY。 - 翻譯前檢測源語言，並跳過已經是目標語言的文本。
- 可翻譯
reasoning、final answer或兩者；可自動運行，也可按塊點擊Translate按鈕觸發。 - 偏好從
localStorage恢復，並同步到 Hostsettings.yaml的translation部分；兩份副本不一致時，最近編輯的一份優先。API key 不緩存在localStorage。 - Web settings RPC 不暴露 out-of-tree namespaces，插件使用自己的 same-origin route。
安裝與啓用¶
先安裝插件。若從 GitHub 源碼安裝，運行：
dsh plugin --profile web add github:pinkllo/dsh-reasoning-translator
如果本地已有倉庫目錄，也可以使用：
dsh plugin --profile web add /absolute/path/to/dsh-reasoning-translator
然後啓動 Web UI：
dsh web
如果你是從 deepseek-harness 的 checkout 裏啓動，也可以用：
pnpm dsh web
啓動後打開 Settings → Translation，進入翻譯設置。
典型用法¶
一個可直接復現的流程是先安裝，再啓動，再進入設置：
- 執行 GitHub 安裝命令：
dsh plugin --profile web add github:pinkllo/dsh-reasoning-translator
- 啓動 Web UI：
dsh web
- 打開
Settings → Translation。 - 如果使用 Chrome 內置後端，確認使用桌面 Chrome 138+ 或較新 Edge；首次使用某個語言對時，可能需要下載 pack 並完成一次點擊。
- 如果使用 OpenAI-compatible API 後端，在 Settings 中配置 endpoint、model、API key；API key 也可以通過
TRANSLATION_OPENAI_API_KEY或OPENAI_API_KEY提供。
關於 npm 安裝命令，README 中寫的是 once published，當前已覈實資料沒有確認 npm 包已發佈，因此不建議把它當作默認安裝路徑。
適用場景與注意¶
適合需要在 Web UI 中查看目標語言翻譯、但又想保留原始 session logs 的使用者。它也比較適合不想直接在瀏覽器端處理翻譯請求的情況：Chrome 內置後端在本地設備運行；OpenAI-compatible API 後端則由 Host 進程調用 Settings 中配置的 endpoint。
使用前注意：
- 它只作用於 Web UI，不會重寫 session logs。
- Chrome built-in 後端需要桌面 Chrome 138+ 或 recent Edge。Cursor 的內嵌瀏覽器可能缺少 Chrome on-device Translator；如果在該環境裏檢測不到相關能力，需要到桌面 Chrome 中複測。
- 插件會由當前
dsh進程加載並運行。安裝前應檢查源碼、依賴和許可證；本插件許可證爲 MIT。 - 如果要運行 README 中的純函數單元測試，需要 Node 22.6+。
結尾¶
dsh-reasoning-translator 的價值比較明確：把“顯示層翻譯”限定在 Web UI 的可見 reasoning 和 final answer 上，不碰 session logs，並提供 Chrome Translator 與 OpenAI-compatible API 兩種後端。
相關鏈接：
- GitHub：https://github.com/pinkllo/dsh-reasoning-translator
- 目錄頁：https://www.skillhub.cn/plugins/pinkllo/dsh-reasoning-translator
