当用户明确要求"迁移标书""升级模板""跨版本迁移""旧标书转新模板"时使用。智能迁移NSFC LaTeX标书到新版模板,基于五阶段工作流(分析→映射→规划→执行→验证),自动处理结构变化、内容重组、引用更新;支持AI驱动语义匹配与启发式回退,并提供 runs 输出隔离与一键迁移脚本。
核心入口:
python skills/transfer_old_latex_to_new/scripts/run.py --help一键迁移:
bash skills/transfer_old_latex_to_new/scripts/migrate.sh --old ... --new ...配置中心:config.yaml
参考文档:references/
拆分文档: references/quickstart.md / references/config_guide.md / / / /
# 一键分析(生成结构差异报告)
python skills/transfer_old_latex_to_new/scripts/run.py analyze \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026
# 一键应用(执行迁移,apply前自动快照)
python skills/transfer_old_latex_to_new/scripts/run.py apply \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026 \
--run-id <上一步输出的run_id>
# 一键编译(验证迁移结果)
python skills/transfer_old_latex_to_new/scripts/run.py compile \
--run-id <run_id> \
--new /path/to/NSFC_2026
# 一键恢复(回滚到apply前状态)
python skills/transfer_old_latex_to_new/scripts/run.py restore \
--run-id <run_id> \
--new /path/to/NSFC_2026
bash skills/transfer_old_latex_to_new/scripts/migrate.sh \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026
python skills/transfer_old_latex_to_new/scripts/run.py analyze \
--old /path/to/NSFC_2025 \
--new /path/to/NSFC_2026 \
--runs-root /path/to/runs
输出目录:默认 skills/transfer_old_latex_to_new/runs/<run_id>/;指定 --runs-root 则输出到该目录。
runs/<run_id>/
├── input_snapshot/ # 旧新项目输入快照
├── analysis/ # 结构分析JSON(sections_map_*.json, structure_diff.json)
├── plan/ # 迁移计划(migration_plan.json)
├── backup/ # Apply前新项目快照(用于restore)
├── logs/ # 执行日志与编译输出
│ ├── apply_result.json # 迁移执行结果
│ ├── compile_summary.json # 编译摘要
│ ├── compile_*_*.out.txt # 编译标准输出
│ ├── compile_*_*.err.txt # 编译标准错误
│ └── latex_aux/ # LaTeX 中间文件隔离目录
│ ├── main.aux # 辅助文件
│ ├── main.log # 编译日志
│ ├── main.bbl # BibTeX 输出
│ ├── main.blg # BibTeX 日志
│ ├── main.out # hyperref 输出
│ ├── main.toc # 目录文件
│ └── *.aux # 其他辅助文件
└── deliverables/ # 交付物(PDF、报告、指南)
中间文件隔离: 所有 LaTeX 编译中间文件(.aux/.log/.bbl等)自动保存在 logs/latex_aux/ 目录,避免在项目目录产生"垃圾"文件。最终 PDF 自动复制回项目根目录。
✅ 可修改:
extraTex/*.tex 内容文件(排除 @config.tex)references/*.bib(如需更新引用格式)runs/<run_id>/(日志、分析、备份、交付物)❌ 禁止修改:
main.tex 模板结构文件extraTex/@config.tex 配置文件.cls、.sty 样式文件更完整的流程说明、配置与排障文档已拆分到 references/:
当前版本: v1.4.0(与 config.yaml 同步)
变更记录: 见根级 CHANGELOG.md
优化计划: 质量评估与优化计划见 plans/v202601081355.md(仓库根级)
最后更新: 2026-01-08 维护者: Bensz Conan 许可证: MIT