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