用途:对 HTTP 接口做渐进式并发压力测试,在负载逐步升高时观察表现,找出崩溃点并输出报告。
主要能力:按并发阶段顺序压测每个接口,阶段之间等待 2 秒;采集每阶段指标,计算延迟百分位、吞吐曲线与上限、错误率及其起始点、崩溃点,并分类瓶颈;按模板生成 api-load-report.md,包含 ASCII 吞吐/延迟图和扩展表;报告后在控制台打印 3-5 行摘要并给出报告路径和关键问题。
必要用法:需要用户提供接口 URL(含方法、请求头、请求体)与期望延迟阈值;未指定阈值时默认 p50 < 100ms、p95 < 300ms、p99 < 1000ms。可选提供并发数或范围(默认从 1 爬升到 100)、认证信息、请求负载、自定义请求头、每阶段时长(默认 10 秒)、爬升模式(默认阶梯式、每阶段翻倍)、成功判定(默认 2xx)、已知限流、环境标签。工具按 hey、wrk、ab、curl 优先级选择;若前三种都不存在,可安装 hey(macOS:brew install hey;Linux 且有 Go:go install github.com/rakyll/hey@latest),或退回 curl 配合 bash 后台进程与 wait。使用前先用单个请求验证接口连通性与认证,再确认计划并执行。
限制与规则:未经明确确认不得压测生产环境;默认只测试 GET;需遮蔽认证令牌;遵守 429 限流;超时计为失败;不得超出已测试范围做外推。其余安全规则、错误处理与示例见附带的 rules-and-examples.md。具体默认阶段划分与指标清单见 tool-commands.md,指标解释见 metrics-interpretation.md,报告结构见 output-template.md。