MG-01-003 当前边界与重做方向

2026-10-16 图片标准协议与渠道接入修正（现行）

用户明确图片上游按各家标准协议接入：GPT 图片使用 OpenAI 生图接口，Gemini 使用 Gemini 原生接口；渠道类型、上游型号拉取与标准调用名到上游精确名的映射参考 new-api。此决定取代“全部图片渠道只能选择 new-api/OpenAI 兼容协议”的界面限制；供应商使用 new-api 不代表其 Gemini 型号必须走 OpenAI 生图请求。每 Key 独立渠道、标准型号/参数目录、系列调度、凭据与供应健康职责保持。

MG-IMAGE-14 修正协议选择和别名发现/关联。管理员读取完整 Key 目录，未识别类型的上游型号保留为未分类，由管理员明确关联标准图片型号；目录读取不确认生成能力、不覆盖标准参数、不启用供给。代码与真实供应验收、公共图片入口及生产切流仍分别记录。

2026-10-14 图片模型渠道管理决定

用户确认：图片模型的渠道管理较简单，直接与 new-api 原生渠道管理保持一致。图片渠道采用该管理方式；视频继续沿用已确认的规格供给、调度与视频插件设计。具体管理范围见 领域与配置，本次文档任务见 MG-IMAGE-02。

管理方式复用后仍使用本网关的独立管理员会话、供应凭据和配置存储。客户身份、售价、钱包与结算继续归 oceanway-platform。此决定明确图片渠道的设计方向；图片运行接入与验收状态仍按 MG-IMAGE-01 记录，不表示图片生成入口已开放或已部署。

2026-10-15 后续图片决定与已实现状态

用户随后确定所有图片上游采用 new-api，每个 Key 独立渠道，同一标准模型支持多渠道、调度顺序、采购成本及并发。原生图片渠道、真实调度配置/只读预览和按上游/模型切换视图已由 MG-IMAGE-06、MG-IMAGE-07 合入 main；契约见 图片调度。此后续决定优先于历史渠道级直供或“尚未实现渠道管理”的表述。新供给仍须真实验收，公共图片执行入口、Origin原生异步和生产切流不因管理功能完成自动开放。

2026-10-16 标准模型与渠道职责（现行）

用户确认移除全局“同步渠道参数”。模型目录按标准型号统一维护参数与规格组合，供其他服务生成配置表单；渠道只同步该Key支持的型号并关联标准模型，不自动创建或覆盖标准参数。渠道的采购成本、并发、调度与执行能力限制仍由本网关维护，渠道变化不改标准参数。MG-CATALOG-07以持久化组合及显式一次冻结保留旧参数，契约见MODEL_CATALOG。旧MG-CATALOG-03自动投影说明不再作为现行行为。

2026-10-16 图片系列与上游分组决定

用户要求图片按Grok/Gemini/GPT等系列管理调度，供应商详情左侧系列/右侧Key分组，配置Key可调用的1K/2K/4K范围。系列按分辨率排序与回退，具体型号及原请求保持精确；统一模型目录继续持有具体型号及参数。后续更正：1K/2K共用一档，4K另档；仅系列所有登记成员均有明确、完整的标准分辨率区分才分档，未知/部分明确/自由尺寸则统一调度，不按系列名称猜测（MG-IMAGE-13）。实现/验证边界见MG-IMAGE-11/13及图片调度契约，仍不代表图片公共入口、真实收费验收或生产切流完成。

2026-10-01 统一平台职责更新（现行）

现行依据为文档站 /docs/overview/decisions、/docs/platform/relay 与 /docs/products/shared-runtime。Core/Edge/Contracts 已冻结，目标视频链路为 oceanway-platform → 媒体网关 → Provider，不经过 uumi。平台持有客户身份、售价、唯一钱包、客户任务和结果授权；产品工程持有创作项目、长期素材与业务任务；本网关持有供应凭据、调度、成本、Provider 任务和供应结果。

产品上传及长期素材存储由产品工程公共模块提供，不恢复统一 Core 文件接口。网关供应结果由平台核验客户归属后交付，产品按授权登记长期素材；复制与保留期限待验证，不修改已有桶、在途任务或历史文件。供应后台独立管理，首期不接入平台 Admin。

