Commit 74313c01 74313c011484ae756128b69fa36c81dcd408504c by cnb.bofCdSsphPA

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
1 parent d3082ce2
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)。
......