============================================================
  脚本优化总结（2026-04）
============================================================

一、架构分离
────────────────────────────────────────────────────────────
· run_baseline.sh 成为唯一负责计算 GCC -O2 基线的脚本；
  其余所有脚本（lab3_build_test.sh、analyze_case.sh）只读
  TSV，不再重复运行 GCC，避免重复耗时。

· 基线输出目录镜像测试用例的相对路径结构，例如：
    output/baseline/test_case/functional/65_color.gcc.s
    output/baseline/class_test_case/h_functional/11_BST.gcc.s
  TSV 键与目录结构对齐：class_test_case/h_functional/11_BST

二、SysY → C 编译兼容性修复（run_baseline.sh）
────────────────────────────────────────────────────────────
· const int 全局数组维度问题
    C 模式下 const int N=10; int a[N]; 属于 VLA（非法于文件域）。
    用 Python3 预处理将 const int NAME=EXPR; 转换为：
      #define NAME ((int)(EXPR))
    同时支持多声明符写法：const int A=1, B=2;

· sylib 链接方式
    预编译 sylib.o（-x c），用 -include sylib.h 注入声明；
    链接命令用 -x none 在 .o 前重置语言标志，防止 ELF 被
    当作 C 源文件解析（stray '\177' 错误）。

· C++ 关键字冲突
    部分 SysY 测试用例用 delete/new/class 作函数名；
    -x c 模式下这些不是关键字，编译正常通过。

· 枚举浮点值
    enum { MAX = 1e9 }; 枚举成员必须是整数常量，Python3
    预处理同样将其转为 #define MAX ((int)(1e9))。

三、计时精度与准确性
────────────────────────────────────────────────────────────
· 全面弃用 /usr/bin/time：非零退出时会向输出文件写入
  "Command exited with non-zero status N"，污染时间值。

· 改用 date +%s%N 纳秒手动计时：
    _t0=$(date +%s%N)
    ... 运行命令 ...
    _t1=$(date +%s%N)
    elapsed=$(awk "BEGIN{printf \"%.5f\", $((t1-t0)) / 1e9}")

· 所有时间输出统一为 5 位小数（秒），加速比同样 5 位小数。

四、分段计时（verify_asm.sh + lab3_build_test.sh）
────────────────────────────────────────────────────────────
· verify_asm.sh 新增 --timing-out <file> 选项，运行结束后
  向文件写入：
    compile_ns=<纳秒>
    run_ns=<纳秒>

· lab3_build_test.sh 读取 timing 文件，将编译耗时与运行耗时
  分开显示：
    PASS  test_case/functional/65_color  [compile=0.31416s run=0.18804s]

· 加速比只使用运行时间（run_ns），排除编译器启动开销。

五、性能排行榜（lab3_build_test.sh）
────────────────────────────────────────────────────────────
· 测试结束后输出双排序表格：
    Sort 1：加速比升序（最需优化的用例排最前）
    Sort 2：我方用时降序（绝对耗时最高的排最前）
  每行格式：
    <用例名>          <我方时间>   <GCC时间>   <加速比>x

六、analyze_case.sh 修复
────────────────────────────────────────────────────────────
· 基线查找键从裸 stem（65_color）改为完整路径键
  （test_case/functional/65_color），与 TSV 格式对齐，
  消除 "WARNING: no baseline entry" 误报。

· run_and_time 函数的 rpt_color 输出重定向到 stderr，
  防止 ANSI 转义码被命令替换（$()）捕获后传入 awk，
  消除 "fatal: error: invalid character '\033'" 错误。

============================================================
  脚本列表
============================================================

run_baseline.sh       计算所有用例的 GCC -O2 基线，结果存入
                      output/baseline/gcc_timing.tsv
                      用法: ./scripts/run_baseline.sh [--update]
                        --update  清空重算全部条目

lab3_build_test.sh    构建编译器，跑全部用例，输出加速比排行榜
                      用法: ./scripts/lab3_build_test.sh

verify_asm.sh         验证单个用例的汇编正确性
                      用法: ./scripts/verify_asm.sh <input.sy> [input.in] \
                              [expected.out] [timeout] [--timing-out file]

analyze_case.sh       单用例深度分析（IR/ASM/计时/与基线对比）
                      用法: ./scripts/analyze_case.sh <input.sy> [output_dir]

clean_outputs.sh      清理 output/ 目录下的分析结果
                      用法: ./scripts/clean_outputs.sh

============================================================