用途:为 Rust 自学习记忆系统提供基准测试与性能优化支持,适用于改动前后对热点路径做基准、剖析 CPU/内存瓶颈、验证性能提升以及在 CI 中检测性能回归。
主要能力:涵盖 Criterion 基准模式与剖析、CPU/内存优化策略,以及 perf、flamegraph、tokio-console 等剖析工具。资料给出关键指标目标(P95)与典型值:Episode Creation < 50ms(约 2.5 µs)、Step Logging < 20ms(约 1.1 µs)、Episode Completion < 500ms(约 3.8 µs)、Pattern Extraction < 1000ms(约 10.4 µs)、Memory Retrieval < 100ms(约 721 µs)。
使用方式:运行全部基准用 cargo bench;运行指定基准用 cargo bench --bench retrieval_quality;保存与对比基线用 cargo bench -- --save-baseline main 和 cargo bench -- --baseline main。CPU 剖析用 perf record -g cargo bench 与 perf report;火焰图用 cargo flamegraph --bench retrieval_quality;异步用 RUSTFLAGS="--cfg tokio_unstable" cargo build 后运行 tokio-console。
优化模式:热点路径避免异步阻塞(CPU 密集用 spawn_blocking)、减少锁竞争(parking_lot::RwLock 替代 std::sync::RwLock)、零拷贝、批处理;内存方面可用 arena 分配、缓存友好数据布局、字符串驻留。
验证与限制:声称性能改进前需确认基准有可测量提升、其他基准无回归、内存未显著增加,并用真实数据规模测试。CI 质量门要求基准退化不超过 10%,cargo bench 在 nightly CI 运行。基准位于 benches/,相关文档为 docs/QUALITY_GATES.md。