# agent-tree：历史性能与当前实现

核对日期：2026-10-06。本轮读取历史报告和当前源码；未重新压测、测试或演练回滚。

## 09-06 历史报告的准确含义

- API P95 最高 44.40 ms：各端点少量样本的本地结果。
- 100 并发的请求成功数为 100/100；吞吐 125–135 req/s。
- 表中 7.73 / 7.41 / 7.89 / 7.47 ms 等于每批总耗时除以请求数，不是独立测量的逐请求平均响应延迟。
- 条目创建样本 50/100/200 条对应 22.7 / 21.8 / 19.7 entries/s，约 20/s 是历史概括。不能据此证明当前批量接口或所有 SQLite 实现的硬上限。
- 0.31 / 0.34 MB 是 tracemalloc 采集的 Python 分配，不是进程 RSS、数据库或整个服务内存。
- WebSocket 50 次样本：P95 9.82 ms、均值 24.69 ms、最大 821.88 ms；长尾根因未定位。
- 142 智能体 / 636 任务 / 2,003 条目是报告中的数据规模，不能作为线上活跃量。

## 当前源码已具备

批量条目 API；HTTP X-Request-ID → ContextVar → 领域事件 trace_id；对应观测测试；分阶段发布及回滚设计。它们没有自动证明性能提升或真实灰度成功。关联 ID 也不是 OpenTelemetry 跨服务 span 链。

## 复现入口

在目标仓库、隔离环境使用 Python 3.11+：

```powershell
python -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt
.venv\Scripts\python -m uvicorn main:app --host 127.0.0.1 --port 8000
# 另开终端，在隔离测试数据库配置下验证
.venv\Scripts\python -m pytest -q
.venv\Scripts\python tests/run_performance.py
```

requirements.txt 固定了直接依赖版本，但不等同于包含传递依赖与哈希的完整锁。复测使用目标硬件、隔离数据和相同负载。附带 rollout 文档来自当前仓库，明确为设计稿，环境基线和观察窗口需审批后采用。

## 来源指纹

- `reports/performance_test_report.md` — SHA-256 `9ac66a8d8cd844ecc9ea975f29c6e49f4b41e029a7bf3bb30a73f072f8305bba`
- `docs/rollout.md` — SHA-256 `704a07b489801da879307e8313797592cc48d86459519c0e0374bfb6a0ec31a2`
- `app/observability.py` — SHA-256 `a1da64c171399f4b8f9f43dd809945ab7fac0580ffe66714404f060a4a6f12bc`
- `tests/test_observability.py` — SHA-256 `f5c539f52e0f3ef8d8733344ab08b5984b1f0f24a5e949a17c5b55f810858da2`
- `app/api/entries.py` — SHA-256 `de3851c34c176d56384b6207d61f8726735b4adb2a36b2c0b1650f8b3dbe0c60`
- `requirements.txt` — SHA-256 `9825c873276ebc263a27c5ffaa3df5a5f42311f0d024d962ee826be1c6e607f3`
- `docs/getting-started.md` — SHA-256 `56ab367b7f8495b48f7c7ef02bf0ccd308ed20ee4738a119659821c02a2edeaa`