Files
short-drama-agent-front/docs/audits/image-authorization-video-audit-2026-11-13.md
T

12 KiB
Raw Blame History

OpenAI 图片持续授权与视频外部费用审计前端交付

2026-11-13。前端根目录 dev,基线 3915566。后端契约核对 dev@3cbff50e749cde36212053800757b8eafb729a3c 的两份公开 API、两份前端 Prompt、正式路由、Schema 与服务。

  1. 文件与职责

新增 18 个文件,修改 21 个文件,删除 0 个文件。所有改动均在前端仓库。

状态 文件 职责
新增 src/features/image-authorization/ImageAuthorizationSettings.vue 有限授权创建、余额、原请求、未知费用和撤销表单
新增 src/features/image-authorization/api.ts 四个正式图片授权接口及既有请求封装
新增 src/features/image-authorization/model.ts 美元精确换算、范围匹配、免费复用及具体阻断原因
新增 src/features/image-authorization/types.ts 授权、原图片请求和免费精确计划的正式类型
新增 src/features/production/components/VideoAuditPanel.vue 原任务只读身份、外部原件、独立复核和完整审计历史
新增 src/features/production/useVideoAudit.ts 原任务发现、归属检查、版本冲突和独立同步提交
新增 src/features/production/video-audit-api.ts 三个正式审计接口与已有历史预检、原任务 GET
新增 src/features/production/video-audit.ts 原件及复核门禁校验,区分供应方、SDK 与本地身份
新增 src/features/production/video-audit.types.ts 原身份、原件、复核版本和历史事件类型
新增 src/lib/billing-errors.ts 图片错误类型与审计冲突的中文展示映射
新增 tests/browser/billing.html 本地 Chrome 隔离验收入口
新增 tests/browser/billing.ts 复用真实组件、主题与全量请求拦截的浏览器场景
新增 tests/features/image-authorization/authorization.test.ts 范围、额度、免费复用、供应方切换、未知及原预览提交回归
新增 tests/features/image-authorization/defaults.test.ts 推荐与既有选择优先级、主体覆盖、目标切换及迟到响应回归
新增 tests/features/image-authorization/settings.test.ts 无预填批准、微美元转换、幂等重试和撤销回归
新增 tests/features/production/video-audit.test.ts 独立登记、复核、并发冲突、证据不足及费用与质量分离回归
新增 tests/fixtures/billing.ts 无真实账户和收费的图片、视频费用夹具
新增 docs/audits/image-authorization-video-audit-2026-11-13.md 本轮逐文件职责、接口、验收、边界和 Git 状态交接
修改 src/features/generation-config/api.ts 配置解析增加取消信号,沿用服务端覆盖优先级
修改 src/features/generation-config/components/ProjectSettingsDialog.vue 原项目全屏配置中增加图片授权标签和固定底栏操作
修改 src/features/generation-config/context.ts 共享图片授权入口和配置修订,兼容独立作用域
修改 src/features/generation-config/image-defaults.ts 后端推荐仅用于未填写配置,解析主体覆盖并保护手动选择与迟到响应
修改 src/features/production/components/KeyframeDialog.vue 原首帧预览接入授权资格,保留镜头覆盖与候选门禁
修改 src/features/production/components/ShotProductionAssets.vue 视频详情复用全屏抽屉,分开质量与费用审计并刷新原资源
修改 src/features/production/components/VideoCard.vue 主视频和候选卡片增加费用审计入口
修改 src/features/spatial-layouts/components/MasterGenerationForm.vue 原布局生成表单展示授权状态和独立费用确认资格
修改 src/features/spatial-layouts/components/SceneMasterManager.vue 布局授权范围内省略逐次图片收费确认,独立视觉审核保留原确认
修改 src/features/spatial-layouts/useMasterGeneration.ts 原母版免费预检接入布局范围授权、未知费用阻断和修订失效
修改 src/features/subject-identity/components/IdentityImageDialog.vue 原身份图入口接入范围授权、原预览和主体覆盖配置
修改 src/features/subject-images/components/GenerateImageDialog.vue 原形态入口接入范围授权,同主体切换形态仍重新读取配置
修改 src/features/subject-images/generation-preview.ts 共用原预览、费用资格、精确免费复用和防重复提交
修改 src/lib/http.ts 费用错误展示为业务中文,保留原始错误码及细节
修改 tests/features/production/production.test.ts 首帧旧回归补充正式配置解析响应
修改 tests/features/production/public-assets.test.ts 下载恢复旧回归补充镜头覆盖解析响应
修改 tests/features/subject-identity/identity.test.ts 身份图片旧回归补充主体配置解析响应
修改 tests/features/subject-images/images.test.ts 形态图片旧回归补充主体配置解析响应
修改 tests/features/subject-images/prompts.test.ts 提示词旧回归补充主体配置解析响应

