mgsc-table-probe

name	mgsc-table-probe
description	分析香山 MGSC/SC 在前端微测试上的效果。适用于以下场景：(1) 用 off/l_only/g_only/i_only/full 等 A/B profile 批量运行 mgsc_test；(2) 比较不同 profile 下的 topMispredictsByBranch.csv 和 stats.txt；(3) 使用 bp.db 里的 MGSCTRACE 将每个分支的收益/损失归因到具体 SC 表；(4) 决定如何为 Global 或 IMLI 表设计新的测试。

MGSC 表探测

概览

运行标准化的 SC 表 A/B 实验，并产出分支级别的归因结果：

• summary.csv：case 级别的 off 与各 profile 的 delta 汇总。
• branch_delta.csv：分支级别的误预测 delta，以及 SC 修复/伤害与表贡献比例。
• report.md：便于人工快速阅读的排序报告。

这个 skill 的目标是快速迭代 SC 测试质量，而不是做完整的性能调优。

快速开始

1. 对所有 mgsc_test 二进制执行 probe：

python3 .codex/skills/mgsc-table-probe/scripts/mgsc_table_probe.py \
  --outdir debug/sc_table_probe \
  --profiles off,l_only,g_only,i_only,full \
  --max-workers 4

2. 快速检查单个 case：

python3 .codex/skills/mgsc-table-probe/scripts/mgsc_table_probe.py \
  --outdir debug/sc_table_probe_smoke \
  --tests fp_sc_alias_pair \
  --profiles off,g_only,i_only \
  --max-workers 1

3. 仅重建报告（不重新运行 gem5）：

python3 .codex/skills/mgsc-table-probe/scripts/mgsc_table_probe.py \
  --outdir debug/sc_table_probe \
  --profiles off,l_only,g_only,i_only,full \
  --skip-run

工作流

1. 基线 + 单表隔离 profile

• 始终包含 off。
• 在检查 full 之前，先加入单表 profile（如 g_only、i_only）。

2. 快速筛选有价值的测试

• 在 summary.csv 中，优先关注满足 condMiss_delta < 0 且 mgsc_net_use > 0 的 case。

3. 筛选有价值的分支

• 在 branch_delta.csv 中，优先关注满足以下条件的行：
  • delta_misp < 0
  • focus_decisive_ratio 较高
  • focus_agree_fix_ratio 较高

4. 决定下一步微测试方向

• 如果 g_only 很少带来改善，且 focus_decisive_ratio(g) 很低，说明 global-history 模式较弱。
• 如果 i_only 从未带来帮助，说明循环/迭代相位信号暴露得还不够。
• 可以参考 references/test-patterns.md 里的模式来编写下一个测试。

输出

• debug/sc_table_probe/summary.csv
• debug/sc_table_probe/branch_delta.csv
• debug/sc_table_probe/report.md
• debug/sc_table_probe/report.json

关键参数

• --profiles：从 off,l_only,g_only,i_only,full 中选择。
• --tests：逗号分隔的测试名（不带后缀），例如 fp_sc_alias_pair,imli_iter。
• --extra-param：透传额外的 gem5 --param。
• --copy-cpt-to-tmp：避免路径访问问题。
• --skip-run：仅生成报告，不执行运行。

注意事项

• 除非你明确要评估交互效应，否则在做 SC 子表归因时应保持 microtage 关闭。
• 不同 profile 之间必须使用同一组 checkpoint，否则 delta 无效。
• 做 branch PC 映射时，使用 mgsc_test 构建目录下的 *-riscv64-xs.txt 反汇编文件。

参考资料

• 关于面向 G/IMLI 的微测试模式，参见 references/test-patterns.md。