# V8-9.4~V8-9.9 前端接入交接 Git交付补充:用户已授权本轮全部52个前端文件集中提交并推送dev,主题为 `feat(short-drama-agent-front): 接入联合修订与图片费用审计`。下文未提交/未Push和旧文件统计保留各验收时点;最新范围含后续环境增量,实际SHA及远端状态以本次仓库记录为准。 集中提交检查补充:首次正常钩子已通过全量Lint、488文件格式及类型检查,118套/913项测试中有3项暴露当前新回执被错误归入历史。已在原页面标记本页明确发起的操作,让新回执直接显示,恢复历史仍默认收起且不弹窗;未放宽原生成、费用或校验判断。3项原失败回归及2项浏览回归定向通过(其余59项未选中),本地Chrome原全请求隔离页验证新回执无需展开历史即可查看,截图在同级 `storyboard-cleanup/current-receipt.jpg`。提交钩子保留并重新执行全量,最终结果以此次提交终端为准。 日期:2026-11-16。前端根目录 `dev`,起始 `87427d9d4347fcc5535cbe74728ab00bf53ae796`;后端契约基线 `2d3abdab5f2656223ab98161dff6388200db281c`。只修改前端,没有新建工作树,没有提交或推送。 ## 已有实现与本轮缺口 | 范围 | 已有能力 | 本轮补齐 | | --- | --- | --- | | 摄影审核 | 原独立摄影、组合草案、视线修订、场景沿用、草案保存/历史、版本保护 | 原抽屉内联合模式、完整字段差异、本镜/邻镜版本、免费预检及冻结请求采用 | | 图片授权 | OpenAI 有限持续授权、原请求费用/余额、撤销、普通首帧 Preview、未知请求保护 | 人工有限追加登记/显示/撤销、原首帧主动选用、精确计划资格核对与成功后免费复用 | | 费用审计 | 视频原件登记与独立复核 | 提取共用字段/校验,增加图片域三个正式接口及独立费用投影 | | VisualState | 原主体/环境/continuityNote、原问题及定位、任务回执 | 正式时间标记分段与开拍说明、三种时间问题中文标题 | | Workflow | 持久化 WorkflowExecution、GET/SSE、活动任务锁、恢复观察 | 继续复用;联合采用与费用审计为免费同步操作,不新增任务系统 | 没有第二套摄影编辑器、时间轴、授权服务或业务页面。后端接口缺失没有用其它功能代替。 ## 联合采用交互及保护 1. 从原“摄影草案与审核”切入联合模式,读取正式 Direction、VisualState、质量确认、Keyframe Spec 和原保存草案。项目、剧集、镜头归属不一致时不开放写入。 2. 展示完整原稿与正式前后差异;身份、Form、环境、主体集合及其它不允许字段也显示,不悄悄过滤后提交。仅开放 composition、cameraPosition、visualIntent、continuityNote 及主体 expression/pose/gaze/position/transientState。 3. 保存完整原草案使用 expectedRevision 及当前正式来源。保存成功只提示“尚未正式采用”,不变更正式 D/VS。 4. 免费画面预览读取 draftFingerprint、currentDerivedFingerprint、adjacentDerivedVersions;邻镜必须完整对应同集正式顺序,不可缺漏、重复或伪造。 5. 原 confirm 路由 `preview:true` 发送 jointRevision 的保存版号、本镜版本、完整邻镜、原因和全部 1~40 项差异。人工勾选后,正式采用提交完全相同快照,仅改 `preview:false`。 6. 接受 changed 或 reused 的正式回执。409 或未知回执废弃旧预检,重读正式 GET,保留人工输入,等待明确重读/重新预检;不自动覆盖、保存或再次采用。 7. 采用后读取正式 D/VS 及正式 Keyframe Preview,草案显示 stale 时保留原文与历史。草案指纹不提交生图。没有自动生图、Vision、Repair 或 Primary。 原摄影、组合草案、视线修订、场景沿用和草案历史的分支保留。超出40项、字段超过4000字、越界或混入其它修订模式时有简短原因并禁止联合采用。 ## 追加许可与费用审计 - 追加许可表单只接受原 unknown OpenAI 首帧请求,次数、署名和风险确认不预填;POST 只发送正式 additional Schema,不构造新型号、范围、预算或供应方。 - 显示原请求、原型号/镜头、计划及来源、原预留/未知账单、批准/已用/剩余次数和状态。撤销走原 revoke;撤销后剩余次数不可领取。没有自动创建许可。 - 首帧入口必须主动选择已有许可并重新读取图片 Preview 与精确费用计划。项目/镜头/型号/来源/计划、原批准预算/有效期、追加剩余及其它在途请求逐项核对,最终领取仍由后端事务裁决。 - 原 unknown 本地保护不清除;追加使用包含项目、许可和已用次数的独立提交标识。一次提交后停止,不自动用完剩余次数;存在同计划完整结果时,只读核对候选,不再生成或设主图。 - 追加界面仅适用 OpenAI,其它供应方保留原保护。授权响应结构不完整时显示读取错误,不将其当成空授权或允许重试。 - 图片审计复用项目设置的同一 AppDrawer/固定 footer。原 project/request/identity 和 taskFingerprint、evidenceSetFingerprint、reviewFingerprint 全部来自正式 GET。 - 证据登记默认执行/费用未知、金额 null、无供应方编号和空材料;独立复核默认保留阻断。用户另行选择正式材料、填写署名/理由/真实摘要、切换决定并确认后才能提交。 - 校验 USD 整数微美元精度;零金额必须显式填写,null 不显示为0。本地请求、候选、授权、镜头、项目及材料中的 LangSmith 编号不能冒充供应方请求号。 - 登记不解除阻断,核清不覆盖原 unknown/账单/预留,也不代表生图成功、质量 Passed 或 Primary 可采用。核清后刷新原授权余额,原同计划没有结果的 unknown 仍不能普通重发。 - 编辑、GET刷新或409撤销确认;409保留全部表单并重读正式版本,无自动第二次 POST。切项目/请求清空材料、签署和选择,迟到响应不回填。 ## 正式 API 对接 下表的写入流程均由隔离 Mock 验证;正式服务仅进行免费只读核对,没有为验收在真实项目登记证据或采用草案。 | API | 用途及结果 | | --- | --- | | GET/PUT 原 keyframe-review-draft | 复用原草案保存及 expectedRevision,保留完整原稿与显式 providerInput | | POST 原 keyframe/preview | 草案与正式模式分离;联合使用本镜/邻镜派生版本,采用后重读正式 Preview | | POST projects/:projectId/storyboard-derived-reviews/confirm | 原接口新增 jointRevision,免费预检/正式采用/幂等/冲突走同一契约 | | GET/POST projects/:projectId/image-authorizations | 保留原授权,新增 additional 分支、已用/剩余投影,首帧显式选择使用 | | POST image-authorizations/:authorizationId/revoke | 原接口撤销持续授权或追加许可,保留历史 | | GET projects/:projectId/image-requests/:requestId/audit | 原身份、原费用、阻断及证据/复核历史读取 | | POST 原 audit/evidence | 原完整身份/版本绑定,登记与解除分开 | | POST 原 audit/reviews | 独立复核携带三项并发版本,409读取正式GET,不自动重提 | | POST 原 storyboard-shots/:shotId/keyframe | 仅用户操作时附 additionalAuthorizationId 和原项目 scope,Preview 不携带许可字段 | | GET/SSE 原 WorkflowExecution | 沿用原观察链;刷新、重进或订阅重连不生成 POST | 真实只读核对的时点结果: - `localhost:3412/api` 的保存草案 5.2 返回 revision1/stale,主体 formId 与正式 subjectFormId 相同,未做猜测映射或重存。 - 项目 `cmw02vpwi000005axrdtus3pa` 的授权 GET 为200:持续授权1、追加许可1、billingBlocked=true、unknown1。原阻断请求 `cmwhxdc0i0003rocjcz80n31v` 保留。 - 上述原请求 audit GET 为200:unknown、预留 USD1、原实际账单 null、Provider Request ID null、无原成功回执、unreviewed、billingBlocked=true,证据及复核历史均0。没有声称该正式请求已核清。 - 正式质量确认 GET 为200,valid=true、60镜。本轮观察期间另有后端任务继续生产,正式页面 D/VS 覆盖随之变化,不能把该变化计为本轮执行成果。 ## 时间语义 当前主体/环境显示为本镜0秒开拍状态,允许已经开始的持续动作。continuityNote 仅按后端明确的【输入事实】【规划末态】【连续要求】【视频末态】四种标记排版,旧无标记原文完整保留,不靠动作关键词判定有效性。视频末态明确仍需真实视频证据。 VISUAL_STATE_START_CONFLICT 显示开拍状态冲突;VISUAL_STATE_TIME_NEEDS_REVIEW 显示人工待核对;VISUAL_STATE_VIDEO_END_UNSUPPORTED 显示真实视频末态缺证。原 code/severity/field、原回执导出及集/段落/镜头位置保留,不把 needs_review 转为通过。 ## 文件职责 以下路径相对前端根目录。含后续浏览精简及目录/按钮补充,新增25个文件、修改25个文件、删除0个文件;没有修改依赖或锁文件。 | 状态 | 文件 | 职责 | | --- | --- | --- | | 新增 | src/features/storyboard/joint-review.ts | 完整稳定比较与允许/越界差异声明 | | 新增 | src/features/storyboard/components/JointDraftFields.vue | 原摄影字段组件复用及有界开拍字段 | | 新增 | src/features/storyboard/components/JointDraftReviewPanel.vue | 草案读取/保存、版本、邻镜、预检、采用和冲突处理 | | 新增 | src/features/storyboard/visual-state-time.ts、components/VisualStateContinuity.vue | 统一时间标记及问题标题、共享原文展示 | | 新增 | src/features/billing-audit/types.ts、labels.ts、evidence.ts、BillingEvidenceFields.vue | 图片/视频共享原件类型、文案、校验、表单 | | 新增 | src/features/image-authorization/billing-audit.types.ts、billing-audit-api.ts、billing-audit.ts | 图片原身份、正式审计API、金额与核清条件 | | 新增 | src/features/image-authorization/useImageBillingAudit.ts、ImageBillingAuditPanel.vue | 同一授权抽屉的图片登记/独立复核/历史/409 | | 新增 | tests/features/storyboard/joint-review.test.ts、tests/fixtures/joint-review.ts | 联合保存/预检/采用/幂等/冲突/时间与完整差异 | | 新增 | tests/features/storyboard/page-browsing.test.ts | 历史回执恢复不弹窗、目录浏览与生成范围勾选分离 | | 新增 | tests/features/storyboard/directory-position.test.ts | 真实目录包装结构中的段落吸顶高度避让回归 | | 新增 | tests/features/image-authorization/additional.test.ts、tests/fixtures/image-additional.ts | 许可范围/次数/撤销/预算、原guard保留及一次主动生成 | | 新增 | tests/features/image-authorization/billing-audit.test.ts、tests/fixtures/image-billing-audit.ts | 登记/独立复核、精度/null、409、范围隔离与历史 | | 新增 | tests/browser/review-billing.html、review-billing.ts | 真实组件的内存隔离验收页,全fetch拦截,未知路由403,无真实回退 | | 新增 | docs/audits/v8-9-4-9-frontend-integration-2026-11-16.md | 本轮交接、验证和边界 | | 修改 | src/features/storyboard/components/ShotDerivedReview.vue | 原摄影抽屉内的联合模式与固定底栏 | | 修改 | src/features/storyboard/StoryboardPage.vue、components/StagedShotPreparation.vue | 配置只由用户打开、普通目录无多选、历史按需展开与精简说明 | | 修改 | src/composables/useDirectorySelection.ts、src/components/ui/ActionMenu.vue | 语义分组定位标题、更多按钮统一默认中性底色 | | 修改 | src/features/storyboard/derived-review.types.ts、derived-review-api.ts | 联合正式字段、预览/采用回执及原路由 | | 修改 | src/features/storyboard/components/ShotDesign.vue、GenerationReceipt.vue | 开拍/衔接及时间问题展示 | | 修改 | src/features/storyboard/types.ts、src/features/workflows/WorkflowExecutionPanel.vue | 保留时间问题码/级别/位置与原逐集回执 | | 修改 | src/features/image-authorization/types.ts、api.ts、model.ts、ImageAuthorizationSettings.vue | 追加许可、精确资格、原余额/未知、同抽屉图片审计 | | 修改 | src/features/production/components/KeyframeDialog.vue、ShotProductionAssets.vue | 原首帧选择许可/重新预览/一次提交/免费只读复用 | | 修改 | src/features/production/types.ts、api.ts | 可选追加许可及原项目请求范围 | | 修改 | src/features/subject-images/generation-preview.ts | 共用精确费用核对及只读复用回调,原收费保护保留 | | 修改 | src/features/production/components/VideoAuditPanel.vue、video-audit.ts | 视频原证据字段/校验复用共享实现,保留原视频操作与导出 | | 修改 | src/lib/billing-errors.ts、user-facing-text.ts | 追加/审计/联合/时间中文原因、网络与Provider配额区别 | | 修改 | docs/api-contract-sync.md | 本轮契约同步索引 | ## 自动化与本地 Chrome 本轮新增3套34项测试;专项测试覆盖完整差异、保存/采用分离、冻结请求、幂等、邻镜409、旧模式、许可次数/撤销/预算/跨项目镜头型号来源计划、原guard、未知历史/null金额、登记与独立复核分离、证据版本409和项目隔离。共享视频原能力及原图片预览/候选恢复由现有回归覆盖。 首次全量发现其它图片供应方失败候选也尝试读取追加许可,已收紧到 OpenAI,补正式响应结构核对。原下载恢复和新增追加相关2套25项已通过;最终全量结果见下方验证记录。 本地 Chrome 复用原标签页及 `localhost:4312`;所有写入在 `/tests/browser/review-billing.html` 全拦截隔离页面,只用原生AX/键鼠/截图,没有 Playwright。已验证: 1. 原摄影模式切联合、编辑完整草案、保存7→8版、完整前后差异、邻镜2.1、免费预检、人工勾选后采用;正式 D/VS/Preview 刷新、原草案stale与历史保留,没有生图。 2. 预检后模拟邻镜变化:正式采用409,输入保留、预检和确认撤销;用户明确重读、再次预检/确认后才采用。 3. 原 unknown 下手填追加次数2、批准材料与风险确认,登记后未生成;首帧默认不选许可,主动选择并重新预览后仅1次模拟图片请求;再次同计划查看完整候选不增加请求。 4. 已用1/2、剩余1;撤销后不可领取,原 unknown、预留/null账单及新 completed 两笔均保留。 5. 手填仅供Mock的执行/账单原件登记后仍阻断;另切独立复核,默认保留,主动选证据/核清/署名/理由/SHA/确认后核清。原 unknown、原预留及未知实际账单仍保留;历史展示登记与第1次独立复核。 6. 390×844 窄屏检查完整差异、四类时间说明、长表单和审计历史,正文滚动、标题及底栏固定、字段有留白,关闭按钮可见。恢复临时视口到原桌面尺寸。 7. 刷新隔离页为0模拟同步操作/0模拟图片请求/0真实模型请求;没有刷新触发写入。费用409保留表单与跨项目隔离由自动化覆盖。 截图保存在 `/Users/goujun/.codex/visualizations/2026/11/15/01a1df1f-2851-7ff2-b840-d1a0f3154f74/v8-9-4-9/`:joint-adopted-desktop.jpg、joint-diff-mobile.jpg、image-audit-mobile.jpg。 最终验证记录: - Vitest 全量116个文件、907项通过,0失败/0未处理错误;其中本轮新增34项。 - Vue TypeScript `vue-tsc --noEmit` 通过。 - 改动范围 Oxlint、全部修改/新增 Vue 的 ESLint、Oxfmt 检查通过,无警告;文档补齐后只重新检查对应文档和差异。 - Vite生产构建通过,4964个模块,未把隔离测试页面作为生产构建入口。 - `git diff --check` 通过;初轮涉及前端44个文件,后续浏览精简共47个文件,没有依赖或锁文件变动。 ## 分镜浏览精简补充 用户反馈普通目录多选、进入页面自动弹出配置和说明过多后,定位并修复以下原因: - 目录多选来自页面固定传入 selectable,且生成抽屉已有重复选择器。普通目录改为单纯浏览;完整按段落/镜头勾选保留在“生成与恢复 → 选择镜头”。切换到当前集/全项目范围不再显示不适用的勾选区。 - 自动弹出来自 useStoryboard 在恢复历史 Workflow 终态后设置 session.receipt,页面 watcher 把任何回执变化都当成打开指令。移除 watcher 中的打开动作,保留回执、状态观察和镜头重生成后的时长刷新;只有主动点击入口打开配置。 - 默认保留摄影参数/意图与0秒环境摘要,完整构图/机位、连续性和主体状态使用 NCollapse 按需展开,原创作正文完整保留。全项目进度归入生成配置,删去重复介绍;覆盖风险、费用及作用范围继续在原确认流程展示。 - 已完成任务及原回执默认收起;正在执行、待读取和失败记录仍直接显示,不隐藏费用未知或失败处理入口。 先复现两项失败回归,再修复;定向5套35项通过,TypeScript、修改范围 Oxlint/Vue ESLint/格式及生产构建通过。本地 Chrome 复用正式 localhost 页面,只读刷新后不弹窗且无目录多选;验证点击切镜、展开完整摄影原文、生成范围勾选/取消、历史回执保留、390px长内容滚动和固定关闭底栏,未执行生成或正式写入。桌面及移动截图在本轮截图目录的同级 `storyboard-cleanup/`。 用户指定的 Leonxlnx/taste-skill 当前为 tasteskill 2.5.1,主要面向公司官网。可借用 references/copy.md 的短文案/一事实一处/按钮动作命名,copy-voice.md 的用户用语与精简确认,SKILL.md 的单一设计系统和实际浏览器验收。营销页的单屏节奏、随机配色、动效和图库模板不适用当前工作台;继续采用项目 Vue/Naive UI/主题变量及本地 Chrome 规则,不复制官网资产或执行其自动浏览器脚本。 已通过官方 skill-installer 将固定版本 `f6b76575f949707b4e3c37cd86cb44b0b98643e8` 安装到 `/Users/goujun/.codex/skills/taste-skill`,原有其它技能保留;安装后的1631个文件逐一校验 Git blob SHA 全部一致。初始浮动分支下载受网络影响,最终改用固定版本归档完成,未执行下载 skill 内的代码或修改项目依赖。新安装技能从下一条消息可用。 后续目录/工具栏修复:镜头条目新增包装后,原自动定位依赖两层父节点,未找到实际段落标题,导致首行镜号进入吸顶标题下方;现改按最近语义分组查标题并保留真实高度。连续性按钮使用正式 icon 插槽,桌面和手机都显示;更多按钮采用公共默认中性底面并移到三项操作最左侧。新增定位回归先失败(实际滚动160,预期122),修复后相关4套12项通过,类型/Lint/格式及构建检查通过。Chrome复用正式localhost页面,验证段落首镜完整露出、更多菜单保留导出、本组三按钮底色/图标/顺序、390px布局与键盘焦点,未执行生成。截图在同级 `toolbar-directory/desktop.jpg`、`toolbar-directory/mobile.jpg`。当前前端总计50个变动文件,仍未提交或推送。 ## 未完成项及交付边界 - 指定基线内没有已知未接入的前端目标。真实生成、正式采用/追加批准/证据登记/核清及真实质量/Primary没有执行,这是本轮明确禁止或保护正式数据的边界;写入成功/失败由隔离 Mock 验证,不称作正式业务验收。 - 后端工作区另有并行未提交的 Beat6 当前集正文与环境联合修订扩展。它超出本轮指定已提交基线;当前前端继续将环境视为不可联合修改,不猜测 environmentSource 或自动新增环境编辑,未改动后端文件。 - 本轮所有真实收费模型调用为0,没有改变正式请求状态或伪造 Provider ID/费用证据。没有自动执行任何图片/文字/Vision/Repair/视频/Primary,也没有历史 unknown 自动重试。 - 前端保持 `dev@87427d9`,改动未提交、未push;没有切换或合并发布分支。