docs: README 添加 run.py 全流程数据生成用法

2026-08-23 11:32:40 +08:00
parent 8ac2d65568
commit 80f561a552
1 changed files with 21 additions and 0 deletions
@@ -20,6 +20,27 @@ python test-data/s30_db_e2e.py
 python -m cobol_testgen ../cobol-tna-system/src/KIN01INP.cbl
 ```

+## 全流程数据生成（run.py）
+
+先跑白盒 `cobol_testgen`（静态分析 + 测试数据），成功后跑黑盒 `black-box-data-create`（DeepSeek LLM 生成 JSON/SQL）：
+
+```bash
+python run.py \
+    --design "D:\cobol-tna-system\詳細設計書\詳細設計書_ZAN04MAT.md" \
+    --source "D:\cobol-tna-system\src\ZAN04MAT.cbl" \
+    --file-db-md "D:\cobol-tna-system\詳細設計書\COPY句定義書.md" \
+    --cpy "D:\cobol-tna-system\cpy" \
+    --db-md "D:\cobol-tna-system\詳細設計書\DB定義書.md" \
+    --output "D:\output"
+
+# 只查看将执行的命令，不真正运行
+python run.py --design ... --output ... --dry-run
+```
+
+- 参数 `--design / --source / --file-db-md / --cpy / --db-md / --output` 为必需项，`--api-key / --model / --rules / --max-tokens` 可选透传给黑盒。
+- 两步输出到同一 `--output` 根目录：白盒写 `output/<程序ID>/main/...`，黑盒写 `output/<程序ID>/g{N}/...`。
+- 任一步失败即停止并返回该步退出码。
+
 ## 架构

 ```