入口	内容
`../README.md`	总入口：环境、运行程序、复现论文数据与插图、编译论文
`paper/README.md`	论文工程说明：数据分工、重算与编译步骤、VS Code 配方
`paper/REWRITE_NOTES.md`	论文各轮修订与验证记录（含演练数据重采与问题修复）
`paper/main.tex`	论文 LaTeX 源文件（正文与附录）
`paper/data/`	论文引用的全部数据、宏与整表（由脚本生成）
`figures/README.md`	论文插图清单：每张图的数据来源与生成命令
`figures/manifest.json`	插图来源清单（可机读）

复现顺序

python scripts/build_practice_data.py     # 演练局复算 → 宏与表格
python scripts/audit_paper_formal.py --snapshot docs/paper/data/formal-results.json
python scripts/build_paper_support.py     # 附录正式数据表（--package 另出支撑包）
uv run python scripts/plot_paper_figures.py
cd docs/paper && latexmk -xelatex -interaction=nonstopmode -halt-on-error -outdir=build main.tex

docs/paper/data/*.tex 由脚本生成，一律使用 LF 换行：CRLF 会让 \input 进表格的行在 TeX 缓冲中提前 \par 化，触发 booktabs 的 “Misplaced \noalign”。