去敏感提交

This commit is contained in:
2026-09-13 18:43:25 +08:00
parent 89021eb9f8
commit 599eea40d6
249 changed files with 16272 additions and 31659 deletions
+59 -1
View File
@@ -1,6 +1,64 @@
# 本次修订与验证
## VS Code 配方与图 1/图 2 箭头(本轮)
## 目录清理、去敏与文档合并(本轮)
### 身份信息去敏(队号改为运行期参数)
队号属身份信息,不再出现在代码、测试、示例与文档中:
- `src/mcm26b/cli.py`:`sim-check` 的 `--robot-id` 默认值由真实队号改为与赛事无关的
`SIMCHECK`;`run` 子命令本就 `required=True`。**对接官方模拟器的队号一律由命令行传入**。
- `src/mcm26b/harness/simulator.py`、`referee/src/referee/simulator.py`:
`robot_id` 由带默认值改为**必填**,杜绝把队号固化进可提交代码。
- `scripts/run_practice_episodes.py`:`--robot-id` 改为必填。
- `scripts/build_core_notebook.py` 及重新生成的 `mcm26b-核心代码.ipynb`:
离线自检单元用中性标识 `OFFLINE`;命令示例同步为 `python -m mcm26b.cli run`。
- 测试、`README.md`、`referee/README.md`、referee WebUI 提示文本:
真实队号统一替换为中性占位符 `TEAM-0001`。
- `referee-data/` 与 `examples/replay/` 下的演练/正式日志(共 110 个文件):
`robot_id` 字段统一为中性占位符,**位置、示向度、时间等证据字段原样未动**;
改后复算结果完全一致(44 局全清、计时偏差仍为 0.000000 s)。
### 清理无用文件
- 删除本机工作区 `tmp/`(43 MB,含历史留档、截图与中间草稿)、`.zcode/`;
- 删除论文不再使用的 MATLAB 出图链路:`scripts/matlab/`(17 个文件)、
`scripts/build_figure_data.py`、`scripts/render_q1_figures.py`;
论文插图现全部由 `scripts/plot_paper_figures.py` 生成;
- 删除 LaTeX 陈旧产物(`main-updated.pdf`、`main-check.*`、`main copy.*`)与
未被引用的 `docs/paper/sections/comparison.tex`;
- 删除 `docs/figures/flow-overall-architecture.png` 及其生成函数:
对应的四层主线图已从论文中移除,不再有插图引用它。
### 优化 .gitignore
按"只跟踪可复现结果所需的最小集合"重写,补齐 Python/构建/编辑器/操作系统条目,
新增忽略 `docs/paper/support-materials.zip`(脚本产物)、`.piptmp/`、`uv-temp/`、`pip-temp/`、
`.idea/`、`.zcode/`;保留 `referee-data/` 的版本控制并注明其身份信息已去敏。
### 文档合并到 README
论文已完整给出四问的模型、推导与结果分析,故删除 13 份算法与设计说明文档
(`docs/algo-*.md`、两份优化方案、示意图册、总体思路、执行时间、协议规则表、
最优与基线对比、论文列表),只保留复现所必需的说明:
- 根 `README.md` 重写为单一操作手册:环境 → 运行程序 → 自建模拟器 →
复现论文数据 → 复现插图 → 编译论文 → 单文件核心代码与测试 → 目录结构;
- `docs/README.md` 改为最小索引;
- `docs/paper/README.md` 与 `docs/figures/README.md` 同步更新(数据分工、重算与编译步骤、
插图清单与来源)。
- 源码/测试/脚本中原先指向被删文档的注释,统一改为指向论文对应章节,不留悬空引用。
### 验证
- `uv run pytest tests referee/tests`:**263 passed, 5 skipped**
(5 项为需要 `output/q1/practice` 官方演练采集的可选夹具,缺失时按 skip 处理);
- `python scripts/build_practice_data.py`:44 局复算,计时偏差 0.000000 s;
- `scripts/build_paper_support.py --package`:278 个文件、3.6 MB,未超 20 MB;
- `latexmk -xelatex -outdir=build`:56 页,无未解析引用、无超宽表格;
- 绘图脚本无告警,`docs/figures/` 只保留论文实际引用的 10 张 PNG。
## VS Code 配方与图 2 箭头(前轮)
- **LaTeX Workshop 默认配方换成与本项目编译口令一致的配方**:
`.vscode/settings.json` 现提供三个配方,默认