new-api 供应网关 实施计划
为 OceanWay 提供内部模型执行、供应渠道与供应商协议适配，保持近上游更新能力
归档内容，只读，不代表现行方案。现行文档见文档总览。
目标与范围
为 OceanWay 提供内部模型执行、供应渠道与供应商协议适配，保持近上游更新能力。uumi 保持代码不变，提供现有标准模型响应、用量和请求 ID，维护自身网关账目；新平台客户身份、销售价格、计价与钱包由 Core 持有；既有 uumi 模型对接客户业务的部署和账务边界另行确定。
需求输入与确认
依据网关边界、网关专属接口和客户定价，核对已有渠道、模型映射、内部凭据、用量、请求 ID 和重试规则。现有 uumi 业务不能因“内部网关”定位自动移除。
设计与原型
设计 Edge→供应网关的服务身份、允许模型、错误/用量与请求关联。盘点 uumi 定制与上游差异，决定内网供应角色和既有客户业务是否分实例；不把客户钱包复制进新平台网关调用链。
API 与文档交付
优先保留 new-api 公共模型协议与供应适配。交付内部调用配置、模型映射表、现有响应用量语义/字段及缺失限制、既有日志异常核对权限/限流、流式样例、重试所有权和升级兼容报告；供应管理 API 留此仓，Console/Admin 只提供需要的维护入口。
实施步骤与交付物
| 步骤 | 实施内容 | 交付物与退出条件 |
|---|---|---|
| GW-01 现状盘点 | 固定版本，登记 uumi 定制、渠道、模型及客户业务边界 | 可追溯差异表与待迁移/保留范围 |
| GW-02 内部接入设计 | 内部凭据、模型映射、操作关联及现有 usage 能力 | 配置模板、字段支持矩阵和异常核对限制，不新增 uumi 代码 |
| GW-03 隔离兼容验证 | 普通/流式请求、错误、用量及请求 ID | Edge 可消费样例，供应重试边界明确 |
| GW-04 平台真实联调 | 请求受控透传，核验普通/SSE 响应的完整原始计量，Core 计算销售费用 | 标准响应兼容、可信用量持久关联；正常不查日志，缺证据待核对，不盲目重提 |
| GW-05 更新与运行 | 上游更新检查、配置备份、恢复与回退 | 升级不改 Core 客户价格，维护手册可执行 |
依赖与接入顺序
可先盘点和做隔离验证；真实平台调用依赖 Edge、Core 准入计费及环境配置。生产供应与旧客户迁移必须按发布迁移计划单独验收。
验收标准
- 供应凭据不下发给客户；平台调用权限受控。
- 供应请求、完整响应用量及平台操作可持久关联；重试由明确一方负责。
- 客户费用由 Core 的冻结销售规则计算，不叠加网关旧客户倍率；普通/流式响应不破坏 SDK，缺计量或断流后的可恢复性按实证记录，不承诺网关日志一定能找回。
- 上游升级不改客户价格与账务；uumi 现有客户按确认范围保留或迁移。
待定项与后续范围
uumi 模型对接客户最终去向、共享部署或拆实例、可用模型及配额、升级窗口待确定。当前推荐保留不等于已完成迁移决策。
本文定义计划，不累积执行日志。实际版本、完成状态和验证证据见项目进度；任务状态登记到本机工作台，并关联本文步骤。