Files
group_fqcd_jr/tools/smoke_check.py
T
lzf_0626 6516ccb385 feat: 第二版——接口契约对齐 docs/05,修复静默故障与数据库基线
相对第一版 46fc976 的完整变更。组员迁移对照表见 docs/20。

一、对外契约对齐 docs/05(破坏性,共 4 处,组员需按 docs/20 调整)
1) 配置发布端点改为文档规定的复数资源名:submit→validations、
   approve→reviews(需 body decision)、activate→activations、
   rollback→rollbacks;第一版这 4 个动词式路径 docs/05 从未定义过。
2) 错误码由 8 个笼统码改为 15 个具体语义码(FORBIDDEN→AGENT_PERMISSION_DENIED、
   UNAUTHORIZED→AUTHENTICATION_REQUIRED、CONFLICT→RESOURCE_VERSION_CONFLICT、
   RESOURCE_NOT_FOUND→RUN_NOT_FOUND/SESSION_NOT_FOUND 等),
   输入类错误状态码 400→422。
3) POST /api/v1/agent-runs 与 GET /api/v1/agent-runs/{run_id} 统一为
   {data, meta} 信封(data 内字段名与语义未变)。
4) 错误响应体统一为 {error:{code,message,retryable,field_errors}, meta:{trace_id}},
   不再返回 FastAPI 默认的 {"detail": ...}。

二、数据库基线与约束
新增 39 张表的基线迁移(链根)与联合唯一键纠偏(4 张表、删 8 增 4,幂等收敛);
撤下 config_release 的双人复核 CHECK(应用层已允许自审,审核节点保留,
自审如实写入 reviewer_id);记忆 active key 生成列与唯一键;
activate 开始记录 supersedes_release_id 使版本链可追溯。
docs/00 基线未修改,未重命名或删除任何表与字段。

三、修复会静默出错或无报错的缺陷
- 跑完集成测试后平台会静默失去生效配置:清理只删自己创建的版本,却没有恢复被它
  顶成 superseded 的原生效版本,且审计一并删除因而完全无痕,表现为所有工具被拒
  但没有任何报错。已修清理逻辑并加恢复。
- Worker 单轮异常导致进程退出;记忆抽取调用方的“事务已开始”异常;
  召回缓存丢失 degraded 标记;连接时区未生效导致 created_at/updated_at 差 8 小时;
  .env 与 os.getenv 密钥来源分裂导致“没有可用的已批准模型端点”。
- 记忆信号识别漏判与跨键误命中;SSE 未带 Accept 的协商行为。

四、功能补齐
记忆链路 P1/P2/P3(抽取、受控词表、召回与缓存、生命周期级联及投影事件)、
fin_* 场内交易只读 ORM 层、agent_intent_config 状态流转并在运行期真正生效、
限流(Redis 固定窗口、故障一律放行)、游标校验、trace_id 中间件、
示例业务 Agent fund_query_demo 与一键端到端验证脚本,以及审计/指纹/迁移状态工具。

五、文档与验证
新增 docs/19(业务 Agent 接入实操)、docs/20(第一版迁移指南)与 docs/evidence 证据;
docs/01/02/06/08/09/17 同步实现现状。

验证结果:ruff 通过、mypy 103 文件无错、unit+contract 447 passed、
integration 29 passed、acceptance_check --production 7 PASS、
demo_agent_e2e 9/9 PASS(含失败关闭反证)。
2026-09-10 15:55:54 +08:00

