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}/...`。
+- 任一步失败即停止并返回该步退出码。
+
 ## 架构
 
 ```