Files
short-drama-agent-front/docs/audits/b04-frontend-integration-2026-11-09.md
T

83 lines
7.8 KiB
Markdown
Raw 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.
# B04-18 / B04-22 / B04-25 前端接入记录
日期:2026-11-09。仅修改前端根目录 dev,未提交、未推送、未创建工作树。
前端基线 c7a6b1226114d3889e353dc4b0fa733c8ace958d,与本次 fetch 的 origin/dev 一致;后端基线 e7035e68c2bd4239947bef764354819f0f15daac。
## 1. 已补齐功能
- 普通 Vision:QualityDialog 免费读取计划,展示 ready/blocked/reusable、模型、步骤、真实请求次数、原图/参考和摘要、未知费用、在途及未结任务、失败结果复用。点击提交前再次免费核对计划,POST 携带 expectedValidationFingerprint;任何变化撤销确认,409 不自动重试。原图片读取接口的 /api 路径按当前服务源转换为绝对图片地址。
- 来源复核:结构/空间 unknown 可单独声明适用范围,保留原观察;主体从实际绑定选择,全部 RequiredActions 逐项填依赖及原因,状态/构图/无反证/其它证据均不预填。缺动作、非静态机位不提供非阻断选项,其它必要依赖或声明不完整时禁止保存。明确 failed 不开放适用范围。
- 非阻断来源按服务端 validationEligible 准备独立免费计划,明确 false 不被 passed 文案覆盖。保存后回读记录与历史,由现有 changed 通知刷新当前质量和外层资产;409 撤销独立计划和批准。
- 主体 gaze:复用单镜摄影抽屉,从新鲜正式 Direction、VisualState、sceneSources 构建完整 draft,同步声明原值/新值/理由与对应 gaze,保留其它字段。保存、预览、采用继续使用原接口和版本保护。采用前展示变更范围,版本冲突刷新正式依据并等待重新确认。
- 连续性:非阻断未知在最新诊断和历史签收中单列,签收状态与当前性分开;三镜签收不表示项目视频就绪。当前质量继续由 effective-keyframe-quality.ts 消费正式服务端结论,历史 failed 不改写为通过。
## 2. 复用模块
复用 QualityDialog、SourceReviewDrawer、ShotDerivedReview、AppDrawer、AppDialog、NCollapse、AssetImage、消息层、useQuery 取消机制、useEffectiveKeyframeQuality、useKeyframeVision、原 WorkflowExecution GET/SSE、原来源批准接口与独立 Primary 确认入口。没有新增审核或质量状态计算系统。
## 3. 新增文件与职责
| 文件 | 职责 |
| --- | --- |
| src/features/production/validation-preview.ts | 普通免费审核计划类型、GET、正式参考图片路径转换 |
| src/features/production/components/ValidationPreviewPanel.vue | 当前计划和实际图像核对 |
| src/features/production/source-applicability.ts | 人工范围类型、完整性与必要条件校验 |
| src/features/production/components/SourceApplicabilityFields.vue | 未知维度的明确人工声明表单 |
| tests/fixtures/validation-preview.ts | 免费计划隔离数据 |
| tests/features/production/b04-applicability.test.ts | 非阻断范围边界、正式图片地址回归 |
| tests/browser/b04-review.html / b04-review.ts | Chrome 真实组件隔离页,API 写请求全部拒绝 |
| 本记录 | 交付与限制说明 |
## 4. 修改文件与职责
- production/components/QualityDialog.vue、useQuality.ts、keyframe-vision.ts、quality.types.ts:计划展示、确认撤销、提交版本核对和原任务观察。
- production/components/SourceReviewDrawer.vue、useSourceReview.ts、source-review.ts:适用性上下文、表单、保存、服务端准入和独立免费计划。
- production/components/ContinuityReviewDrawer.vue、continuity.types.ts:非阻断未知和签收当前性。
- storyboard/components/ShotDerivedReview.vue、derived-review.ts、derived-review.types.ts:有界视线编辑、完整草案、原值与采用范围。
- lib/user-facing-text.ts:正式主体修订、来源适用性错误的中文说明。
- tests/features/production/quality.test.ts、source-review.test.ts、tests/features/storyboard/derived-review.test.ts:补充计划、非阻断准入与视线回归。
## 5. 重复实现处理
未删除原审核系统或历史记录。普通计划模式不再展示与计划不一致的旧“最多一次审核”提示或可变文字白名单输入;其它既有审核/修复入口保留。没有创建第二套质量计算器。
## 6. 自动化验证
- 全量 Vitest:107 文件、811 用例通过;随后增加图片路径与服务端非阻断资格两个用例,均定向通过。
- 最后相关回归:计划/适用性/来源/视线共 4 文件、48 用例全部通过。
- TypeScript vue-tsc --noEmit、全仓 Oxlint、相关 Vue ESLint 通过;格式化及 git diff --check 通过。
- 使用本地已安装工具运行,未安装依赖。所有模型请求测试使用隔离响应。
## 7. Chrome 验收
使用本地 Google Chrome、localhost:4312,复用本任务标签页;未使用 Playwright。
- 真实项目:正式摄影抽屉、旧草案 stale、从正式状态进入 gaze、正式主体选择、原视线展示、空表单禁用提交;桌面暗色和 iPhone SE 375×667 布局、正文滚动及固定底栏。
- 隔离页:普通 ready/blocked/reusable、未知费用、失败历史与当前 stale 分离、来源 unknown 和空白依赖声明、静态原图与参考、桌面/375px 单列布局和固定关闭/保存栏。
- 真实生产页保留原有整项目门禁,当前仍提示主体形态图片待准备,因此未在该页完成真实保存/付费操作闭环。隔离页面明确拒绝 API 写入。
- 未提交真实用户数据、采用正式修订、发起审核、生图、生视频或改 Primary。真实保存、采用后失效和收费任务完成等场景由现有/补充自动化回归覆盖,不能当作真实生产写入验收。
## 8. 真实只读接口核验与未完成项
项目 cmw02vpwi000005axrdtus3pa:60 镜,首组三镜 skipped=已有可用 Primary,当前 primaryQualityStatus 均 passed 且来源非 stale;其余 57 镜阻断,57 个规格问题、40 个缺参考问题(分类可能重叠)。
逐镜 quality-review:1.1、2.1、2.2 的 effectiveQualityStatus 与历史 qualityDecision 均 passed。
普通免费计划:1.1 reusable、qwen3.8-max、最多 2 请求、每步 5 图,amount=null;2.1/2.2 返回 409 IMAGE_INPUT_STALE。这与“旧像素对照新来源使用独立来源审核,不能普通审核重盖来源”的契约一致,不据此改写当前 passed。
已存三镜签收 cmw7y6sqt0008rono7bv2lopl GET:status=passed、invalidation=null;diagnosis.nonBlockingUnknowns 保留 2.2 的 fixed-door-frame-connection,明确局部不可辨、不能确认轴侧,未核实为通过。
仍未完成:真实数据保存/采用/收费执行的端到端人工验收,本次禁止借验收改正式结果或触发付费;其余 57 镜资产与规格准备也不属于本轮自动补齐范围。
## 9. B04-25 契约一致性与后端问题
已核对后端正式路由、ShotKeyframeReviewDraftSchema、SubjectStateRevisionSchema、SaveShotKeyframeReviewDraftSchema、StoryboardDerivedReviewConfirmationSchema 和服务实现。
提交完整 draft,field 固定 gaze,before 来自最新正式记录,after 和理由由用户填写;正式来源指纹与草案预览指纹分别携带,沿用用户核对的模型参数;不发送 sceneStateCarryForward 或 sceneSourceRecovery,不混入未采用机位稿。400/409 由原 HTTP 层处理并映射中文,版本冲突不重发。
目前没有确认的后端缺陷或必须新增的接口,暂不需要后端修改 prompt。2.1/2.2 普通预检 409、项目入口阻断均属于当前正式来源/准备门禁,不要求后端放宽。
## 10. V02-06
可以继续 V02-06 剩余有序组审核功能的开发与只读准备;首组三镜已核验的通过不能扩展为全部项目准入。正式生成仍须消除相应范围门禁、逐次取得明确费用批准。本轮不宣称 V02-06 整体完成或项目可以直接生成视频。