面向编码代理的 LLM 网关路由：策略、兼容与故障切换

为每类工作流声明请求响应协议、流式事件、工具语义、上下文需求、认证所有者、数据区域、允许模型、预算等级和失败行为。只有满足完整契约的路线才有资格被选择。

用户别名与上游模型 ID 分开维护。别名通过版本化策略解析，并产生可观察的实际路线，同时不暴露凭据。

一次文本请求成功，只能证明该请求本身。认证、模型发现、非流式输出、流式结束、错误映射、取消、工具调用、用量报告和长任务行为必须分别测试。

记录网关进行的每项转换。丢弃未知字段、缓冲流、重写模型名称或统一错误结构，即使 HTTP 成功也可能改变客户端行为。

客户端使用有限凭据向网关认证；网关在秘密存储中持有供应商凭据，并在服务端执行租户、项目、模型与速率策略。任何响应和日志都不能返回上游 Token 或 Authorization Header。

只允许回退到满足相同能力、策略和数据边界的路线。限制尝试次数与总时间，避免重放改变状态的工具操作，并明确暴露发生过回退。有些错误应停止，而不是静默换模型或供应商。

记录客户端版本、网关 release、路线策略版本、别名映射、协议转换和验证日期。任一项变化后重跑能力套件，分阶段发布，并为破坏流式、错误、工具或计费的路线保留快速禁用入口。