# docs 索引

论文本身已完整给出四问的模型、推导与结果分析，因此本目录不再保留算法说明文档，
只留下复现所需的说明与材料。

| 入口 | 内容 |
| --- | --- |
| [`../README.md`](../README.md) | **总入口**：环境、运行程序、复现论文数据与插图、编译论文 |
| [`aigc-compliance-record.tex`](aigc-compliance-record.tex) | **AIGC 使用合规记录**：本机 AI 客户端会话的完整审计留痕（58 页） |
| [`aigc-compliance-record.pdf`](aigc-compliance-record.pdf) | 上述记录的编译成品 |
| [`paper/README.md`](paper/README.md) | 论文工程说明：数据分工、重算与编译步骤、VS Code 配方 |
| [`paper/REWRITE_NOTES.md`](paper/REWRITE_NOTES.md) | 论文各轮修订与验证记录（含演练数据重采与问题修复） |
| [`paper/main.tex`](paper/main.tex) | 论文 LaTeX 源文件（正文与附录） |
| [`paper/data/`](paper/data) | 论文引用的全部数据、宏与整表（由脚本生成） |
| [`figures/README.md`](figures/README.md) | 论文插图清单：每张图的数据来源与生成命令 |
| [`figures/manifest.json`](figures/manifest.json) | 插图来源清单（可机读） |

`docs/paper/fonts/` 存放论文编译用字体（约 150 MB），已在 `.gitignore` 中排除、不入库；
缺失时按 `paper/mcm26b-paper.cls` 内的注释改用系统字体。

## 复现顺序

```bash
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”。