MG-02-005 记录与结果
状态：用户已确认全部历史保留和旧数据迁移；展示/存储细节为建议稿。目标是看见“生成了什么、结果在哪里、发生了什么、花了多少”，不以一张状态日志表代替结果平台。
当前交付：MG-RESULT-02 已接入持久测试、生成记录与管理员授权播放/下载；实际接口与限制见 契约。历史迁移、账单/退款导入及客户文件授权仍独立，以下完整目标不能整体视为已交付。
一条逻辑请求，一条记录
API 生成和供给测试共用 Request → Task → Attempt → Output 链路。生成记录主键使用稳定的 request ID；兼容 video/task ID、调用方业务 ID、Provider ID 都可关联查询，不额外创建重复的“测试结果库”。
同一幂等请求一行；最多两次供给执行在详情展示，调用方只计一次，上游采购逐 Attempt 记录。测试有固定供给/完整路由模式与验证范围，默认可在同一列表筛选。单次测试未通过不抹除记录；旧同步测试只有证据但没有媒体时显示“历史验证证据”，不能伪造可播放结果。
列表
默认按创建时间和稳定 ID 倒序，以游标分页；刷新保留筛选及当前位置，不限于当前最多 200 条后假装全部记录。服务器负责过滤/分页；前端不能下载全库后筛选。
| 信息 | 表现 |
|---|---|
| 时间与请求 | 创建时间、任务 ID 可复制、用途（API/供给测试） |
| 输入摘要 | 提示词短摘要/素材数量；长输入在授权详情中加载 |
| 模型与参数 | 标准模型、分辨率、比例、时长、音频摘要 |
| 执行 | 当前/最终渠道、状态、耗时；多次执行可展开 |
| 结果 | 已就绪时展示预览入口/缩略图；其余明确说明原因 |
| 费用 | 预计与实际分开，未知显示待核实；明确币种 |
筛选至少包括时间、标准模型、曾执行渠道、状态、用途、request/task/业务 ID。渠道筛选匹配任一 Attempt，但一条请求只返回一次。提示词搜索如开放需权限、输入长度/索引限制，不能把未脱敏内容写入 URL、分析日志或前端缓存。导出沿用相同过滤及授权，默认排除输入全文、供应密钥和私有链接。
页面空态区分“从未生成”“筛选无结果”“权限/加载失败”。进行中的行可以安全轮询 GET；不因轮询失败再 POST。没有可信进度就显示阶段与时间，不能用随机百分比制造进度。
详情的信息顺序
- 结果/当前状态：有可读视频则先显示播放器、多输出切换、下载和媒体信息；未就绪显示当前阶段及下一步。失败/未知的安全提示放在同一区域。
- 输入与参数：提示词、授权素材预览、标准模型、时长/画幅/音频等；降级时并排展示请求与实际参数。请求快照按需读取，不夹在列表返回。
- 费用：预计采购成本、明确实际费用、失败费、退款和待核实项；标注来源及核对时间。
- 执行过程：接受、选路、提交、上游查询、转存/封存、结束时间；每个 Attempt 展示渠道、规格、结果和选路理由。
- 技术细节：Provider ID、配置/价格/凭据版本标识、已脱敏请求/错误、关联 ID 折叠显示。普通使用不要求理解这些字段才能看结果。
“复制参数”可打开新测试草稿但不提交。普通失败时可以显式创建新任务，使用新操作 token，并展示收费说明；Unknown 不提供直接重提入口。恢复下载/核对状态使用原任务，只读取或补结果，不生成新视频。
结果何时算完成
Provider 的 success 只表示上游生成完成。网关须取得真实媒体，检查非空、类型/格式、大小、基本可读性及与请求有关的可信信息，封存主结果并绑定任务后，才显示“已完成/可播放”。
目标沿用 TOS 临时素材、正式结果、副本三类桶，桶地址和凭据仅在网关配置。正式平台结果使用稳定 output ID 与授权内容入口；不能把会过期的供应签名 URL 当唯一资产。临时来源、Provider 结果 ID 和恢复定位信息受限保存，日志不记录完整签名 URL。
主结果已可读、副本尚待同步时，显示副本状态与运维提示；首轮建议不让副本同步阻塞主结果交付，但存储策略如明确要求同步双写则另行定稿。转存失败可以继续获取同一个结果；恢复队列不再调用生成。上游链接过期且不可刷新时说明“上游完成，结果不可恢复”，不能改成普通生成失败掩盖问题。
TOS 不在浏览器或其他产品中分别配置。其他平台通过上传/读取接口与授权文件引用接入；统一上传会话、Core 文件授权等尚未完成的工作继续按 文件存储方案 单列，不能因这份设计声称已上线。
播放、下载与权限
旧播放器的 controls、preload metadata、播放失败回退行为可以直接提取，URL 必须换成当前平台授权结果入口。浏览器 video 无法附加任意 Bearer Header，不能拿一个只能 API Bearer 访问的地址就宣称 UI 支持播放。
管理同源 HttpOnly 会话同时授权详情和 GET/HEAD/Range 内容访问；服务调用仍使用独立服务认证。每次读取按服务端对象归属/管理权限校验，内容入口不因知道 output ID 就放行。短期签名链接若使用须限制期限、作用域与日志泄露；它不能取代长期对象权限。
播放器支持 Range 与拖动，下载支持明确文件名/内容类型。页面关闭停止前端媒体读取，但不取消上游任务。播放错误先区分权限过期、文件过期、浏览器编码不支持和服务错误；可提供同一授权结果的下载/新标签入口，不跳到带供应密钥的 URL，不再生成视频。
没有缩略图的历史结果允许直接打开详情，不要求先生成额外缩略图才能使用。失败的封面生成也不改变视频生成终态。
输入与历史快照
复用旧请求快照“按需加载、大小上限、摘要/截断标记”的机制，替换旧用户权限。历史输入/快照按永久记录保护，输入文件与未引用临时上传区别管理；日志、审计事件只留安全摘要，不记录完整素材、真实密钥或签名 URL。
上传素材优先使用受控文件引用；外部 URL 读取沿用 SSRF、DNS 重绑定、大小、类型和超时保护。快照记录有效输入及来源引用，不能把原始 auth header 或任意含敏感字段的请求体照搬入库。历史缺失快照显示未记录，超限显示截断和摘要，不能假装原始参数完整。
详情必须来自任务接受时的版本；当前管理员改名称/价格后可另显示“当前名称”，但原始请求、实际上游型号、当时报价和路由理由不改写。不存在媒体的历史任务保留空结果说明。
费用与退款
| 字段 | 含义 | 未知处理 |
|---|---|---|
| 预计采购成本 | 接受/选路时按固定价格版本计算 | 缺规则则待核实，不能以 0 代替 |
| 上游扣费 | Provider 账单/响应/可靠核对的实际费用 | 单独待核实，不用预计值冒充 |
| 失败费用 | 明确收费失败执行的费用 | 状态失败不等于免费 |
| 上游退款 | 明确的退款事件、金额及证据 | 网关取消/超时不等于已退款 |
| 净采购费用 | 已知扣费减已知退款，按币种汇总 | 任一缺失则标记部分/待核实 |
同逻辑请求只有一份调用方计价/结算关联和最终结果；A/B 采购费用不成为两次客户扣费。客户预留、销售价、钱包扣减不在本页。旧 new-api quota 变为 0 或本地执行退款函数，不等于 Provider 真正退款；需明确账务层与证据来源。人工核对也留维护者、时间和来源，不覆盖原始事件。
费用事件以稳定来源/事件 ID 去重，迟到账单或退款可补充，但不改变生成终态。每次 Attempt 独立记录，主记录汇总明确净额；不同币种不能无汇率直接相加。金额用定点十进制，显示精度与存储精度分开。
保留与失效
D04 已确认全部历史记录永久保留，不按天数删除记录、快照、费用及来源映射。已取得并关联历史的结果不默认清理；未引用临时文件独立处理。源文件早已过期/删除时明确列缺口，不把记录变为 404 或失败，不继承旧默认清理策略。
旧数据按 08 只读迁入，视频在本列表，其他旧历史在管理只读档案可查。不执行旧任务、不改历史时间、不重新收费，缺文件保留记录及来源。
临时文件清理必须检查在途恢复、共享引用与保留租约，不能根据列表隐藏/渠道归档直接删对象。旧两桶、其他应用和旧归档渠道不在本次清理范围。恢复、下载授权、过期及副本状态都纳入 验收。
2026-10-16 记录职责与同步/异步更新（MG-RECORD-03）
用户确认统一为“生成记录”，执行过程放详情，API记录独立；后续明确API记录承接旧new-api-new-oceanway常规日志，保持简洁。生成列表按媒体类型、执行方式、来源区分；同步图片一次HTTP返回结果，异步先受理后执行，两者仍复用一条Request事实源。详情图片区分图片预览/下载，异步保留阶段时间线，不把HTTP202等同生成成功。
API记录展示时间/渠道/模型/调用结果/耗时/关联采购及按需展开请求ID，独立采集提交与失败调用；成功轮询/下载/后台读取不刷屏。只显示执行记录采购额且明确未核账，未知待核对。客户/令牌/Quota/钱包不搬回本网关。接口与采集缺口见API记录，旧历史迁移仍单列。
2026-10-16 历史迁入更新（MG-HISTORY-01）
按用户追加授权，旧项目任务与 API 日志迁入现有生成/API列表。来源时间、费用原单位、原状态、原始ID与结果对象关联只读保留；同步图片和异步任务分开标识，历史在途任务不执行、不轮询、不重新收费。旧 quota 仅为来源事实，不能解释为网关采购成本。完整来源快照在源码外加密保留，UI 显示白名单投影。
媒体引用与当前可读性分别记录；旧存储403或原先未保存输出均明确提示，不能声明已恢复播放。范围、来源数量、可读性缺口和部署事实见 MG-HISTORY-01，接口见 历史记录契约。