| 修改 | tests/components/ui/form.test.ts | 公共图片表单回归补充正式主体配置解析 Mock | | 修改 | tests/features/workflows/pages.test.ts | 工作台端到端组件回归补充正式模型解析 Mock |

  1. API 对接
  • 图片授权完整接入 GET 列表、POST 免费计划、POST 登记、POST 撤销。请求使用现有 /api 代理和 { data } 解包。USD 编辑值精确换为整数微美元,空白、非正数及超过 6 位小数均拒绝提交。
  • 原身份图、形态图、首帧及布局母版继续使用原预览与生成接口。图片预览指纹与费用计划指纹分别保存和使用,正式生成保留 setPrimary=false 或原布局版本及 confirmPaidGeneration=true。
  • 视频完整接入 GET audit、POST evidence、POST reviews。已有免费质检预检、原任务 GET 和项目最新执行记录负责任务发现与回读,没有新增收费、恢复或事件流接口。
  • 正式后端只读核对两项均为 HTTP 200。项目图片授权及原图片请求均为空。原视频任务仍为 failed、billingBlocked=true,三个原步骤均 unreviewed,无外部证据和人工复核。
  1. UI 与状态
  • 授权在原项目配置抽屉独立管理。预算、单次预留、次数、有效期、批准人和接受浮动计费均由用户填写。展示累计准入预算、已记账及未结预留、余额、次数、到期、原请求和具体阻断原因。公开用量价与实际账单分别显示,未知不显示零。
  • 单次预留不构成供应方账单硬上限,创建前明确说明。有效范围内用户主动生图省略逐图收费批准,其它供应方重新预览并独立确认。原 Creative Profile、主体和镜头覆盖及手动选择保留。
  • 视频详情的质量和费用分开。原 Task、Workflow、本地请求、供应方请求与 SDK 回执分别显示。登记后不自动复核,核清后只刷新原审计、原任务、质量和列表及免费预检。旧视频过期、failed、needs_review 和晋升门禁沿原状态。
  • 外部原件只保存引用和 SHA256。表单不生成供应方请求号,不用本地 UUID 或观测编号代替。未知金额保持 null,原件缺失、模糊关联、未知费用及原 SDK 事实冲突时禁用核清。
  • 409 后刷新服务端版本、保留表单和原件选择、取消当前确认,等待人工重新核对,不自动重提。写入就地加载并使用 NMessage,正文独立滚动,底栏固定,窄屏单列,图标按钮复用正方形公共样式。
  1. 验证结果
  • Git 复核补齐公共表单与工作台页面两处旧配置解析 Mock,69 项定向复验通过。本次正常提交钩子将再次执行完整 pnpm check 和 Commitlint,结果以提交日志为准。
  • 48 个相关 Vitest 文件、358 项用例通过。补充原请求阻断摘要断言后,图片授权 13 项再次通过。旧测试的配置解析 Mock 已按正式新增读取补齐。
  • pnpm 启动时尝试拉取包管理器版本失败,本轮改用 node_modules/.bin 下已安装的 vue-tsc、vite、vitest、oxlint、eslint 和 oxfmt 完成等价范围检查。
  • Vue TypeScript 检查、Vite 生产构建通过。改动范围 Oxlint、Vue ESLint、Oxfmt 检查和 git diff --check 通过。
  • 本地 Chrome 使用 localhost 隔离页,全部 fetch 均由本页 Mock 拦截。授权与图片入口 10 项、视频审计 10 项核心交互断言通过,覆盖创建、撤销、到期、预算不足、未知阻断、免费复用、供应方重新确认、双击防重复、证据登记、重复登记、独立复核、并发冲突、核清不改质量、新证据使旧复核失效。
  • Chrome 实际检查桌面和 400×706、500×883 窄屏。字段标签与控件间距为 8px,无水平溢出,长内容滚动前后底栏位置一致,取消保留可见键盘焦点。删除原件图标最终为 34×34。
  • Chrome 刷新隔离页后请求记录为空,没有自动重发生成、授权或审计写入。
  • Chrome 原控制连接超时,实际浏览器验证使用本机 Chrome AppleScript 与 DOM 事件完成。未使用 Playwright。
  1. 契约边界与未执行项
  • 真实收费图片、视频、独立视觉审核、修复及主资产变更均未执行。正式历史任务没有登记模拟材料或提交人工核清。原视频仍需真实供应方执行与账单材料才能处置。
  • 后端普通精确授权预览只开放 identity/form/keyframe 的普通输入。自定义提示词、身份辅助视角和布局高级输入继续使用原预览及持续范围授权;精确免费复用提示仅在正式授权预览能够覆盖该输入时显示。
  • 已过期候选准备新质检会被原预检拒绝,前端保留最新原任务发现,并提供按原任务编号只读查询。历史身份始终使用服务端原版本。
  1. Git 状态

开发轮结束时未提交或推送。本 Git 轮用户已明确授权复核后提交并推送到 dev,实际提交和远端同步以 Git 记录为准。全程使用前端根目录 dev,未创建工作树,未修改后端代码。