Add the shortest runnable restart command to the docs overview and reconfirm the offline smoke
Constraint: Restrict this checkpoint to navigation and handoff documentation backed by fresh local verification Rejected: Keep restart guidance read-only without a first command to run | New sessions benefit from an immediate executable sanity check Confidence: high Scope-risk: narrow Directive: Keep README focused on compressed restart guidance and use the offline smoke only as an environment and chain sanity check Tested: Re-ran business_export_offline_smoke.py successfully and rechecked 215 relative links across the updated docs Not-tested: Did not connect to a live business export or run full training/evaluation beyond dry-run
Showing
3 changed files
with
33 additions
and
0 deletions
| 1 | ## 2026-06-02 总览页补齐最短可跑命令 checkpoint | ||
| 2 | |||
| 3 | 完成项: | ||
| 4 | - 已在 `docs/README.md` 补入“新 session 最短可跑命令”。 | ||
| 5 | - 已再次重跑 `business_export_offline_smoke.py`,确认离线 smoke 仍可通过。 | ||
| 6 | |||
| 7 | 验证结果: | ||
| 8 | - `catalog_refs=2` | ||
| 9 | - `train_queries=1` | ||
| 10 | - `test_queries=1` | ||
| 11 | - `val_queries=0` | ||
| 12 | - `dry_run_passed=true` | ||
| 13 | |||
| 14 | 结论: | ||
| 15 | - 现在新 session 不仅知道先读什么,也知道先跑什么来验证环境与链路。 | ||
| 16 | |||
| 1 | ## 2026-06-02 总览页一致性与最短阅读顺序 checkpoint | 17 | ## 2026-06-02 总览页一致性与最短阅读顺序 checkpoint |
| 2 | 18 | ||
| 3 | 完成项: | 19 | 完成项: | ... | ... |
| ... | @@ -65,6 +65,22 @@ flowchart TD | ... | @@ -65,6 +65,22 @@ flowchart TD |
| 65 | - 做你们自己的业务素材接入:先读 `business-export-cookbook.md` | 65 | - 做你们自己的业务素材接入:先读 `business-export-cookbook.md` |
| 66 | - 做 FMA / MTG-Jamendo 这类开放数据:先读 `open-dataset-workflow.md` | 66 | - 做 FMA / MTG-Jamendo 这类开放数据:先读 `open-dataset-workflow.md` |
| 67 | 67 | ||
| 68 | ## 2.6 新 session 最短可跑命令 | ||
| 69 | |||
| 70 | 如果你只是想先确认“业务导出链还能不能跑”,直接执行: | ||
| 71 | |||
| 72 | ```bash | ||
| 73 | cd /workspace/acr-engine | ||
| 74 | /usr/local/miniconda3/bin/python scripts/business_export_offline_smoke.py \ | ||
| 75 | --output-root /tmp/business_export_offline_smoke | ||
| 76 | ``` | ||
| 77 | |||
| 78 | 预期结果: | ||
| 79 | - 生成业务导出样例 | ||
| 80 | - 生成 manifest-ready JSONL | ||
| 81 | - 生成项目 `catalog/train/test/val` | ||
| 82 | - `train.py --dry-run` 通过 | ||
| 83 | |||
| 68 | ## 3. 主文档分组 | 84 | ## 3. 主文档分组 |
| 69 | 85 | ||
| 70 | ### A. 项目与架构 | 86 | ### A. 项目与架构 | ... | ... |
| ... | @@ -256,6 +256,7 @@ | ... | @@ -256,6 +256,7 @@ |
| 256 | ### 文档入口最新状态 | 256 | ### 文档入口最新状态 |
| 257 | - `docs/README.md` 已补齐业务数据接入导航与最短链说明。 | 257 | - `docs/README.md` 已补齐业务数据接入导航与最短链说明。 |
| 258 | - `docs/README.md` 已新增“新 session 最短阅读顺序”。 | 258 | - `docs/README.md` 已新增“新 session 最短阅读顺序”。 |
| 259 | - `docs/README.md` 已新增“新 session 最短可跑命令”。 | ||
| 259 | 260 | ||
| 260 | ### 最优先待办 | 261 | ### 最优先待办 |
| 261 | 1. 把已完成的 toy bucket baseline 升级为语义 bucket(风格 / 结构 / hard-case)。 | 262 | 1. 把已完成的 toy bucket baseline 升级为语义 bucket(风格 / 结构 / hard-case)。 | ... | ... |
-
Please register or sign in to post a comment