# 协作存储压测套件（U7）

方案 §3 负载合同 / §5 U7 的业务压测入口。**只打隔离栈**（自建 PG 实例 +
mock 模式 backend），绝不打生产服务；模拟模型（mock）用于容量基线，真实
模型的全链路验证按方案另行小流量执行。

## 组成

| 文件 | 职责 |
|---|---|
| `run_load.sh` | 编排入口：起隔离栈 → 引导账号 → k6 阶梯 → SSE 探针 → 不变量对账 → 回收 |
| `k6/collab_api.js` | 非模型普通 API 的混合读写负载（登录/项目/会话/卡片/设置/消息，requestId 幂等重放抽样；预期 409/429 单列计数） |
| `sse_probe/` | SSE 持久事件可见延迟探针（Go）：k6 核心不支持 SSE 流式读取，P95≤1s 指标由此承担，含 seq 单调性断言 |
| `results/<ts>/` | 每次运行的原始输出：`k6-summary.json`、`k6-output.txt`、`sse-probe.json`、`invariants.txt`、`app.log` |

## 快速开始

```bash
# 冒烟（~2 分钟，无需 k6——缺失时自动跳过 k6 段并给出安装指引）
tests/load/collaboration/run_load.sh --profile smoke

# 阶梯（10→30→100 VU，~12 分钟；k6: brew install k6）
tests/load/collaboration/run_load.sh --profile ladder --users 30

# 长稳（60 分钟 / 2 小时混合，负载合同的两个正式窗口）
tests/load/collaboration/run_load.sh --profile sustained60m
tests/load/collaboration/run_load.sh --profile sustained2h

# 复用已有隔离 PG；保留栈便于复查
tests/load/collaboration/run_load.sh --dsn 'postgresql://…/agent' --keep
```

## 阈值与口径（负载合同，待实测校准）

- 非模型普通 API：读路径 P95≤300ms、P99≤1s（k6 threshold 按 `read` 组单列）。
- 非预期失败率≤0.1%（`http_req_failed<0.001`）；预期拥塞（会话忙 409 /
  队列满 429）记入 `expected_contention` 计数器，**不**计入失败。
- SSE 持久事件可见延迟 P95≤1s + seq 零乱序（探针退出码即断言）。
- 数据不变量零违反：events 每会话 seq 无重复（SQL 对账，违反即 exit 1）；
  各表计数与孤儿 run 报告落 `invariants.txt`。

## 边界（诚实声明）

- 首期为**单实例**压测（mock 模式、执行原语关闭）；分布式限流窗口与双实例
  放行指标在双栈就位后扩展（`--dsn` 复用 + 第二实例待加）。
- 容量数字（连接等待、CPU/内存/IO、pgbench 数据库基线）须绑定组件 SHA、
  配置与数据集记录在结果目录；`pgbench` 只测数据库能力，不替代本套业务
  验收（方案 §5 U7）。
- 正式 60min/2h 窗口的执行与双主机验证需要用户指定资源与时间；本仓提供
  的是可复核入口，不预填容量结论。