@yisan0429/dsh-itranslation-tools

使用

输入文件与目标语言在设置页配置，开启新对话，选用 Itranslation 模式后发送“开始翻译”。你在两处停点回应，其余（预读、分章翻译、组装、审查）全自动：

停点	时机	你要做的
① 术语表	预读完成、glossary.json 生成后	可直接编辑该文件增删术语，确认后 agent 才开始翻译
② 审查报告	全书译完、报告出来后	过目 audit-report.md：进入修订（只改报告指出的问题段），或直接出成品

失败与中断：任何步骤的工具调用报错（如 prepare 拒绝已录入的书）、派发被取消、或你打断/纠正 agent 时，agent 立即停止：只原样报告该步错误（若有），不做任何自行处置（不重试、不换路径、不继续下一步、不提问、不宣告下一步），等待你的明确指示。两个停点是 agent 仅有的两次提问；其余任何情况（含出错、被取消、被打断后）它都不提问、不决策。

工作流与产物：

input/.md                              output/.md
    │  prepare（录入，## 章边界）                 ▲  assemble（组装 + meta.json）
    ▼                                          │
produce//                               │
    ├─ state.json         章结构                │
    ├─ source/.md      清理后原文备份（审查依据）
    ├─ chapters/.md    各章译文（子代理逐章落盘；超长章分片 ..md）
    ├─ glossary.json      术语表（停点①可编辑）
    ├─ analysis.md        书档案（背景/摘要/逻辑线 + 完整风格指南）
    ├─ audit-report.md    全书审查报告（停点②过目）
    └─ meta.json          证据链（模型/耗时/token/修订记录）

配置

preset 配置（presets/itranslation/agent.cordis.yml）

键	默认	说明
overlongThresholdBytes	40000	章节源文本超过该字节数时被 itranslation_segment 标记为超长，agent 停下告知、不自动分片

LLM 提示词（设置页，命名空间 itranslation）

四个 LLM 步骤（预读/翻译/审查/修订）的附加提示词模板，在 DSH 设置页「整书翻译」分区编辑（经插件自有路由 /_dsh/itranslation/settings 读写）。默认值为内置成品提示词（core 包 DEFAULT_PROMPTS，设置页与 itranslation_prompts 工具共用同一真相源）；itranslation_dispatch 派发子代理时自动读取对应提示词并组装任务文本，留空/清空即回退到内置默认。itranslation_prompts 仅作只读查看/调试用，主代理在流水线中不应调用。同一设置页还包含 targetLanguage（默认 简体中文）与 inputFile（留空自动发现 input/ 下唯一 .md）。四个提示词键如下：

键	默认	说明
preReadPrompt	内置预读提示词	预读子代理附加提示词（通读全书 → 直接落盘 analysis.md（含完整风格指南）+ 高价值 glossary.json）
translatePrompt	内置翻译提示词	翻译子代理附加提示词（查表术语、段落数一致、不含章标题）
auditPrompt	内置审查提示词	审查模型附加提示词（5 维度、按章/段定位、不分级）
revisePrompt	内置修订提示词	修订模型附加提示词（只改报告指出的问题段）

preset 配置（presets/itranslation/agent.cordis.yml）

键	默认	说明
overlongThresholdBytes	40000	章节源文本超过该字节数时被 itranslation_segment 标记为超长，agent 停下告知、不自动分片