去敏感提交
This commit is contained in:
@@ -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` 现提供三个配方,默认
|
||||
|
||||
Reference in New Issue
Block a user