关于 paper-spine-translate
paper-spine-translate 为 PaperSpine 写作工作流生成完整的中文译稿包。它会清点所需文件、逐项完整翻译,并通过检查脚本验证覆盖情况。
主要功能
- 01清点所需翻译文件
- 02完整翻译文档和表格
- 03在清单中跟踪文件状态
- 04运行翻译检查脚本
- 05记录翻译覆盖情况
适用场景
- 01将 PaperSpine 成果完整翻译为中文
- 02确保翻译所有工作流所需文件
- 03在审计前检查翻译完整性
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ wubing2023/ paperspine --skill paper-spine-translate安装后在 Claude Code 中输入/paper-spine-translate确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlscripts/_paper_spine_utils.pyhumanize_check.pytranslate_guard.py详细介绍
PaperSpine Translate
当 output_language 为 en 且 translation_package 为
zh 时,使用此分支。其任务是生成 paper_rewriting_output/translation_zh/ 下
所有必需的中文翻译文件——不能只提供摘要,也不能只翻译部分文件。
工作原则
只覆盖少数文件的翻译包属于失败输出。
编排器要求先完整生成 translation_zh/,才能将工作流标记为完成。此分支负责端到端的翻译工作。
三阶段流程
阶段 1 — 清点
读取 paper_spine_config.json,确定 workflow。列出所有必须翻译的文件。将清单写入 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 |
阶段 2 — 翻译
翻译清单中的每个文件。遵循以下规则:
- 纯文本文件: 翻译全文。保留 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。
不要因为文件“太大”而跳过。不要用摘要代替翻译。审核会拒绝不完整的译文。
阶段 3 — 验证
运行守护脚本并要求其结果为 PASS:
python scripts/translate_guard.py paper_rewriting_output --markdown --write
此操作会生成 translation_zh/translate_guard_report.md。如果任何检查失败,请返回阶段 2,并修复报告指出的具体文件。
编写 translation_coverage.md,列出每个源文件、其对应的中文文件以及最终状态(translated)。审核通过前,每个条目的状态都必须为 translated。
集成
编排器在 paper-spine-latex 之后、paper-spine-audit 之前调用此分支。编排器的 Non-Negotiable Route 第 14 步要求翻译防护检查通过,审计才能开始。