dsh-translation-plugin

DeepSeek Harness 翻译插件

简体中文 | English

和主模型讨论翻译，把要求和意见落实到译文中。

你可以直接在主聊天提出要求、表达意见，与主模型讨论用词、语气和风格，再让它将讨论结果整理成要求，交给翻译模型继续翻译或润色。

比如“这句太机械了”“这个人物的语气要克制一点”：带着原稿和已有译文讨论，按商定方向生成新版本，再对比、修改和定稿。初译到定稿都在同一个工作区，适合小说、游戏剧本和学术材料等需要反复推敲的翻译项目，也便于在讨论中学习。

为什么选择它 · 安装与更新 · 中文使用指南 · 项目与文档

为什么选择它

• 【交流讨论】直接提出要求，一起推敲用词和风格。 围绕具体原稿或译文，与主模型讨论准确性、语气、节奏和角色口吻，比较不同表达，也可以追问某种译法的理由。
• 【意见落实】把讨论结果用于下一版译文。 主模型整理你的背景、要求和修改意见，交给翻译模型执行；你可以针对指定单元反复提出反馈、发起修订，逐步贴近想要的表达，无需手动复制和传话。
• 【译文对比】多试几种表达，定稿由你掌握。 原稿和历次译文保留在同一单元，可以回看、比较和继续修改，最终选定满意的版本，让每一轮尝试有据可查。
• 【记忆资产】把确认后的用词和要求留给后续翻译。 将术语、人物设定、文风要求和参考资料整理在同一主题，供后续章节与会话继续参考，减少重复交代背景。
• 【持续工作】主聊天不影响继续打磨已保存的译文。 历史和主题资料在本机自动保存，换主聊天或重启 DSH 后可继续处理已有材料；沿用 DSH 的模型配置，按任务选择翻译模型与推理等级。

主要能力

能力	用途
快译	直接翻译独立纯文本，适合短句和临时查译。
翻译润色	普通模式中直接向主模型提出要求，讨论用词和风格，再将意见用于初译或后续修订。
译文定稿	保留原稿和历次译文，反复比较、修改和选择定稿，自动保存历史以便继续讨论。
文件交付	以 TXT／Markdown 原稿为主，按需分段处理，通过会话打开译件，或在译文版本的“操作 → 另存为……”中选择位置保存。
主题记忆	在同主题会话间共享术语、实体、事实、关系、设定和参考资料；按需配置语义检索。

翻译与润色工作流

1. 提出要求：建立主题和会话，放入原稿，在主聊天说明读者、文风、背景和翻译目标。
2. 形成初译：普通模式由主模型整理要求并安排翻译；独立短文也可选择快译。
3. 讨论取舍：指出要讨论的句子、单元或版本，与主模型比较用词、语气和风格，逐步明确修改方向。
4. 应用意见：要求按讨论结果润色，主模型将整合后的要求交给翻译模型，生成同一单元的新版本；需要时继续讨论和修订。
5. 对比定稿：比较原稿和各版译文，选定满意的版本，再打开或另存为文件。

确认后的术语、设定和风格要求还可整理为主题记忆，为后续翻译和讨论提供依据。

环境与依赖

• DSH >=0.2.0-rc.2 <0.2.3-0，支持本地插件、具备所需接口并已配置模型；范围内按接口能力判断兼容性。
• 快译无需 Composer 扩展；普通模式需要配套的 dsh-composer-extension 和 submissions protocol 1。宿主缺少该接口时，由扩展按目标模块指纹匹配补丁；无关的 DSH 更新不要求重新适配。
• 从源码构建需要 Node.js 22 或更高版本、pnpm，以及并排放置的 Composer 扩展源码目录；DSH 宿主需能加载内置 node:sqlite。
• 当前 TXT／Markdown 文本文件每份最多 2 MiB，需使用 UTF-8 编码；其他格式的支持边界见下文。

支持 DSH 0.2.2-rc.1；该宿主的普通模式需要 Composer 0.4.7 及其匹配补丁。构建该版 DSH 及其宿主补丁需要 Node.js 24.9 或更高版本。

安装与更新

安装

