topic5: docs

.github/workflows/ci.yml

@@ -84,6 +84,16 @@ jobs:
             --junit-xml=benchmark_reports/test_results.xml \
             --ignore=tests/test_simulator.py
 
+      - name: Run assembly-beautifier regressions
+        run: |
+          python3.12 -m pytest \
+            tests/test_parser_for_beautifier.py \
+            tests/test_asm_beautifier_comments.py \
+            tests/test_asm_beautifier_formatting.py \
+            tests/test_asm_beautifier_integration.py \
+            tests/test_asm_beautifier_blackbox.py \
+            -v --tb=short
+
       - name: Run constant-merge regressions
         run: |
           python3.12 -m pytest \
@@ -208,7 +218,19 @@ jobs:
             python3.12 scripts/gen_minimal_cnn.py 2>&1
           fi
           python3.12 scratchv/standalone/onnx_to_riscv_standalone.py \
-            "$MODEL" -o /tmp/cnn_riscv.bin --estimate --report --const-merge
+            "$MODEL" -o /tmp/cnn_riscv.bin \
+            --asm benchmark_reports/cnn_scratchv.s \
+            --estimate --report --const-merge
+
+      # ── 3.3.1 汇编美化器：真实 CNN 输出 + Actions Summary ───────────
+      - name: CNN assembly beautifier benchmark
+        run: |
+          python3.12 -m benchmarks.bench_asm_beautifier \
+            --input benchmark_reports/cnn_scratchv.s \
+            --output-asm benchmark_reports/cnn_pretty.s \
+            --markdown benchmark_reports/asm_beautifier_summary.md \
+            --json benchmark_reports/asm_beautifier_summary.json \
+            --repeats 20
 
       # ── 3.4 LLVM vs ScratchV + TinyFive + Dashboard ──────────────────
       - name: LLVM vs ScratchV comparison
@@ -324,6 +346,10 @@ jobs:
             cat benchmark_reports/github_summary.md >> $GITHUB_STEP_SUMMARY
           fi
           echo "" >> $GITHUB_STEP_SUMMARY
+          if [ -f benchmark_reports/asm_beautifier_summary.md ]; then
+            cat benchmark_reports/asm_beautifier_summary.md >> "$GITHUB_STEP_SUMMARY"
+          fi
+          echo "" >> "$GITHUB_STEP_SUMMARY"
           echo "### LLVM vs ScratchV" >> $GITHUB_STEP_SUMMARY
           if [ -f benchmark_reports/llvm_vs_scratchv.md ]; then
             tail -20 benchmark_reports/llvm_vs_scratchv.md >> $GITHUB_STEP_SUMMARY