tsl-playbook/.agents/performance.md

32 lines
949 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 性能Performance
本文件定义代理在做性能相关改动时的准则与检查项。
## 1. 目标与度量
- 明确性能目标延迟、吞吐、内存、CPU、I/O 等。
- 没有指标时不要盲目优化;先补充测量或基准。
## 2. 处理流程
1. 先定位瓶颈profile/trace/log
2. 再提出最小化改动方案。
3. 最后用数据验证收益与副作用。
## 3. 优化准则
- 优先消除算法/结构性问题,再考虑微优化。
- 避免引入复杂度换取小收益。
- 性能优化不应牺牲可读性;必要时加注释说明权衡。
## 4. 常见风险
- 避免重复计算、无界缓存、隐式复制。
- 注意热路径中的分配与 I/O。
- 并发优化要考虑正确性与可测试性。
## 5. 验证
- 提供优化前后可复现的对比数据(基准、采样结果或压测报告)。
- 若无测试体系,至少提供最小可运行的复现脚本/步骤。