前言¶

在 DSH 插件生态里，智能体可以调用模型完成翻译，但长文本翻译通常还要处理分块、术语抽取、源文与目标文检查、语气指南，以及翻译记忆的保存和复用。

dsh-plugin-translation 针对这些步骤提供工具化能力：模型负责翻译，插件负责分块、检查、术语维护和翻译记忆。

这是什么¶

dsh-plugin-translation 是面向 DeepSeek Harness agents 的翻译工具包。

• 维护者：863683348
• 许可证：MIT
• 核心定位：提供分块、术语/词表抽取、源目标 QA、语气指南，以及会话工作区中的持久化翻译记忆
• 注册工具：安装并重启 DSH 后，translate_kit 工具会 host-wide 注册

核心功能¶

translate_kit 通过不同 action 提供以下能力：

• segment：将文本拆分为编号、有边界大小的块，用于分块翻译
• glossary：提取缩写、camelCase、领域词、数字+单位、邮箱、URL 等候选术语，并计数
• check：对源文和目标文进行数字/单位、括号、长度比例、重复标点检查
• tone：按语域提供语气指南，包括正式、口语、技术语域，支持 en / zh
• memo_get：读取翻译记忆
• memo_add：将 source→target 翻译记忆保存到 session workspace 文件
• glossary_get：读取工作区词表
• glossary_add：添加或更新工作区词表项
• glossary_remove：删除工作区词表项
• consistency：对照词表做跨段术语一致性检查

安装与启用¶

1、执行官方安装命令。

dsh plugin --profile <profile> add dsh-plugin-translation

2、重启 DSH。

3、重启后，translate_kit 工具会 host-wide 注册，可在后续会话中作为翻译工作流工具使用。

典型用法¶

一个常见流程如下：

1、先用 segment 将长文本拆分为编号、有边界大小的块。
2、再用 glossary 提取候选术语，识别缩写、camelCase、领域词、数字+单位、邮箱、URL 等。
3、对需要长期统一表达的术语，用 glossary_add 写入工作区词表。
4、逐块翻译后，用 check 对源文和目标文做 QA，检查数字/单位、括号、长度比例、重复标点。
5、用 tone 获取正式、口语或技术语域的语气指南，再调整目标文表达。
6、用 memo_add 保存 source→target 翻译记忆。
7、后续翻译时，用 memo_get 读取已有记忆。
8、跨段完成后，用 consistency 对照词表检查术语一致性。
9、如果词表中已有不合适或过时的条目，用 glossary_remove 删除。

配置与文件位置¶

所有配置项均为可选，位于 composition row 的 config。

已核实的默认文件路径包括：

memoFile: .dsh/translation-memo.md
glossaryFile: .dsh/translation-glossary.md

这两个路径相对 session workspace，不能逃逸。

glossary 文件和 memo 文件默认最多保留 200 条。

Memory access 通过 ctx.fs 进行，并且每个解析路径都会与 session workspace 做 containment check。

适用场景与注意¶

适用场景：

• 需要在 DSH agents 中做长文本分块翻译
• 需要提取并维护术语表
• 需要检查 source→target 翻译中的数字、单位、括号、长度比例和重复标点
• 需要按正式、口语、技术语域调整语气
• 需要在 session workspace 中保存和读取翻译记忆
• 需要跨段检查术语一致性

注意事项：

• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
• 文件写入路径受 session workspace 限制，不能逃逸。
• 许可证为 MIT。
• peerDependencies 要求以下依赖版本：

@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-fs ^0.1.0-rc.6
@deepseek-ai/dsh-system-prompt ^0.1.0-rc.6
@deepseek-ai/dsh-tools ^0.1.0-rc.6
@deepseek-ai/schemastery ^3.18.1

相关链接¶

• GitHub：https://github.com/863683348/dsh-plugin-translation
• 目录页（插件线索，仅作为入口参考）：https://www.skillhub.cn/plugins/863683348/dsh-plugin-translation