1. 普通模式先从 Composer Releases 安装配套的 Composer 0.4.7；快译无需 Composer。
2. 从本插件的 Releases 下载 dsh-translation-plugin-<版本>.tgz，在 DSH 插件管理器的安装输入框中填写安装包的完整路径或附件下载链接，安装并启用。选择 .tgz 附件；分发包包含构建产物，使用者无需本地构建。
3. 在主聊天右侧栏打开“翻译”，建立主题和会话。按插件管理器提示重启；若 Composer 提示补丁已准备，则正常完全退出并重开 DSH 后再使用普通模式。

从源码构建

将两个仓库并排放置，先按 Composer 扩展的说明完成其构建，再在本插件目录执行：

pnpm install --frozen-lockfile
pnpm build

构建完成后，可在 DSH 插件管理器中安装本目录，或执行 pnpm pack 生成分发包。

更新

等待当前任务结束并确认资料已保存，再在插件管理器的安装输入框填写新版本 .tgz 的完整路径或版本下载链接，无需预先卸载。使用带版本号的新文件名或链接。通常只更新有变更的插件；发行说明要求配套更新时，先 Composer、后翻译插件。翻译插件可在宿主支持时热加载，否则按管理器提示刷新、重载或重启。

Composer 只有实际需要替换宿主补丁时，才必须正常完全退出并重开 DSH；更新扩展包不一定需要重新安装补丁。源码安装则更新原目录并按上方顺序重新构建，再刷新或重载。

本地数据库升级为 v8 格式，用于保留文件名分段基准。旧版插件无法读取该格式，回退时需恢复对应版本的完整数据备份。

资料库备份与恢复、已有资料迁移和详细更新步骤见使用指南。版本变化见 CHANGELOG。

使用说明

详细操作见中文使用指南，涵盖主题与会话、材料提交、润色定稿、文件交付、记忆管理、存储清理及问题反馈。

翻译输入框放原稿，主聊天输入框放要求和修改意见。 使用普通模式，将原稿与本次要求一起交给主模型组织处理。

可以先讨论，再决定怎样改。 例如先说“这个词还有哪些译法？先讨论，暂不翻译”，确定方向后再说“采用第二种说法，按刚才商定的语气润色这一单元”。主模型将明确的修改要求递交给翻译模型，已有译文作为修订依据。

讨论旧译文前，先在当前主聊天中打开对应翻译会话，让主模型按准确单元和版本查看原稿及已有译文。

会话历史由程序在后台自动保存。保存失败时，工作区保留当前内容并提供重试保存，无需重新调用翻译模型。

已撤回文本可在单元右上角选择清除，移除该占位。

阅读长文本时，当前原文或译文的标题与操作行保持在翻译会话顶部，随阅读区块切换。仅当原文行已吸顶时，收起原文会自动定位到当前译文行。

术语、风格要求和参考资料可以整理为记忆资产，支持后续讨论与翻译。条目采用、参考文件分段、原文索引及具体保存规则见使用指南。

当前限制与数据

• 补充信息：支持工具调用的翻译模型可在普通翻译中提出关键问题，由主模型结合已有语境回答，或向用户询问后重新调用翻译。每次调用分别计量；问题引用仅在当前宿主运行期有效。所选提供商和模型须支持工具调用；工具声明被拒绝时报告错误，不静默重试为普通翻译。
• 文件支持有限：当前主要支持 UTF-8 编码的 TXT 和 Markdown。PDF、图片、DOCX 等格式尚未提供完整的解析、识读和原格式交付支持。
• 翻译效率：翻译效率经过一定优化，但最终完成时间受模型与材料影响。
• 语义索引：启用后会将相关正文发送给配置的嵌入服务。
• 重启不自动续跑模型任务；结果未知时先查询原任务。导出不能替代完整备份，目前不支持导入恢复。
• 禁用或卸载插件不会自动删除本地资料，可按需清理版本、单元、会话、主题或插件数据。

项目与文档

入口	链接
翻译插件	Mulibaixi/dsh-translation-plugin
Composer 扩展	Mulibaixi/dsh-composer-extension
分发包	翻译插件发行页 · Composer 发行页
插件市场	Awesome DSH Plugin · dsh-plugin.org
问题反馈	翻译插件 Issues
中文使用指南	详细操作与问题反馈
更新记录	CHANGELOG
贡献指南	CONTRIBUTING

贡献与许可证

贡献方式见 CONTRIBUTING.md，项目规范见 AGENTS.md。采用 MIT 许可证。