From 80f561a5529acd6d8f605621fbfff7532b5467d0 Mon Sep 17 00:00:00 2001
From: zhang_taoming <854317252@qq.com>
Date: Sun, 23 Aug 2026 11:32:40 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E6=B7=BB=E5=8A=A0=20run.py=20?=
 =?UTF-8?q?=E5=85=A8=E6=B5=81=E7=A8=8B=E6=95=B0=E6=8D=AE=E7=94=9F=E6=88=90?=
 =?UTF-8?q?=E7=94=A8=E6=B3=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 9d54f42..f7214d7 100644
--- a/README.md
+++ b/README.md
@@ -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}/...`。
+- 任一步失败即停止并返回该步退出码。
+
 ## 架构
 
 ```