MG-02-001 系统重做入口
更新：2026-09-30。初稿：MG-REBUILD-01；决定修订：MG-REBUILD-02；渠道编辑确认：MG-REBUILD-03。
本目录是此次重做的唯一设计入口。2026-09-30 用户确认开始制作，当前进入分批实现：MG-BUILD-01 交付独立管理会话、原子配置与首批渠道 UI。调度、持久真实测试、完整历史迁移仍待完成。文中“应当”表示目标行为，不表示现网已具备。
已确认方向与建议边界
用户已确认：摆脱 new-api 平台依赖；从旧视频网关直接提取可用代码；系统改善交互、维护、调度及渠道配置；生成记录能查看生成内容和实际结果；先理清文档再开发。进一步确认无日常工作台、站内真实测试、普通配置不二次确认、单管理员密码/会话、历史永久保留及旧数据迁移、调用方只计一次且采购分别记录；渠道规格表直接编辑，复杂参数侧边编辑。此前已确认 pic-vps 源码/systemd 部署、使用云端 TOS、本地合并 main 后直接推送、日常不搭建 Docker 测试环境。
本稿以独立视频供应网关为首轮边界：渠道凭据、上游型号与参数、采购成本、模型路由、执行、结果和运营 UI 在本服务完成。调用方通过 API 接入，不要求运行 new-api、读取它的数据库或使用它的用户登录。Core 可作为调用方，既有客户/售价/结算归属不会因本次重做自动搬回网关；图片、音频生成和产品 Workflow 单列。
“代码来自 new-api”与“服务依赖 new-api”是两件事。提取后应使用本仓接口、认证、数据库和配置，不能调用旧平台管理 API 来完成日常操作。旧平台与旧归档记录保留。
文档结构与阅读顺序
| 文档 | 要回答的问题 | 主要产物 |
|---|---|---|
| 01 产品与完整流程 | 谁使用、怎样接入维护、怎样生成与排查 | 产品边界、主流程、异常流程 |
| 02 领域与配置 | 什么是渠道/型号/规格/供给、参数和价格在哪里改 | 实体关系、字段归属、状态、生效规则 |
| 03 调度与执行 | 怎么选渠道、什么时候等待/换供给、未知提交怎么办 | 决策顺序、成本、状态机、恢复不变量 |
| 04 记录与结果 | 怎样看到生成内容、结果、过程和费用 | 列表、详情、媒体、账务证据展示 |
| 05 交互与接口 | 页面怎么组织、表单怎么填、哪些操作确认 | 导航、交互规则、操作矩阵、API 切片 |
| 06 代码提取与迁移 | 具体从哪里提取，如何脱离旧平台 | 来源清单、复用/排除、数据迁移与兼容 |
| 07 验收与交付 | 怎样证明目标真正完成，如何发布与回退 | 场景、实现顺序、证据和生产门禁 |
| 08 历史数据迁移与保留 | 怎样完整迁入旧记录并长期可查 | 来源/映射、只读导入、媒体缺口、完整性 |
| 历史 Schema 来源 | 迁移设计依据是什么 | 固定提交的 14 文件路径与哈希 |
| 决定修订证据 | 讨论结果怎样落实 | 已确认语义与审计边界 |
| 渠道编辑证据 | 规格表和侧边区怎样协作 | D08、共享草稿与保存验收 |
| source-map.json | 来源是否可重复核对 | 58 个已提交文件的路径、哈希及处置 |
| 本次审计证据 | 本轮实际上做了什么 | 基线、检查、未做事项与限制 |
分工规则：产品流程只在 01 定义；字段与生效只在 02 定义；调度状态只在 03 定义；结果展示只在 04 定义；交互/API 只在 05 定义；代码提取/当前结构迁移只在 06 定义；验收在 07；旧平台历史导入/保留在 08。其他章节引用，不另创同名规则。字段级 Schema、迁移 DDL 和组件文件拆分留给定稿后的实现任务，不能提前成为额外产品流程。
文档层级与历史处理
- 用户最新明确指令与后续确认决定优先。
- 本目录记录本次重做方向；未定稿的建议仍标明建议，不能视为批准。
- CURRENT_BOUNDARY 保留现行运行边界，并在顶部指向本次变更。
- 原 API、架构、UI 文档用于核对现状；与本稿冲突的旧页面和配置流程不作为重做设计。
- tasks/ 声明工作范围；evidence/ 记录事实；history/ 留存旧方案。任务完成不等于生产验收通过。
设计状态使用“已确认方向 / 建议稿 / 待定”；交付状态使用“文档完成 / 代码完成 / 验证完成 / 已部署 / 生产可用”。这些词不能混用。文档讨论结束后在本页记录决定、日期与来源，再更新相关章节并拆工作包。
需求与验收追踪
| ID | 用户问题或目标 | 设计归属 | 可观察验收 |
|---|---|---|---|
| R01 | 摆脱 new-api，直接复用旧视频代码 | 01、06 | A01：独立登录、数据库、运行与 API；来源可追溯 |
| R02 | 点击与确认繁琐 | 05 | A02：普通读写无确认墙，操作反馈不阻塞 |
| R03 | 配置及维护复杂、资料不一致 | 02、05 | A03–A05：单处维护、原子保存、目录差异可处理 |
| R04 | 视频调度不理想 | 03 | A06–A09：可解释选路、成本一致、未知提交不重发 |
| R05 | 渠道适配与模型参数问题 | 02、06 | A10：逐协议/规格断言，适配与真实验证分开 |
| R06 | 使用记录显示生成过程及结果 | 04 | A11–A14：一条记录、播放下载、费用真实、错误可追查 |
| R07 | 先整理文档再做 | 本页、07 | A15：文档先行、确认后按独立任务实现 |
| R08 | 原生源码部署、TOS、直接推送 | 06、07 | A16：隔离测试、systemd、保留数据与回退能力 |
| R09 | 全部历史永久保留，旧数据迁移 | 04、08 | A17–A18：来源完整、重跑无副作用、缺失文件可查 |
| R10 | 无日常工作台，站内真实测试 | 01、03、05 | A10–A12：固定供给/完整路由真实任务及结果 |
已确认的产品决定
以下产品决定来源于用户回复，D01–D08 为 2026-09-30，D09 为 2026-10-14，D10 为 2026-10-15；实现进度按任务/evidence 记录，不能将方向确认等同全部完成。技术映射及字段/默认值继续讨论，不重复把已确认行为列为待定。
| 决定/状态 | 当前决定或建议 | 影响 |
|---|---|---|
| D01 默认调度：已确认 | 2026-09-30 用户明确选择“人工排序为主，同级比较成本”；同价后的容量/稳定 ID 为实施建议。其他策略是否首轮开放待讨论；不搬旧随机权重 | 03 的排序、05 的路由配置 |
| D02 重试与费用：已确认 | 配置一次重试时 A/x 明确失败后顺序调用 B/x；同请求调用方只计一次，采购逐 Attempt 记录；提交未知先核对 | 03/04 的顺序、记录及计费关联 |
| D03 管理登录：已确认 | 首轮一个管理员账号，密码登录，刷新保持会话；服务 Key 与会话/内容授权隔离 | 05 的登录、播放与运维 |
| D04 历史保留：已确认 | 全部历史记录永久保留，关联结果不默认清理；源文件缺失如实说明，未引用临时文件独立管理 | 04/08 的保留与可用性 |
| D05 首轮范围：已确认 | 无日常工作台，站内支持固定供给及完整路由真实测试 | 01/03/05 的入口与执行 |
| D06 配置交互：已确认 | 大部分配置无二次确认；移除等大范围动作确认一次，保存反馈不阻塞 | 02/05 的保存与确认矩阵 |
| D07 旧数据迁移：已确认 | 只读迁入全部历史，完整记录/档案可查，不恢复旧登录/钱包运行时 | 08 与 A17–A18 |
| D08 渠道编辑布局：已确认 | 用户回复“按照建议来做”：渠道详情按型号组/规格展示，上游型号和价格在规格表直接编辑，复杂参数侧边编辑；共享草稿、一次保存 | 02/05 与 A02–A04 |
| D09 图片渠道管理：已确认 | 图片模型渠道管理直接与 new-api 原生管理保持一致；视频规格编辑与调度设计继续适用于视频 | 02 图片渠道管理、MG-IMAGE-02；图片完整运行接入仍待验收 |
| D10 图片多Key调度与分组：已确认并实现管理 | 每个new-api Key独立渠道，同型号多渠道顺序/采购成本/并发；渠道页按上游/模型切换 | MG-IMAGE-06、MG-IMAGE-07；真实执行/原生异步/启用仍单列 |
渠道/参数/结果这些已确认需求先完整定义；决定集中于本页；剩余为接口/存储字段映射、重试默认值、同价细节及实际来源盘点。文档确认不自动改变运行配置或迁移业务数据。