本次仅更新职责文档，接口与账务联调未执行。新任务应使用上述边界；下方旧 Core 接入、统一文件存储方案及 FS/OMG 编号仅描述历史计划或实现证据，不作为新平台前置。

2026-09-30 用户最新决定：文档确认后开始系统重做

用户明确要求摆脱 new-api 平台依赖，直接提取旧视频网关的相关可用代码，并先写文档、理清完整逻辑，再做实现。 重做目标链路为调用方 → 独立媒体网关 → Provider，不要求 new-api 参与运行、登录或数据库。 默认调度已确认人工排序为主、同级比较成本。同日进一步确认：首轮无日常视频工作台，站内可真实测试；普通配置不二次确认，移除等大范围动作确认；配置一次重试时 A/x 明确失败后 B/x，同请求调用方只计一次、上游费用分别记录；单管理员密码登录及刷新保持会话；全部历史永久保留，并支持从旧平台只读迁入数据。详细设计及尚未定稿政策以 重做文档入口 集中记录；用户随后已确认开始制作；MG-BUILD-01 实现首批独立管理员会话、原子渠道配置与编辑界面。全部调度、持久真实测试与全历史迁移仍按工作包推进，不将首批界面等同于系统完成。

运行代码仍沿用既有视频供应边界。客户账务/产品 Workflow 不因重做自动搬回本服务；旧任务、在途执行、归档渠道和对象引用保留。历史导入保留原身份/时间/费用单位，默认只读且不执行旧任务或旧结算；旧用户/账务可作为历史档案，不恢复对应运行入口。 下文 2026-09-12 的全系统拓扑及待联调项是既有方案记录，不能用其中 new-api 中间层阻止本轮独立网关设计。

新渠道按原生 Go adapter 接入：停止动态插件开发/安装/绑定，保留历史数据和在途任务兼容。相同协议复用适配器，流程见 原生接入规范。 既有实现记录：2026-09-18 对齐 2026-09-12 全系统决定；重做方向以上方用户最新决定为准。 取代 cdea9a9 的 2026-09-05 边界；不以分支名称决定文档优先级。

历史架构依据（不覆盖现行职责）

全系统 D-RESTORE-FIRST-POLYREPO、D-GATEWAY-UPSTREAM-BOUNDARY、D-NEWAPI-REUSE-FIRST、 D-CONTRACTS-CONTENT-REPLACEMENT 和用户本轮明确指令优先。来源路径与 SHA-256 见 来源记录。

既有职责与历史目标调用链

异步目标：产品 → Core / 同仓独立进程 Worker → new-api 供应网关 → 媒体网关 → Provider
同步目标：客户/产品 → API Edge → new-api 供应网关；Edge 向 Core 授权、预留、结算

这是此前目标拓扑，未完成 Core/new-api 联调；本次独立网关重做不以它为前置，也不能描述为已接通。

• Core 持有新平台客户身份、客户 Key、销售目录、客户价格、费用预留与结算、客户任务归属和客户侧恢复。
• 产品仓持有 Workflow、分镜、批次、画布和产品私有业务；不搬进 Core 或媒体网关。
• 此前方案以 new-api 为统一供应入口，本次独立媒体网关不要求该中间层。既有 uumi 模型对接客户业务单列，不擅自删除、迁移或合并账务。
• 媒体网关持有供应凭据、Channel/Supply、能力与采购成本、选路、健康/容量、供应重试、 Provider Adapter、视频 Dispatcher/Poller/Reconciler、结果获取与供应执行证据。
• Core Worker 查询网关任务、协调客户状态与费用；不重复实现 Provider 轮询。
• 三层不得各自因超时、断流或租约到期再次提交同一付费任务。提交未知必须先核对。

既有代码范围（实现证据，需按现行边界联调）

保留 OpenAI/ModelArk 视频兼容接口、私有服务认证、视频供应管理 UI 和成熟执行内核。 本次不将完整 B1、Execution Manifest、Route Binding、Observation 或固定 Run/Step/Attempt 体系设为合并前置。Contracts 按真实消费者补版本化切片，不凭空宣布已发布或已联调。

当前验收只覆盖内部视频；历史图像模块保留且未挂载。图片/音频扩展单列。 历史客户、售价、账户、资产表和模块仅用于兼容旧记录/外键，不能恢复成新客户平台。 供应管理 UI 保留，员工授权与统一管理入口是后续接入；首批独立管理员密码/会话不是多员工身份体系，原管理 Bearer 仅保留运维兼容。 复用旧视频功能与本仓成熟 Go/chi、React、安全和正确性基础；按用户重做指令可以替换不合适的实现，不机械移植完整 new-api 平台。

