---

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