用途
PaperSpine Translate 是 PaperSpine 内部的翻译步骤分支。仅当 output_language 为 en 且 translation_package 为 zh 时使用该分支。它的任务是在 paper_rewriting_output/translation_zh/ 下产出所有必需的中文翻译文件——不是摘要,也不是部分文件集合。
其运行原则是:只覆盖少量文件的翻译包属于失败输出。编排器要求先具备完整的 translation_zh/ 才会宣告工作流完成。该分支端到端地承担翻译职责。
主要能力
该分支通过三阶段流程完成翻译:
阶段一 — 清点
读取 paper_spine_config.json 以确定工作流,列出所有必须翻译的文件,并把清点结果写入 translation_zh/manifest.md,每个条目状态为 pending。
两种工作流共有的文件(英文源 → 中文目标):
- paper_spine_config.json → paper_spine_config.zh.md
- source_map.md → source_map.zh.md
- reference_materials/source_index.md → reference_materials/source_index.zh.md
- research_dossier.md → research_dossier.zh.md
- exemplar_learning_dossier.md → exemplar_learning_dossier.zh.md
- style_profile.md → style_profile.zh.md
- sota_gap_map.md → sota_gap_map.zh.md
- motivation_options_after_research.md → motivation_options_after_research.zh.md
- confirmed_motivation.md → confirmed_motivation.zh.md
- section_blueprints.md → section_blueprints.zh.md
- writing_rationale_matrix.md → writing_rationale_matrix.zh.md
- citation_support_bank.md → citation_support_bank.zh.md
- latex_report.md → latex_report.zh.md
- final_artifact_manifest.md → final_artifact_manifest.zh.md
- artifact_check.md → artifact_check.zh.md
- 最终论文(.tex 或 .md)→ full_paper_translation.zh.md
- — → translation_coverage.md
仅重写工作流新增的文件:
- original_logic_map.md → original_logic_map.zh.md
- rewrite_matrix.md → rewrite_matrix.zh.md
- logic_transfer_audit.md → logic_transfer_audit.zh.md
仅构建工作流新增的文件:
- source_inventory.md → source_inventory.zh.md
- evidence_bank.md → evidence_bank.zh.md
- figure_asset_map.md → figure_asset_map.zh.md
- claim_register.md → claim_register.zh.md
阶段二 — 翻译
翻译清单中列出的每个文件,遵循以下规则:
- 普通散文文件:翻译全文。保留 LaTeX 引用键(\cite{...})、标签(\label{...})、公式、文件路径、原始数值、URL 和代码标识符原样不动,翻译其周围的散文。
- 大型表格文件(writing_rationale_matrix.md、citation_support_bank.md、section_blueprints.md、research_dossier.md、exemplar_learning_dossier.md、sota_gap_map.md 及任何工作流特有的表格文件):翻译每一行和每一个单元格。翻译后的表格行数必须不少于原表。被缩短的摘要表格属于失败输出。
- full_paper_translation.zh.md 必须包含:标题、摘要、每个章节与小节的正文段落、图标题、表标题与表注、局限性、结论、致谢和附录叙述文字。
- 每个文件翻译完成后,将 manifest.md 的状态从 pending 更新为 translated。
不得因为文件“很大”就跳过,不得用摘要代替翻译。审计会拒绝部分翻译。
阶段三 — 校验
运行守护脚本并要求 PASS:
python scripts/translate_guard.py paper_rewriting_output --markdown --write
这会生成 translation_zh/translate_guard_report.md。若有任何检查失败,返回阶段二并修复报告中标记的具体文件。
编写 translation_coverage.md,列出每个源文件、对应的中文文件及其最终状态(translated)。在审计通过前,每个条目都必须是 translated。
使用方式
该分支由编排器在 paper-spine-latex 之后、paper-spine-audit 之前调用。编排器不可协商路线(Non-Negotiable Route)第 14 步要求在审计开始前翻译守护脚本必须 PASS。
适用场景
适用于 PaperSpine 论文重写工作流中需要中文翻译包的场景,即输出语言为英文、翻译包目标语言为中文时。它覆盖重写工作流与构建工作流两种情形,并按工作流类型补充各自的特有文件。
限制
校验依赖脚本 scripts/translate_guard.py,其返回结果必须为 PASS,否则需回到阶段二修复。翻译必须完整,表格需逐行逐格翻译,全文翻译需覆盖标题、摘要、各级章节正文、图表标题与表注、局限性、结论、致谢和附录。不得用摘要或缩短的表格替代完整翻译。相关价格、收费、平台支持等信息暂未提供。