历史统一文件存储计划（2026-09-27，职责已被替代）

用户已确认保留 oceanway-assets-cn、oceanway-media-cn，为新网关创建临时/正式/副本三个独立 TOS 桶，直接使用云端对象存储。 新平台物理文件能力由本仓承载；Core 负责客户 file_id、授权、额度和共享引用；产品保留业务素材/项目关系，经 Core/BFF 调用文件接口，不持有 TOS 凭据。 uumi 原有 TOS 链路保持，新网关不自动接管旧对象、清理器或在途任务。

8375689 已合入并推送外部 TOS 运行配置和 storagecheck，四个进程默认不依赖本地 MinIO；结果失败恢复 spool 保留。 统一上传会话、文件封存、保留租约及 UploadResolver 仍待 FS-01/02，Core 文件授权待 FS-03；本轮不是图片/音频生成扩展。 新桶已创建不代表凭据可用、真实读写通过、运行部署或跨仓联调完成。 详细决定与当前状态见 统一文件存储方案。

已实现与既有平台接入缺口（重做后重排）

• 服务 Key 与管理 Key 隔离；均映射保留的内部身份。该身份仅用于外键/Permit 兼容， 不是终端客户、租户或 Core 业务归属。内部任务和结果接口不得直接暴露给客户。
• 内部请求、task、attempt、Provider task 和结果已有本地关联及审计。
• 幂等为可选 Idempotency-Key，当前按内部 API Key ID 与键哈希去重，窗口 24 小时。 所有服务请求共享同一个 Key ID；调用方必须使用全局唯一业务键，不能以客户局部编号直接充当幂等键。
• Core operation → new-api task → media task → Provider attempt 的持久映射、提交未知恢复、 取消与退款分离、最终用量/费用证据、客户结果授权仍待跨仓验收。
• 重试/降级/健康/采购成本既有语义保持；取消状态不等于已支持所有上游取消，更不等于退款。

详细能力与缺口见 接入核对。

代码合并与生产验收

2026-09-27 用户确认本地验证、合并 main 后直接推送，无需 GitHub PR 合并；只清理已合并且干净的任务分支/工作树。 同日确认默认本机 Go/Bun 编译、测试及按需原生组件验证，不再搭建日常 Docker 测试环境；容器检查仅用于明确要求或容器部署配置变更。 当前代码集成记录见 MG-INTEGRATE-02，历史 PR 授权不作为当前工作前置。 2026-09-27 用户进一步授权补齐现有视频适配并在 pic-vps 原生源码部署，后续服务器源码开发；本服务独立数据库的初始化/迁移属于部署范围。不授权其他应用切流、其他业务数据库修改或新的付费调用。 真实供给、结果下载、Core/new-api 联调和生产验收未通过前不得自动启用 Supply 或宣称可替换生产。 旧文档按章节区分当前执行规则与历史客户设计；历史证据保留，不把过去通过当作新平台验收。

2026-10-14 视频插件接入决定

2026-10-14 用户确认：新渠道优先复用 new-api Plugin API v1 与 MoeJS 视频插件机制，保留网关 Go 执行内核、原生适配器和历史插件/在途任务。基线锁定 v1.0.0-rc.44；不依赖 new-api 平台运行、客户账户或计费，不部署或切换线上服务。见 视频插件兼容架构。

此决定取代新渠道仅允许编译 Go adapter 的旧规定。新插件使用独立 new-api-video profile；旧 js-video 禁止新增。协议插件不接管 Supply、成本、健康、容量、Attempt、租约、平台接口或结果保存。真实供给验收仍独立且需收费授权。

2026-10-15 媒体物理资源与测试素材

用户确认网关是视频/图片媒体物理资源的第一源头。所有 Provider 生成结果须转入本网关 TOS 后交付；复用既有结果转存和恢复链路。管理员测试素材支持图片、视频、音频上传与预览，长期保留并可重复选用，原始上传和请求临时副本分开持有。产品的项目、Workflow、客户业务权限仍归对应业务工程；本决定不恢复图片/音频生成入口，也不搬入客户计费。接口见 管理员 TOS 素材。