12.11 闭环：二十用例点亮 + 单步观察。

- cases_test：tests/cases/01..20 逐一跑完整管线（解析→链接→类型→码→VM 周期），按 EXPECTED.md 期望断言：13 正例运行通过（含双周期可重复）、06 CycleLimit、6 负例报错类别 - BytecodeExecutor --step：采样 I → 逐指令打印 pc/fn/反汇编 + 执行后非零寄存器 → I/Q - Machine 补 header()/ended()/nregs()/cur_instr() 观察接口 - ctest 11/11（cases_all 20 用例点亮）；line1 回放 0/1 组合 Q 正确、单步 I=[0 1]→Q=[1]
2026-08-21 20:31:14 +08:00
parent 00565f035d
commit 66d9c6c548
6 changed files with 308 additions and 41 deletions
@@ -7,11 +7,12 @@ BytecodeExecutor 模块：可执行入口。CMake 目标：`BytecodeExecutor`（
 ## 用法

 ```text
-BytecodeExecutor <name>.stb [--cycles N] [--replay <file>]
+BytecodeExecutor <name>.stb [--cycles N] [--replay <file>] [--step]
 ```

 - `--cycles N`：跑 N 个周期（缺省 10）
 - `--replay <file>`：读录制的 I 序列（每行空格分隔的 0/1，按 sidecar `io.input` 绑定顺序），逐周期喂入；读尽后保持最后一行
+- `--step`：单步——采样 I 后逐指令打印（pc/fn/反汇编 + 执行后非零寄存器），跑 1 个周期，最后打印 I/Q
 - 每周期打印 `cycle N: I=[...] Q=[...]`（按 sidecar 绑定顺序）；故障打印 `FAULT(n)` 并退出码 1

 ## 职责