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 仓库
• 插件目录页