开发流程（简要）

本页关注“怎么开发 / 怎么演示 / 怎么保证文档与实现一致”。

---

基本约定

• 需求与验收：以 docs/srs/07-acceptance.md 为准（答辩/演示按它走）。
• 版本路线图：以 docs/roadmap.md 为准（对外 Demo-0/1/2 口径固定）。
• 运行产物：统一输出到 runs/<run_id>/，不要提交到 Git（已在 .gitignore 忽略 runs/）。
• UNET 适配原则：核心逻辑不硬编码 UNET agent/service/message 类名；优先通过 probe 输出与 scenario 注入 hint。

---

文档同步规则（非常重要）

每次影响行为/命令/验收口径的改动，必须同步文档：

1. 必须更新：docs/progress/00-status.md

• 追加一条“更新记录”（日期、摘要、影响 Demo、验证方式、关联 commit）。

2. 如影响路线图/优先级：更新 docs/roadmap.md

• 明确“当前 Demo 缺陷”与“下一版本要补的 feature”。

3. 如影响验收口径/演示步骤：更新 docs/srs/07-acceptance.md

• 保证演示脚本可以复制执行。

补充：Demo-1 推进过程中的踩坑/排查细节见 docs/progress/01-demo1-pitfalls.md。

---

提交流程与验证建议

• 小步提交：每次改动尽量保持可运行、可复现。
• 提交信息：写清楚影响范围（runner/metrics/unet_adapter/docs 等）。

基础校验：

• python -m compileall src
• pytest -q

Demo-1 校验（需要 UNET 运行中）：

• python scripts\unet_probe_gateway.py --scenario scenarios\demo_2node_handbook.yaml --all
• python scripts\unet_subscribe_rx.py --scenario scenarios\demo_2node_handbook.yaml --node-id 2 --seconds 30 --debug
• python scripts\unet_send_ping_or_tx.py --scenario scenarios\demo_2node_handbook.yaml --node-id 1 --to 2 --payload-bytes 32 --json
• python -m unet_dt.orchestrator.runner --scenario scenarios/demo_2node_handbook.yaml --mode gateway --strategy round_robin --steps 10 --dt 1 --seed 42 --rx-grace 15