← 项目档案

作品 / RelayAudit / AgentGuard

让 Agent 中转链路里的异常,有迹可循。

打开交互工作台

开源本地网关 / HTTP 与 SSE 协议检查

围绕已有 AI 接口的故障排查,我实现本地 HTTP / SSE 网关,把请求转发、独立观察、容量拒绝和异常报告分开处理。交付重点是复现失败、保留依据、确认恢复,而不是只展示一次成功响应。

本站展示合成报告,实际转发需要运行本地工具。目前不具备经过校准的真实模型身份识别能力;所有模型身份状态保持未验证。

ARTIFACT / 02本站报告检查器的真实浏览器截图,字段来自 2026-10-23 合成 fixture 报告;不是实时网关监控,也不能确认模型身份。查看结果与说明
已有公开材料 · 范围与来源见正文

01这是什么

接入 AI 接口之后,还需要回答:流在哪断开、请求是否到达上游、观察是否完整、故障后能否继续使用。

我把责任分开:网关负责传递 HTTP / SSE 与明确的传输状态;观察器记录允许保留的协议元数据;使用者根据报告继续排查。告警不进入模型响应,标签异常也不直接升级为真实模型身份结论。

交付与验收:本地固定路由网关、事件与报告、隔离接入和退出步骤、容量配置与恢复回归。先检查已有合成报告,再按运行命令复现流式中断、超限拒绝和名额释放;本站检查器只读取报告。

02看结果

已经有可复现的合成链路演示。

2026-10-23 按公开命令实际运行了本机模拟 Agent 与模拟中转:3 次请求、3 次上游转发、0 次额外模型请求,标签变化后产生一条告警,后续请求继续完成。下面是这次生成的原始报告排版截图。它证明本次合成告警路径,不证明真实中转商更换了模型。

实际合成报告:mock-model 标签变成 mock-other,声明模型不一致,真实身份仍未验证
实际命令输出的排版截图 · synthetic_unverified打开原图 ↗

03我做了什么

我的责任覆盖协议接入、请求生命周期、可观测性与退出恢复。

接口与凭据:我实现 Responses、Chat Completions 与 Anthropic Messages 的 JSON / SSE 转发,处理两向连接级头部过滤,并分离本地认证与上游凭据。调用方可以使用隔离配置接入,而不覆盖原有订阅登录。

生命周期:我处理超时、取消、流式背压和在途容量,让请求体读取、上游调用和完整 SSE 共同占用一个名额,完成或异常结束后释放。

观察与交接:我把解析、检测和报告放在独立的有界队列中,显式记录观察丢失与真实传输终止原因;同时保留状态、容量、报告与退出恢复命令。报告只保存白名单元数据,不持久化用户提示词、回答或认证头正文。

转发与容量实现 ↗ · 实体保真与凭据隔离测试 ↗

04工程判断

01 / 容量覆盖完整请求,而不只限制建立连接

SSE 仍在输出时,请求还占用资源,因此名额保持到完整流结束。满额时,新请求在本地返回 503 与 Retry-After,不触达上游;已有流继续处理。挂起 SSE、上游计数和释放后再次请求共同验证这条边界。

02 / 业务转发与观察失败分开报告

响应字节先转发,再交给有界观察队列。观察队列拥塞可以减少证据量,但必须显示 monitoring_degraded;超时、取消等真实传输原因仍保留。这样才能区分“业务请求失败”和“监测证据不完整”。

03 / 告警描述可见现象,身份结论保留证据门槛

模型声明变化是标签不符合预期,协议错误也可能来自参数或网关。项目始终保留 identity_status=unverified;默认被动模式不追加模型请求。可选复核需要单独配置和正数请求预算,不能把请求数预算当作金额硬上限。

容量与恢复约定 ↗ · 隐私与检测边界 ↗

05验收与交接

验收一条调用链,要同时检查正常响应、失败状态和恢复后的下一次请求。

可从一个受控端点开始:明确协议、请求形态和脱敏样例,比较直连与网关的响应实体;挂起一条 SSE,确认新增超限请求未到上游,再释放连接并重新请求;另行核对观察丢失、超时和取消的报告。交接时留下接入、容量参数、报告位置与退出方式。

已有证据:公开合成演示保留原报告、来源记录与后续请求;本地测试覆盖协议实体、凭据隔离、取消、超时和容量释放。真实客户端到模拟端点的接入记录与压力记录分别注明测试环境。

这些证据证明受控环境中的传输和排查机制,未建立客户生产容量、真实中转站模型身份指纹或校准准确率。被动模式仍有开销;原生 WebSocket、完整 IDE 覆盖与生产进程监督也不在当前实现内。

06深入查看

2026-10-21 的受控测试与本地接入记录包含请求、响应两向的连接级头部过滤修复;不据此判定模型身份。 查看修复与 CI 记录 ↗

后续回归覆盖取消、超时、背压、非法 Content-Length 与并发。观察队列丢失时仍保留已知的真实传输终止原因,不把超时或取消改写成“不可观察”。

2026-10-21 的合成 JSON/SSE 负载比较直连、关闭观察与完整 passive。C1每模式100次、C8每模式200次:实体哈希一致,额外请求、HTTP/实体错误与队列丢失均为0。开销没有被隐藏:本机 C8 SSE 的 p95 从直连9.126ms变为完整观察21.178ms;这是固定顺序的 loopback 小样本,不是生产容量或低开销保证。

python evals/run_acceptance.py --out acceptance-new --requests 100 --concurrency 1
python evals/run_acceptance.py --out acceptance-c8 --requests 200 --concurrency 8

流式修复、原始指标与 CI ↗ · 五分钟合成演示与下载步骤 ↗

上述负载指标属于 2026-10-21 的历史记录,本次网站改造没有重跑完整压力比较。2026-10-23 只复跑了三请求的合成告警演示,不能据此新增性能或模型识别准确率声明。

2026-10-30 已合并的容量控制由挂起 SSE、拒绝新增请求与恢复测试 ↗覆盖;可核对对应提交的 CI ↗。请仅在有权使用的 API 与本机环境中复现。

网关运行:容量、503 与恢复

对请求读取与完整 SSE 连接设置在途容量,超限明确返回 503;用挂起流、上游请求计数与恢复回归检查已有连接和故障隔离。

查看实现、命令与回归范围 ↗

WORK TOGETHER / 合作入口

把接口故障变成可排查的问题。

说明接口类型、失败现象与可复现步骤,准备脱敏请求样例或日志。先明确观察范围,再讨论接入与恢复方式。