feat: 多轮运行 + GCOV 合并 + JSON 出力 + DesignDataGenerator

2026-07-12 21:04:58 +08:00
parent af37e33b98
commit f3be17e5eb
40 changed files with 4397 additions and 198 deletions
@@ -0,0 +1,53 @@
+# 出力目录规则
+
+## 单轮（runs: [] 或 YAML 不存在）
+
+```text
+runtime/{program_id}/
+  input/KIN08R01, KIN08S01          ← COBOL 入力平面文件
+  json/{program_id}.json            ← JSON（input/working_storage/termination）
+  output/KIN08W01                   ← COBOL 出力平面文件
+  gcov/                             ← .gcda/.gcno（直下）
+```
+
+## 多轮（runs: 定义在 config/programs/{program_id}.yaml 中）
+
+```text
+runtime/{program_id}/
+  run_{scenario_id}/
+    input/KIN08R01, KIN08S01        ← 該当场景の入力
+    json/{program_id}.json          ← 該当场景の JSON
+    output/KIN08W01                 ← 該当场景の COBOL 出力
+  gcov/
+    run_{scenario_id}/              ← 該当场景の .gcda/.gcno
+```
+
+## 单轮/多轮共有
+
+- 编译: `work_dir/bin/{program_id}.exe`（全场景共享）
+- .gcno: `work_dir/bin/{program_id}_pp.gcno`（编译时生成，COPY 到各场景）
+- DB: `C:/Temp/gix/{program_id}_{scenario_id}.db`（多轮场景）或 `C:/Temp/gix/{program_id}.db`（单轮）
+  - 运行前 COPY 到 `C:/Temp/gix/{program_id}.db`（COBOL 的 gixsql 硬编码连接此路径）
+- SYSIN 文件: 由 `write_sysin_file(run_cfg=scenario.sysin)` 按场景生成
+
+## 覆盖率合并（多轮）
+
+- 各场景独立跑 gcov → 解析 `.cbl.gcov` → `{line: count}` 字典
+- Python 级合并: `merged[line] = max(各场景的 count)`
+- 合并后数据传给 `run_coverage()`
+
+## YAML 场景定义格式
+
+`config/programs/{program_id}.yaml` 追加 `runs:` 字段:
+
+```yaml
+runs:
+  - id: normal
+    sysin:
+      period: "202607"                # P 卡値（null=无 P 卡）
+      include_invalid_period: true    # 是否追加无效 P 卡
+      modes: ["NORMAL", "RESET"]      # M 卡列表
+    inject_duplicate_pk: false
+```
+
+每个场景的 `sysin` 字段由该程序的 `write_sysin_file()` 解析，字段含义不跨程序通用。