docs 索引
仓库文档分四类：总览与流程、逐问算法、验证与对比、论文与插图。 阅读顺序建议按下面的表格从上到下。
总览与流程
| 文档 | 内容 |
|---|---|
总体思路与流程图.md |
四问主线、端到端流程图（mermaid）、执行步骤与执行时间速查、交付物与验收锚点 |
执行时间与执行步骤.md |
计时模型、会话状态机与动作回合、附件示例逐步推演、实测日志分解、时间预算与安全阀 |
B题建模分析与实施计划.md |
四问建模取舍与 P0–P7 实施计划（最早的设计文档） |
协议规则表与状态机.md |
指令字段表、结果码、计时模型、状态机（P0 交付） |
逐问算法
| 文档 | 内容 |
|---|---|
algo-1.md |
问题一实现口径：半平面交、顶点对直径、直径圆充要判定、MEC 清除证书 |
问题一解答.md |
问题一论文式解答：模型边界、算法可复现步骤、反例构造、演练验证 |
algo-2.md |
问题二：候选集 K1、保证接收盘、安全盘 B(c, 1000−a)、最坏后验选点 |
algo-3.md |
问题三：三层在线架构、七点解析覆盖、覆盖账本、任务调度与停止条件 |
algo-3-bayes.md |
问题三 bayes 策略：网格幸存集滤波、信息增益选点、动态 TSP、Optuna 调参 |
algo-4.md |
问题四：forward_half_disk 最小命中集、位置×朝向联合信念、后备盲清 |
优化与验证
| 文档 | 内容 |
|---|---|
第三四问架构优化与运行提速方案.md |
运行历史复核、分层目标架构、P0–P2 优化项与实施路线 |
第三四问图论与动态规划优化方案.md |
图论/DP 引入方案与实测回填（含未采用的改动与原因） |
算法审核与优化-20260911.md |
一次外部口径的算法审核记录与结论 |
最优与基线实现对比.md |
1–4 问「最优实现 / 基线实现」对比框架与结果（论文口径说明） |
B题问题3-4相关论文列表.md |
题 3、4 相关文献清单 |
论文与插图
| 路径 | 内容 |
|---|---|
paper/main.tex |
论文正文（latexmk -xelatex main.tex）；插图经 \graphicspath 取自 figures/ |
paper/README.md |
论文编译方式、目录结构与待办标记 |
figures/README.md |
插图清单、配色与字体约定、数据来源与复现命令 |
figures/manifest.json |
每张图的数据来源与 sha256、生成命令 |
../project/README.md |
对比框架目录结构与运行方式；结果表由 scripts/build_paper_support.py 转入论文第 11 节 |
口径登记
同一事实在多份文档中出现时，以下列来源为准；发现不一致请先改文档，再复核图。
| 事实 | 权威来源 |
|---|---|
| 题面常量（Ω、速度、各动作耗时、源与频道范围） | src/mcm26b/config.py（带 [题面] / [工程] 标注） |
| 指令字段与结果码 | src/mcm26b/protocol/rules.py + 协议规则表与状态机.md |
| 问题一数值（D、ρ、E） | mcm26b.geometry.solve 的返回，或 问题一解答.md |
| 覆盖计划与证书 | src/mcm26b/guarantee/plans/*.json（q4_mincover_v2.json 为默认） |
| 实测虚拟时间 | 行为日志 virtual_time_s 字段与 evaluation.recompute_virtual_time |
| 冻结基准集对比结果 | project/results/*.md（由 uv run python -m project.run 生成）；论文表格为 docs/paper/data/project-*.tex，由 scripts/build_paper_support.py 生成 |
已知的两处需要随环境更新的引用：
问题一解答.md引用的output/q1/figures/*.png属于早期 离线插图（output/未入库）；现行插图在figures/。- 多份文档提到的官方演练报告位于
output/q3/practice/、output/q4/， 同样未入库；需要时用scripts/verify_q3_practice.py对留档目录复算。
写作约定
- 只写结论与依据，不使用比喻、排比与自评式措辞（例如「唯一权威」「关键洞察」）。
- 数字必须能在代码或数据中找到出处；图内不放标题与解释段落，
说明写在正文，图名与清单见
figures/README.md。 - 中文引号统一使用「」，避免与代码中的 ASCII 引号混淆。