diff --git a/docs/audits/image-authorization-video-audit-2026-11-13.md b/docs/audits/image-authorization-video-audit-2026-11-13.md new file mode 100644 index 0000000..798cea1 --- /dev/null +++ b/docs/audits/image-authorization-video-audit-2026-11-13.md @@ -0,0 +1,86 @@ +# 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,未创建工作树,未修改后端代码。 diff --git a/src/features/generation-config/api.ts b/src/features/generation-config/api.ts index fd39894..7f24305 100644 --- a/src/features/generation-config/api.ts +++ b/src/features/generation-config/api.ts @@ -29,6 +29,14 @@ export const generationConfigApi = { request(`${projectPath(projectId)}/creative-profile`, { signal }), saveProfile: (projectId: string, input: CreativeProfileInput) => request(`${projectPath(projectId)}/creative-profile`, { method: 'PUT', body: input }), + /** + * 解析实际项目及目标覆盖配置,显式选择时沿原优先级处理。 + * @param projectId 当前项目 + * @param mediaType 图片或视频 + * @param input 显式参数与正式目标 + * @param signal 取消旧表单读取 + * @returns 最终供应方、型号及参数 + */ resolve: ( projectId: string, mediaType: GenerationMediaType, @@ -37,11 +45,13 @@ export const generationConfigApi = { model?: string options?: Record target?: { targetType: GenerationOverrideTargetType; targetId: string } - } + }, + signal?: AbortSignal ) => request(`${projectPath(projectId)}/generation-config/${mediaType}/resolve`, { method: 'POST', - body: input + body: input, + signal }), override: ( projectId: string, diff --git a/src/features/generation-config/components/ProjectSettingsDialog.vue b/src/features/generation-config/components/ProjectSettingsDialog.vue index acd515d..aa252f7 100644 --- a/src/features/generation-config/components/ProjectSettingsDialog.vue +++ b/src/features/generation-config/components/ProjectSettingsDialog.vue @@ -4,6 +4,7 @@ import { NButton, NTabs, NTabPane } from 'naive-ui' import { AppDrawer } from '../../../components/ui' import type { CreativeProfileInput } from '../types' import CreativeProfileSettings from './CreativeProfileSettings.vue' +import ImageAuthorizationSettings from '../../image-authorization/ImageAuthorizationSettings.vue' import QualityPolicySettings from './QualityPolicySettings.vue' import type { ProjectSettingsTab } from '../context' @@ -37,8 +38,16 @@ watch([open, () => props.initialTab, () => props.projectId], ([shown]) => { }) /** 质量策略表单实例。 */ const qualityForm = ref | null>(null) +/** 图片授权表单复用抽屉底栏。 */ +const authorizationForm = ref | null>(null) /** 当前标签的独立保存入口,避免跨接口混合保存。 */ -const activeForm = computed(() => (tab.value === 'quality' ? qualityForm.value : form.value)) +const activeForm = computed(() => + tab.value === 'image-authorization' + ? authorizationForm.value + : tab.value === 'quality' + ? qualityForm.value + : form.value +)