mcm-26-b/docs/README.md

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）
paper/README.md	论文编译方式、目录结构与待办标记
figures/README.md	插图清单、配色与字体约定、数据来源与复现命令
figures/manifest.json	每张图的数据来源与 sha256、生成命令
../project/README.md	对比框架目录结构与运行方式

口径登记

同一事实在多份文档中出现时，以下列来源为准；发现不一致请先改文档，再复核图。

事实	权威来源
题面常量（Ω、速度、各动作耗时、源与频道范围）	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 生成）

已知的两处需要随环境更新的引用：

1. 问题一解答.md 引用的 output/q1/figures/*.png 属于早期 离线插图（output/ 未入库）；现行插图在 figures/。
2. 多份文档提到的官方演练报告位于 output/q3/practice/、output/q4/， 同样未入库；需要时用 scripts/verify_q3_practice.py 对留档目录复算。

写作约定

• 只写结论与依据，不使用比喻、排比与自评式措辞（例如「唯一权威」「关键洞察」）。
• 数字必须能在代码或数据中找到出处；图内不放标题与解释段落， 说明写在正文，图名与清单见 figures/README.md。
• 中文引号统一使用「」，避免与代码中的 ASCII 引号混淆。