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

87 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/ImageAuthorizationSettings.vue) | 有限授权创建、余额、原请求、未知费用和撤销表单 |
| 新增 | [src/features/image-authorization/api.ts](../../src/features/image-authorization/api.ts) | 四个正式图片授权接口及既有请求封装 |
| 新增 | [src/features/image-authorization/model.ts](../../src/features/image-authorization/model.ts) | 美元精确换算、范围匹配、免费复用及具体阻断原因 |
| 新增 | [src/features/image-authorization/types.ts](../../src/features/image-authorization/types.ts) | 授权、原图片请求和免费精确计划的正式类型 |
| 新增 | [src/features/production/components/VideoAuditPanel.vue](../../src/features/production/components/VideoAuditPanel.vue) | 原任务只读身份、外部原件、独立复核和完整审计历史 |
| 新增 | [src/features/production/useVideoAudit.ts](../../src/features/production/useVideoAudit.ts) | 原任务发现、归属检查、版本冲突和独立同步提交 |
| 新增 | [src/features/production/video-audit-api.ts](../../src/features/production/video-audit-api.ts) | 三个正式审计接口与已有历史预检、原任务 GET |
| 新增 | [src/features/production/video-audit.ts](../../src/features/production/video-audit.ts) | 原件及复核门禁校验,区分供应方、SDK 与本地身份 |
| 新增 | [src/features/production/video-audit.types.ts](../../src/features/production/video-audit.types.ts) | 原身份、原件、复核版本和历史事件类型 |
| 新增 | [src/lib/billing-errors.ts](../../src/lib/billing-errors.ts) | 图片错误类型与审计冲突的中文展示映射 |
| 新增 | [tests/browser/billing.html](../../tests/browser/billing.html) | 本地 Chrome 隔离验收入口 |
| 新增 | [tests/browser/billing.ts](../../tests/browser/billing.ts) | 复用真实组件、主题与全量请求拦截的浏览器场景 |
| 新增 | [tests/features/image-authorization/authorization.test.ts](../../tests/features/image-authorization/authorization.test.ts) | 范围、额度、免费复用、供应方切换、未知及原预览提交回归 |
| 新增 | [tests/features/image-authorization/defaults.test.ts](../../tests/features/image-authorization/defaults.test.ts) | 推荐与既有选择优先级、主体覆盖、目标切换及迟到响应回归 |
| 新增 | [tests/features/image-authorization/settings.test.ts](../../tests/features/image-authorization/settings.test.ts) | 无预填批准、微美元转换、幂等重试和撤销回归 |
| 新增 | [tests/features/production/video-audit.test.ts](../../tests/features/production/video-audit.test.ts) | 独立登记、复核、并发冲突、证据不足及费用与质量分离回归 |
| 新增 | [tests/fixtures/billing.ts](../../tests/fixtures/billing.ts) | 无真实账户和收费的图片、视频费用夹具 |
| 新增 | [docs/audits/image-authorization-video-audit-2026-11-13.md](../../docs/audits/image-authorization-video-audit-2026-11-13.md) | 本轮逐文件职责、接口、验收、边界和 Git 状态交接 |
| 修改 | [src/features/generation-config/api.ts](../../src/features/generation-config/api.ts) | 配置解析增加取消信号,沿用服务端覆盖优先级 |
| 修改 | [src/features/generation-config/components/ProjectSettingsDialog.vue](../../src/features/generation-config/components/ProjectSettingsDialog.vue) | 原项目全屏配置中增加图片授权标签和固定底栏操作 |
| 修改 | [src/features/generation-config/context.ts](../../src/features/generation-config/context.ts) | 共享图片授权入口和配置修订,兼容独立作用域 |
| 修改 | [src/features/generation-config/image-defaults.ts](../../src/features/generation-config/image-defaults.ts) | 后端推荐仅用于未填写配置,解析主体覆盖并保护手动选择与迟到响应 |
| 修改 | [src/features/production/components/KeyframeDialog.vue](../../src/features/production/components/KeyframeDialog.vue) | 原首帧预览接入授权资格,保留镜头覆盖与候选门禁 |
| 修改 | [src/features/production/components/ShotProductionAssets.vue](../../src/features/production/components/ShotProductionAssets.vue) | 视频详情复用全屏抽屉,分开质量与费用审计并刷新原资源 |
| 修改 | [src/features/production/components/VideoCard.vue](../../src/features/production/components/VideoCard.vue) | 主视频和候选卡片增加费用审计入口 |
| 修改 | [src/features/spatial-layouts/components/MasterGenerationForm.vue](../../src/features/spatial-layouts/components/MasterGenerationForm.vue) | 原布局生成表单展示授权状态和独立费用确认资格 |
| 修改 | [src/features/spatial-layouts/components/SceneMasterManager.vue](../../src/features/spatial-layouts/components/SceneMasterManager.vue) | 布局授权范围内省略逐次图片收费确认,独立视觉审核保留原确认 |
| 修改 | [src/features/spatial-layouts/useMasterGeneration.ts](../../src/features/spatial-layouts/useMasterGeneration.ts) | 原母版免费预检接入布局范围授权、未知费用阻断和修订失效 |
| 修改 | [src/features/subject-identity/components/IdentityImageDialog.vue](../../src/features/subject-identity/components/IdentityImageDialog.vue) | 原身份图入口接入范围授权、原预览和主体覆盖配置 |
| 修改 | [src/features/subject-images/components/GenerateImageDialog.vue](../../src/features/subject-images/components/GenerateImageDialog.vue) | 原形态入口接入范围授权,同主体切换形态仍重新读取配置 |
| 修改 | [src/features/subject-images/generation-preview.ts](../../src/features/subject-images/generation-preview.ts) | 共用原预览、费用资格、精确免费复用和防重复提交 |
| 修改 | [src/lib/http.ts](../../src/lib/http.ts) | 费用错误展示为业务中文,保留原始错误码及细节 |
| 修改 | [tests/features/production/production.test.ts](../../tests/features/production/production.test.ts) | 首帧旧回归补充正式配置解析响应 |
| 修改 | [tests/features/production/public-assets.test.ts](../../tests/features/production/public-assets.test.ts) | 下载恢复旧回归补充镜头覆盖解析响应 |
| 修改 | [tests/features/subject-identity/identity.test.ts](../../tests/features/subject-identity/identity.test.ts) | 身份图片旧回归补充主体配置解析响应 |
| 修改 | [tests/features/subject-images/images.test.ts](../../tests/features/subject-images/images.test.ts) | 形态图片旧回归补充主体配置解析响应 |
| 修改 | [tests/features/subject-images/prompts.test.ts](../../tests/features/subject-images/prompts.test.ts) | 提示词旧回归补充主体配置解析响应 |
| 修改 | [tests/components/ui/form.test.ts](../../tests/components/ui/form.test.ts) | 公共图片表单回归补充正式主体配置解析 Mock |
| 修改 | [tests/features/workflows/pages.test.ts](../../tests/features/workflows/pages.test.ts) | 工作台端到端组件回归补充正式模型解析 Mock |
2. 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,无外部证据和人工复核。
3. UI 与状态
- 授权在原项目配置抽屉独立管理。预算、单次预留、次数、有效期、批准人和接受浮动计费均由用户填写。展示累计准入预算、已记账及未结预留、余额、次数、到期、原请求和具体阻断原因。公开用量价与实际账单分别显示,未知不显示零。
- 单次预留不构成供应方账单硬上限,创建前明确说明。有效范围内用户主动生图省略逐图收费批准,其它供应方重新预览并独立确认。原 Creative Profile、主体和镜头覆盖及手动选择保留。
- 视频详情的质量和费用分开。原 Task、Workflow、本地请求、供应方请求与 SDK 回执分别显示。登记后不自动复核,核清后只刷新原审计、原任务、质量和列表及免费预检。旧视频过期、failed、needs_review 和晋升门禁沿原状态。
- 外部原件只保存引用和 SHA256。表单不生成供应方请求号,不用本地 UUID 或观测编号代替。未知金额保持 null,原件缺失、模糊关联、未知费用及原 SDK 事实冲突时禁用核清。
- 409 后刷新服务端版本、保留表单和原件选择、取消当前确认,等待人工重新核对,不自动重提。写入就地加载并使用 NMessage,正文独立滚动,底栏固定,窄屏单列,图标按钮复用正方形公共样式。
4. 验证结果
- 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。
5. 契约边界与未执行项
- 真实收费图片、视频、独立视觉审核、修复及主资产变更均未执行。正式历史任务没有登记模拟材料或提交人工核清。原视频仍需真实供应方执行与账单材料才能处置。
- 后端普通精确授权预览只开放 identity/form/keyframe 的普通输入。自定义提示词、身份辅助视角和布局高级输入继续使用原预览及持续范围授权;精确免费复用提示仅在正式授权预览能够覆盖该输入时显示。
- 已过期候选准备新质检会被原预检拒绝,前端保留最新原任务发现,并提供按原任务编号只读查询。历史身份始终使用服务端原版本。
6. Git 状态
开发轮结束时未提交或推送。本 Git 轮用户已明确授权复核后提交并推送到 dev,实际提交和远端同步以 Git 记录为准。全程使用前端根目录 dev,未创建工作树,未修改后端代码。