用途:把 C++ 性能工作从直觉判断转为基于基准测试的决策,适用于分析 CPU/内存热点、优化前后对比以及性能回归把关。
主要能力:建立可复现基线(记录编译器、编译选项、CPU 环境、线程绑定与数据集规模);区分计算、内存带宽、缓存未命中、分支预测失败、分配与锁竞争等热点类别;按端到端影响而非微基准差值排序;针对内存受限路径调整数据布局与分配,针对计算受限路径简化算法与分支,针对竞争减少锁范围、分片或使用无锁结构;每次优化独立并单独基准测试;用显式回归阈值对比当前与基线,标记统计可疑或高方差结果;输出包含实测差值、受影响文件、权衡与风险以及可复现基准命令的交接报告。
使用方式:先跑基线基准,再定位热点类别并做针对性优化,最后用比较脚本验证。示例命令:python3 scripts/compare_benchmark_json.py --baseline <baseline.json> --current <current.json> --metric cpu_time --regression-threshold 5.0。非零退出视为阻塞性回归。输出契约要求返回基线上下文、发现(含实测差值的回归/改进)、优化计划、验证命令与回归门禁、残余风险。
限制:不得在无前后测量时声称性能提升;各次运行需保持基准环境可比;需区分微基准收益与端到端影响;超过阈值的回归应作为阻塞项上报。参考文件包括 references/workflow.md、references/optimization-playbook.md、references/signoff-template.md。