前言¶

在 DSH Web GUI 裏閱讀對話、側欄或輸入框時，常遇到需要臨時翻譯的句子。已有做法可能依賴外部翻譯接口或額外 API key，配置和維護成本更高。dsh-translator 針對這個場景，提供有道風格的劃詞翻譯：在界面中劃選文本，點擊懸浮按鈕，由當前 DSH 已配置的模型管線生成譯文。它不要求單獨配置 API key，也不調用第三方端點。

DSH 的插件生態強調“一切皆插件”。這裏的社區目錄是獨立站點，不是官方應用商店，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

dsh-translator 是一個 DSH 插件，用於在 Web 客戶端中做劃詞翻譯。npm 包名爲 @nicearrack/dsh-translator，GitHub 倉庫爲 nicearrack/dsh-translator，由 nicearrack 維護，MIT 許可。

它解決的是“在 DSH 界面任意位置劃詞後快速獲得譯文”的問題。譯文由 harness 的 LLM 產生，使用你已配置的模型管線，不引入額外 API key 或第三方端點。

核心功能¶

• 劃詞觸發：在應用內任意位置劃選文本，懸浮 translate 按鈕會跟隨選區出現，適配淺色/深色主題。
• 自動方向：配置的主語言文本會翻譯成 English；其他文本會翻譯成主語言。
• 主語言可配：支持 簡體中文 / 繁體中文 / 日本語 / 한국어 / Русский，默認 簡體中文。
• 設置卡片：在 DSH 設置 Settings → Plugins → 劃詞翻譯 中可配置主語言、模型、reasoning effort、timeout、max tokens、temperature。每個字段可顯示 overridden / restore default，並支持暫存修改、保存/丟棄。
• 翻譯卡片：顯示原文、方向標記、譯文，失敗時可重試；頁腳顯示 model · reasoning effort · tokens。
• 點擊複製：可點擊譯文、原文或錯誤信息複製，並顯示 已複製 / Copied 提示。
• 可拖拽：拖動卡片頭部即可移動位置，卡片會保留在你放置的位置。
• 可固定：固定後鎖定拖動、Esc 和點擊外部關閉，直到你主動關閉；同一時間只保留一張卡片，不支持嵌套。
• 流式穩健：可處理 live streaming 輸出，避免閃爍；內容滾動時卡片位置保持不動。

安裝與啓用¶

從 npm 安裝：

dsh plugin --profile web add @nicearrack/dsh-translator@latest

安裝後，在 DSH 設置中進入 Settings → Plugins → 劃詞翻譯，按需選擇主語言、模型和推理強度。模型可以留空，以跟隨會話默認。

典型用法¶

1、劃選文本。

2、點擊選區附近的懸浮 translate 按鈕。

3、在翻譯卡片中查看譯文、方向和頁腳信息。

4、拖動卡片頭部調整位置，或固定卡片避免誤觸。

5、點擊譯文、原文或錯誤信息完成複製。

配置項¶

在 Settings → Plugins → 劃詞翻譯 中可設置：

每個字段都支持 overridden / restore default 的顯示與恢復，並可用暫存方式編輯後保存或丟棄。

更新、卸載與注意¶

更新後重啓 DSH 實例，使新的 host bundle 加載：

dsh --profile web

客戶端 bundle 會在下次頁面刷新時更新。

卸載後同樣需要重啓實例：

dsh --profile web

通過 Git 安裝會運行包的 prepare build script。如果首次安裝被拒絕，且使用 pnpm ≥ 10，可一次性授權構建腳本：在 profile 的 pnpm-workspace.yaml 中加入：

allowBuilds:
  "@nicearrack/dsh-translator": true

npm registry 元數據在發佈後可能滯後。若 @latest 仍解析到舊版本，可改用精確版本。

插件以當前 DSH 進程權限運行，使用前應檢查源碼與 MIT 許可證。它適合希望在 DSH Web GUI 中劃詞獲取譯文、且希望譯文始終來自當前模型管線的開發者。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/nicearrack/dsh-translator
• GitHub：https://github.com/nicearrack/dsh-translator