migrating-latex-templates

name	migrating-latex-templates
version	1.4.1
description	当用户明确要求"迁移标书""升级模板""跨版本迁移""旧标书转新模板"时使用。智能迁移NSFC LaTeX标书到新版模板，基于五阶段工作流（分析→映射→规划→执行→验证），自动处理结构变化、内容重组、引用更新；支持AI驱动语义匹配与启发式回退，并提供 runs 输出隔离与一键迁移脚本。
author	Bensz Conan
metadata	{"author":"Bensz Conan","short-description":"NSFC LaTeX标书跨版本智能迁移","keywords":["latex","nsfc","proposal migration","template upgrade","cross-version migration","structure reorganization"],"triggers":["迁移标书","升级模板","跨版本迁移","旧标书转新模板","模板结构变化","内容重组"]}
dependencies	[{"python":">=3.8"},{"latex":"texlive-full"},"scripts/run.py","scripts/core/"]
entry_point	python skills/transfer_old_latex_to_new/scripts/run.py
config	skills/transfer_old_latex_to_new/config.yaml
references	skills/transfer_old_latex_to_new/references/

LaTeX 标书智能迁移器

核心入口：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 / references/api_reference.md / references/troubleshooting.md / references/faq.md / references/case_study_2025_to_2026.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

runs 输出隔离（强烈建议：测试/批处理）

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、报告、指南）