152 lines
5.3 KiB
Python
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.
"""底座接口冒烟测试:认证、越权、幂等、SSE 传输。
用法:先启动 `python -m uvicorn app.main:app --port 8099`,再运行本脚本。
"""
from __future__ import annotations
import datetime as dt
import uuid
from pathlib import Path
import httpx
import jwt
BASE_URL = "http://127.0.0.1:8099"
PRIVATE_KEY = Path("config/jwt/jwt-private.pem").read_text(encoding="utf-8")
_results: list[tuple[str, str, str]] = []
def record(name: str, expected: str, actual: str) -> None:
verdict = "PASS" if expected == actual else "FAIL"
_results.append((verdict, name, f"期望 {expected} / 实际 {actual}"))
def token(sub: str) -> str:
now = dt.datetime.now(dt.UTC)
return jwt.encode(
{
"sub": sub,
"iss": "jr-local",
"aud": "jr-agent-platform",
"exp": now + dt.timedelta(minutes=30),
"nbf": now - dt.timedelta(seconds=5),
"jti": str(uuid.uuid4()),
},
PRIVATE_KEY,
algorithm="RS256",
)
def headers(sub: str) -> dict[str, str]:
return {"Authorization": f"Bearer {token(sub)}"}
def payload(
agent_type: str,
key: str | None = None,
message: str = "冒烟测试消息",
session_id: str = "smoke-session",
) -> dict:
return {
"agent_type": agent_type,
"message": message,
"session_id": session_id,
"idempotency_key": key or uuid.uuid4().hex,
}
def main() -> None:
# trust_env=False:绕开 Windows 注册表代理设置,直连本地服务
with httpx.Client(base_url=BASE_URL, timeout=10, trust_env=False) as client:
r = client.post("/api/v1/agent-runs", json=payload("customer_service"))
record("无 token 调用", "401", str(r.status_code))
r = client.post(
"/api/v1/agent-runs",
json=payload("customer_service"),
headers={"Authorization": "Bearer not-a-jwt"},
)
record("无效 token", "401", str(r.status_code))
r = client.post(
"/api/v1/agent-runs",
json=payload("customer_service"),
headers=headers("9001"),
)
record("合法用户创建 customer_service run", "202", str(r.status_code))
# 文档 §3.3/§6.2:受理响应是 {data, meta} 信封。
run_id = r.json().get("data", {}).get("run_id") if r.status_code == 202 else None
r = client.post("/api/v1/agent-runs", json=payload("risk"), headers=headers("9001"))
record("普通客户调用 risk Agent(越权)", "403", str(r.status_code))
if r.status_code == 202:
risk_run_id = r.json().get("data", {}).get("run_id")
detail = client.get(f"/api/v1/agent-runs/{risk_run_id}", headers=headers("9001"))
record(
"越权 run 是否真的落库",
"未落库",
f"已落库 agent_type={detail.json().get('data', {}).get('agent_type')}"
if detail.status_code == 200
else f"GET {detail.status_code}",
)
r = client.post(
"/api/v1/agent-runs", json=payload("no_such_agent"), headers=headers("9001")
)
record("未注册 agent_type", "400", str(r.status_code))
r = client.post(
"/api/v1/agent-runs", json=payload("customer_service"), headers=headers("not-a-number")
)
record("sub 非数字(应 4xx 而非 500)", "400", str(r.status_code))
if run_id:
r = client.get(f"/api/v1/agent-runs/{run_id}", headers=headers("9002"))
record("用户 2 读取用户 1 的 run", "404", str(r.status_code))
sse_events: list[str] = []
try:
with client.stream(
"GET",
f"/api/v1/agent-runs/{run_id}/events",
headers=headers("9001"),
timeout=8,
) as stream:
content_type = stream.headers.get("content-type", "").split(";")[0]
record("SSE Content-Type", "text/event-stream", content_type)
for line in stream.iter_lines():
if line.startswith("event:"):
sse_events.append(line.split(":", 1)[1].strip())
if len(sse_events) >= 2:
break
except httpx.TimeoutException:
pass
record("SSE 首个事件", "start", sse_events[0] if sse_events else "8 秒内无事件")
key = uuid.uuid4().hex
idem_session = f"smoke-idem-{key[:12]}"
client.post(
"/api/v1/agent-runs",
json=payload("customer_service", key, session_id=idem_session),
headers=headers("9001"),
)
r = client.post(
"/api/v1/agent-runs",
json=payload("customer_service", key, message="不同内容", session_id=idem_session),
headers=headers("9001"),
)
record("同幂等键不同请求体", "409", str(r.status_code))
width = max(len(name) for _, name, _ in _results)
print()
for verdict, name, detail in _results:
print(f"[{verdict}] {name.ljust(width)} {detail}")
failed = sum(1 for verdict, _, _ in _results if verdict == "FAIL")
print(f"\n合计 {len(_results)} 项,失败 {failed} 项")
if __name__ == "__main__":
main()