iuh

docs/paper/README.md

@@ -4,18 +4,31 @@
 
 ## 交付文件
 
-- main.pdf：定稿 PDF，摘要 1 页，正文及参考文献 22 页；之后为数据清单与完整源码附录。
+- main.pdf：定稿 PDF，摘要 1 页，正文（含参考文献）29 页，未超过格式规范的 30 页；
+  之后为数据清单与完整源码附录（页数不限）。
 - main.tex、sections/：可编辑 LaTeX 源文件。
+- figures/：正文的矢量图源文件（正式累计耗时图）。
+- 正文的 11 张插图取自 ../figures/（PNG，由 `scripts/build_figure_data.py`
+  与 `scripts/matlab/*.m` 生成），main.tex 只通过 \graphicspath 引用，不重绘。
 - data/formal-results.json、formal-results.csv、audit.md：四份正式数据的匿名快照、复算结果及核对说明。
+- data/project-*.tex、project-macros.tex：最优/基线配对对比的表格与数值宏，
+  由 `scripts/build_paper_support.py` 从 project/results/*.json 生成，不手抄。
 - support-materials.zip：程序源码、正式原始日志、统计快照、论文源文件和逐文件哈希清单。
 - REWRITE_NOTES.md：重写范围、修正的论证和验证记录。
 
 ## 数据口径
 
-只使用 Jammers-simulator-full/test/q3 与 test/q4 下的四份正式导出。包与官方原始导出及结果侧文件进行 SHA-256 核对，再由公开头部的票据哈希关联官方正式统计队列。
+正式成绩只使用 Jammers-simulator-full/test/q3 与 test/q4 下的四份正式导出。包与官方原始导出及结果侧文件进行 SHA-256 核对，再由公开头部的票据哈希关联官方正式统计队列。
 
 日志负载没有解密。论文可读快照不含账号、设备或票据内容。两问各只有两份所选正式记录，第三份以未提供记录表示；正式源总数未知，故不计算全清率。四次均为主动退出且清除失败计数为零，这不能替代全清证明。正式包没有与当前策略提交版本绑定，不能据此作配对消融或因果比较。
 
+论文另有两类非正式数据，均单独成节或单独标注，不与正式成绩合并：
+
+- 第 11 节「算法对比实验」用 project/results 的最优／基线配对结果，
+  运行在内存回环评测机上，源位置等分布是自建测试假设；
+- 问题三、四末节与时间分解中的演练局插图（BBM9…/GHSN…）、
+  以及问题一的演练观测算例（U5ZW…），只用于说明机制，图注均标注「演练」。
+
 ## 重算和编译
 
 在项目根目录（Python 3.10 及以上）执行：
@@ -29,21 +42,33 @@
 
 快照模式可重算表格并核对现有原始包的哈希，不能在缺少官方队列时再次独立验证来源匹配。
 
+`scripts/build_paper_support.py` 还会读取 `project/results/*.json`，
+生成第 11 节使用的 `data/project-*.tex` 与 `data/project-macros.tex`；
+复跑对比框架本身执行 `uv run python -m project.run`。
+正文插图的数据与出图命令见 `../figures/manifest.json`：
+
+    uv run python scripts/build_figure_data.py
+
 进入 docs/paper 后执行：
 
     latexmk -xelatex -interaction=nonstopmode -halt-on-error main.tex
 
 输出为本目录 main.pdf。VS Code 默认配方也已设为 latexmk (xelatex)，自动编译直至交叉引用稳定；仅运行一次 XeLaTeX 会在首次构建时产生问号。
+正文插图通过 `\graphicspath{{../figures/}}` 引用 `docs/figures/`，
+因此需要 docs/paper 与 docs/figures 保持同级目录关系。
 
 在项目根目录生成支撑压缩包：
 
     python scripts/build_paper_support.py --package
 
+打包会把 project/、docs/figures/ 与四份正式原始包一起写入 support-materials.zip；
+缺少 `Jammers-simulator-full/` 原件时该命令会报错，不会生成缺日志的压缩包。
+
 需要 TeX Live 的 XeLaTeX、ctex、TikZ。mcm26b-paper.cls 已恢复原模板，文档类选项和标题、摘要、关键词的版式也恢复原用法。精简支撑包不包含大体积字体，编译前需从原项目补齐 docs/paper/fonts/，不提供会改变原版式的字体回退。源码附录中的数学符号仍采用 LaTeX 转义命令。data/listing-source/ 只是生成的排版副本，可执行的 src/ 文件保持原样。
 
 ## 版式与验证
 
-A4、四边距 2.5 cm，电子版由摘要页起连续编号，不含目录、承诺书和编号专用页。正文按问题重述、分析、假设、符号、四问模型与算法、正式结果、评价、参考文献组织。源码附录列出全部 31 个策略及配套 Python 模块和两个论文处理脚本。
+A4、四边距 2.5 cm，电子版由摘要页起连续编号，不含目录、承诺书和编号专用页。正文按问题重述、分析、假设、符号、计时模型、四问模型与算法、正式结果、算法对比、评价、参考文献组织。源码附录列出全部 31 个策略及配套 Python 模块和两个论文处理脚本。
 
-统计表和耗时图从匿名快照生成；几何示意图使用正文明确给出的参数。几何推导和离散覆盖证书与正式测试结果分别说明。详见 REWRITE_NOTES.md。
+统计表、对比表与耗时图分别从匿名快照和 project/results 生成；几何示意图使用正文明确给出的参数。几何推导、离散覆盖证书、正式测试与自建对比分别说明。详见 REWRITE_NOTES.md。