02 决策(ADR)
ADR-0003 媒体供应路线
背景
媒体供应的路线多次反复:9-30 定为摆脱 new-api,10-14 又改为复用 new-api 插件;文档站则写 media-gateway "不是当前新主链",而该仓库仍在密集开发。
决策
- new-api-new-oceanway 定为遗留平台:继续承担当前线上图片/视频供应,只做维护和必要修复,不再扩展新能力。
- oceanway-media-gateway 定为目标主链:作为后续图片/视频供应的唯一投入方向,开发完成并通过切换验收后,替换 new-api-new-oceanway。
- 过渡期:切换之前,遗留平台持续服务,Platform 仍通过现有适配器调用它;切换按渠道或能力分批进行,每批都要有回滚方案。
- media-gateway 是否兼容 new-api 插件机制,属于 media-gateway 内部的实现选择,不影响本决策;如需调整另开 ADR。
切换条件(2026-10-16 zao 确认)
- 现有线上渠道和模型在 media-gateway 上的功能与价格对齐。
- 在途任务、结果存储和计费对账都经过验证。
- 有灰度和回滚方案,并经 zao 确认。
后果
- 新渠道和新功能只在 media-gateway 开发。
- 文档:03_平台/04_媒体供应以 media-gateway 为主;new-api 的说明标为 Deprecated,切换后归档。
- 删除 media-gateway README 顶部的日期式决策段落,改为链接本 ADR。