dsh-translator：把 DeepSeek Harness 變成一款真正順手的 AI 翻譯軟件

前言¶

DeepSeek Harness（DSH）的核心哲學是“一切皆插件”。在原生插件生態中，開發者往往需要手動爲模型編寫翻譯提示詞，或者在聊天框中反覆粘貼文本。這降低了翻譯的效率，也難以管理批量翻譯任務。

dsh-translator 是一個原生插件，它直接將 DSH 的 Web profile 轉換爲一個雙欄翻譯工作臺。它不依賴額外的翻譯 API 或運行時服務，直接調用你在 DSH 中配置的模型和憑據進行流式翻譯。對於需要頻繁進行文本或文檔本地化的開發者，這提供了一個輕量、可控的解決方案。

核心功能¶

該插件主要提供以下能力：

• 原生工作臺：提供雙欄編輯器和響應式佈局，支持移動端操作。
• 流式翻譯與控制：譯文逐字顯示，支持中途停止並保留已生成內容。
• 輸出模式：支持“僅譯文”和“雙語對照”兩種模式。
• 風格與語言：內置 12 種常用語言，支持自動識別源語言。提供自然、專業、學術、技術、直譯五種風格。
• 格式保留：支持保留 Markdown、表格、HTML/XML 標籤、鏈接和佔位符。
• 導入與導出：支持導入文本、Markdown、CSV、JSON、HTML 和 XML 文件（最大 2 MB）。支持導出爲 .txt 並進行瀏覽器朗讀。
• 術語表與自定義：可編輯術語表，並在單次翻譯中附加自定義指令。
• 安全處理：將原文 JSON 編碼爲不可信數據，防止模型執行原文中的指令。
• 歷史記錄：本地保存最近 100 條翻譯記錄，支持搜索、恢復和刪除。
• 快捷與統計：支持 Ctrl / ⌘ + Enter 快捷翻譯，提供原文字符/詞數統計。

安裝與啓用¶

在使用前，請確保你的環境滿足要求：需要使用 Node.js 22.19+ 或 24+。

安裝插件進入官方 web profile：

dsh plugin --profile web add github:SiYue-ZO/dsh-translator
dsh web

打開終端顯示的地址（默認 http://127.0.0.1:3080），創建一個會話即可看到翻譯工作臺。

如果需要從本地安裝，可以先克隆倉庫並安裝依賴：

git clone https://github.com/SiYue-ZO/dsh-translator.git
cd dsh-translator
npm install
dsh plugin --profile web add .

卸載命令如下：

dsh plugin --profile web remove dsh-translator

典型用法¶

1. 選擇語言：在界面中選擇源語言（支持自動識別）和目標語言。點擊中間的互換按鈕可交換兩側內容。
2. 輸入文本：直接粘貼文本，或點擊原文工具欄的“導入”按鈕選擇文件。
3. 調整設置：在設置面板中選擇風格（如 professional）、輸出模式（如 bilingual）和格式保留選項。
4. 執行翻譯：點擊“開始翻譯”按鈕，譯文將流式顯示。翻譯過程中可點擊“停止”。
5. 導出結果：翻譯完成後，使用譯文工具欄進行復制、朗讀或下載。

配置¶

插件的默認配置位於 cordis.patch.yml。你可以創建一個覆蓋文件來修改默認行爲。

例如，創建 translator.override.yml：

- id: translator
  config:
    sourceLanguage: auto
    targetLanguage: Japanese
    style: professional
    outputMode: bilingual
    preserveFormatting: true
    glossary:
      DeepSeek Harness: DeepSeek Harness
      agent: エージェント
    customInstructions: 'Japanese punctuation must use the full-width style.'

使用該配置臨時啓動：

dsh --profile web --patch ./translator.override.yml

常用配置項說明如下：

適用場景與注意¶

適用場景：該插件適合處理文本、Markdown 文件、代碼片段的翻譯。對於需要格式保留和雙語對照的技術文檔翻譯尤爲方便。

注意事項：
* 依賴模型：翻譯質量、上下文長度和支持的語言取決於當前 DSH 中選擇的模型。
* 文件格式：目前僅支持文本與純文本文件，暫不支持解析 PDF、DOCX、圖片或音頻。
* 歷史記錄：歷史記錄僅保存在瀏覽器本地，清除站點存儲後無法恢復。
* 開發狀態：DSH 仍處於開發者預覽階段，未來的破壞性 API 變更可能需要插件同步升級。
* 權限：插件以當前 dsh 進程的權限運行，安裝前建議檢查源碼與許可證。

結語¶

dsh-translator 通過原生插件的形式，填補了 DSH 在本地化工作流中的空白。它利用現有的模型能力，提供了零額外開銷的翻譯環境，適合追求效率和隱私的開發者。

• GitHub 倉庫
• 插件目錄頁