# 一键分析（生成结构差异报告）
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 \
  --new /path/to/NSFC_2026

# 一键恢复（回滚到apply前状态）
python skills/transfer_old_latex_to_new/scripts/run.py restore \
  --run_id <run_id>

runs/<run_id>/
├── input_snapshot/     # 旧新项目输入快照
├── analysis/           # 结构分析JSON（sections_map_*.json, structure_diff.json）
├── plan/               # 迁移计划（migration_plan.json）
├── backup/             # Apply前新项目快照（用于restore）
├── logs/               # 执行日志（apply_result.json）
└── deliverables/       # 交付物（PDF、报告、指南）

# 0.1 路径验证（core/security_manager.py）
SecurityManager.validate_paths(old_project, new_project)

# 0.2 版本识别（core/project_analyzer.py）
detect_project_version(project_path)  # -> "2025" | "2026" | "unknown"

# 0.3 创建运行目录（core/run_manager.py）
run = create_run(runs_root, run_id=args.run_id)

# 1. 为每对文件构建上下文（文件路径、章节结构、内容预览）
context = _build_file_context(old_file, new_file)

# 2. AI 基于上下文进行语义判断
ai_result = await _ai_judge_mapping(context)
# 返回: {
#   "should_map": true/false,
#   "confidence": "high/medium/low",
#   "score": 0.0-1.0,
#   "reason": "详细说明理由（中文）"
# }

# 3. 根据置信度和分数决定映射策略
# - score >= 0.85: high confidence → 自动确认
# - 0.7 <= score < 0.85: medium confidence → AI 推理确认
# - 0.5 <= score < 0.7: low confidence → 需人工确认
# - score < 0.5: 不映射

{
  "mapping": {
    "one_to_one": [
      {
        "old": "extraTex/立项依据.tex",
        "new": "extraTex/立项依据.tex",
        "score": 0.95,
        "confidence": "high",
        "reason": "AI判断：文件名、章节结构、内容主题高度一致，应该映射"
      }
    ],
    "new_added": [{"file": "...", "reason": "新模板存在但未映射"}],
    "removed": [{"file": "...", "reason": "未找到可靠映射"}],
    "low_confidence": [
      {
        "old": "...",
        "new": "...",
        "score": "0.650",
        "reason": "AI判断：内容有相关性但不确定是否应该映射",
        "action": "needs_review"
      }
    ]
  }
}

# 自动快照新项目（core/snapshot.py）
snapshot_project_editables(new_project, run.backup_dir)

# 安卫检查（core/security_manager.py）
SecurityManager.for_new_project(new_project, runs_root)

# 1. 扫描旧项目资源文件
scan_result = scan_project_resources(old_project, migrated_tex_files)
# → 识别 \includegraphics, \lstinputlisting 等引用的资源

# 2. 复制资源文件到新项目
copy_result = copy_resources(old_project, new_project, scan_result.resources)
# → 只复制新项目中不存在的资源（避免覆盖）

# 3. 验证引用完整性
validation_result = validate_resource_integrity(new_project, scan_result.resources)
# → 检查所有资源是否在新项目中存在

xelatex → bibtex → xelatex → xelatex

# 查看详细编译日志
cat runs/<run_id>/logs/compile_result.json

# 常见原因：宏包不兼容、语法错误、引用失效
# 解决：检查 core/compiler.py 日志，修复后重新 compile

# 检查映射关系
cat runs/<run_id>/analysis/structure_diff.json

# 手动调整映射后重新 apply

# 一键恢复到apply前状态
python skills/transfer_old_latex_to_new/scripts/run.py restore --run_id <run_id>

用户: "帮我把2025年的标书迁移到2026新模板"
AI: 检测到迁移需求 → 触发本技能 → 执行完整工作流

from core.migrator import apply_plan
from core.config_loader import load_config

config = load_config(skill_root)
result = apply_plan(old_project, new_project, plan, config, security, backup_root)