mcpField
P
paper-spine-translate

paper-spine-translate

github.com/wubing2023文档处理6.1k207 次安装2 周前更新
代码仓库

关于 paper-spine-translate

paper-spine-translate 为 PaperSpine 写作工作流生成完整的中文译稿包。它会清点所需文件、逐项完整翻译,并通过检查脚本验证覆盖情况。

主要功能

  1. 01清点所需翻译文件
  2. 02完整翻译文档和表格
  3. 03在清单中跟踪文件状态
  4. 04运行翻译检查脚本
  5. 05记录翻译覆盖情况

适用场景

  1. 01将 PaperSpine 成果完整翻译为中文
  2. 02确保翻译所有工作流所需文件
  3. 03在审计前检查翻译完整性

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-translate

安装后在 Claude Code 中输入/paper-spine-translate确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
scripts/
_paper_spine_utils.py
humanize_check.py
translate_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.jsonpaper_spine_config.zh.md
source_map.mdsource_map.zh.md
reference_materials/source_index.mdreference_materials/source_index.zh.md
research_dossier.mdresearch_dossier.zh.md
exemplar_learning_dossier.mdexemplar_learning_dossier.zh.md
style_profile.mdstyle_profile.zh.md
sota_gap_map.mdsota_gap_map.zh.md
motivation_options_after_research.mdmotivation_options_after_research.zh.md
confirmed_motivation.mdconfirmed_motivation.zh.md
section_blueprints.mdsection_blueprints.zh.md
writing_rationale_matrix.mdwriting_rationale_matrix.zh.md
citation_support_bank.mdcitation_support_bank.zh.md
latex_report.mdlatex_report.zh.md
final_artifact_manifest.mdfinal_artifact_manifest.zh.md
artifact_check.mdartifact_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 步要求翻译防护检查通过,审计才能开始。

评论

支持 Markdown