双栏翻译工作台SiYue-ZO/dsh-translator

DSH Translator

把 DeepSeek Harness 变成一款真正顺手的 AI 翻译软件。

DeepSeek Harness
CI
License

English · 安装 · 功能 · 架构

DSH Translator 是一个原生 DeepSeek Harness 插件。它不再只是给聊天框加一段“翻译提示词”，而是直接提供双栏翻译工作台：选择语言、粘贴原文、观看译文流式生成，再复制、朗读、下载或放进历史记录。

它不绑定额外的翻译 API。翻译由你在 dsh 中选择的模型完成，继续沿用现有模型、凭据、会话和流式传输。

当前版本面向 dsh 0.1.0-rc.6 Web profile。

功能

- 原生双栏编辑器和响应式移动端布局
- 自动识别源语言，内置 12 种常用语言，支持一键互换
- 译文逐字流式显示，可随时停止并保留已生成内容
- 自然、专业、学术、技术、直译五种风格
- 仅译文、双语对照两种输出模式
- 原文字符/词数统计，Ctrl / ⌘ + Enter 快捷翻译
- 剪贴板粘贴与复制、浏览器朗读、.txt 下载
- 导入文本、Markdown、CSV、JSON、HTML 和 XML（最大 2 MB）
- 最近 100 条本地历史，支持搜索、恢复和单条删除
- 保留 Markdown、表格、HTML/XML 标签、链接和占位符
- 可编辑术语表和单次翻译附加要求
- 完成后自动复制选项
- 将原文 JSON 编码为不可信数据，降低原文中“指令”干扰翻译的风险
- 零额外运行时服务、零额外 API Key

安装

dsh 目前处于开发者预览。请使用 Node.js 22.19+ 或 24+，并确保 dsh 与 pnpm 可用。

将插件安装进官方 web profile：

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

打开终端中显示的地址（默认 http://127.0.0.1:3080），创建一个会话，即会看到翻译工作台。

也可以从本地 checkout 安装：

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

卸载：

dsh plugin --profile web remove dsh-translator

使用

选择源语言和目标语言，粘贴原文，点击“开始翻译”。生成期间按钮会变成“停止翻译”。

DeepSeek Harness uses an architecture where everything is a plugin.

更多操作：

- 点击中间的互换按钮可交换语言与两侧内容。
- 设置面板中可调整风格、双语对照、格式保留、术语表和附加要求。
- 原文工具栏支持粘贴、导入和清空；译文工具栏支持朗读、下载和复制。
- 历史记录仅保存在当前浏览器的 localStorage，不会上传到第三方历史服务。

浏览器设置会记住你上次选择。Host 配置仍是翻译人格的回退值，也支持没有客户端界面的 dsh 使用方式。

配置

插件的默认配置位于 cordis.patch.yml。dsh 的后置 patch 可以按相同 id 覆盖整份配置。注意：dsh 对插件行的 config 是整体替换而非深度合并，因此覆盖时请写全所有字段。

例如，新建 translator.override.yml：

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

临时启动并应用：

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

| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| sourceLanguage | auto | 源语言名称；auto 自动识别 |
| targetLanguage | Simplified Chinese | 默认目标语言 |
| style | natural | natural / professional / academic / technical / literal |
| outputMode | target-only | target-only 或 bilingual |
| preserveFormatting | true | 尽可能保留标记与排版 |
| translateCodeComments | false | 是否翻译注释和 docstring |
| glossary | {} | 源术语到目标术语的固定映射 |
| customInstructions | '' | 附加翻译规则 |
| includeRuntimeContext | false | 是否把工作区等动态上下文交给翻译模型 |

架构

插件遵循 dsh/Cordis 的原生生命周期：

dsh-translator
/              \
Host / src/index.ts     Web / src/client/
│                       │
完整翻译 persona          原生 conversation slot
│                       │
└──── dsh Session ──────┘
│
当前模型与凭据

Host 侧用 complete: true 安装完整翻译 persona，避免编码 Agent 身份和工具说明干扰翻译；Web 侧通过 dsh 的 conversation slot 提供产品界面，并调用原生 SessionFace.prompt/cancel，所以仍然享有 dsh 的流式输出和模型配置。

每次翻译的语言、风格、术语和排版会生成独立请求。原文存放在 JSON 字符串值中并明确标记为不可信内容，模型不应执行其中的命令。历史与界面偏好只保存在浏览器本地。

项目结构

.
├── src/
│   ├── index.ts          # Cordis 插件、配置 schema、生命周期
│   ├── prompt.ts         # 完整翻译 persona
│   ├── request.ts        # 单次翻译请求与术语表解析
│   └── client/           # React 工作台与 CSS Modules
├── test/                 # Node.js 单元测试
├── lib/                  # Host JS、浏览器 bundle 与类型声明
├── cordis.patch.yml      # dsh bundle 配置层
├── package.json          # npm 与 dsh bundle manifest
├── tsdown.config.ts      # dsh 客户端闭包 bundle
└── .github/workflows/    # 持续集成

开发

npm install
npm run check
npm pack --dry-run

npm run build 同时编译 Host 入口、客户端类型和 lib/client.js；npm test 覆盖 persona、请求隔离、术语表解析和 Cordis 挂载。客户端 bundle 遵循 dsh 的 window.__ModuleLoader__ 闭包协议，并将样式作为插件自有 CSS Module 注入。

限制

- 翻译质量、上下文长度和支持语言取决于当前选择的模型。
- 这是文本与纯文本文件翻译工作台；暂不解析 PDF、DOCX、图片或音频。
- 历史记录为浏览器本地数据，清除站点存储后无法恢复。
- dsh 仍处于开发者预览，未来的破坏性 API 变更可能需要插件同步升级。

License

MIT © 2026 SiYue-ZO