diff --git a/docs/audits/b04-frontend-integration-2026-11-09.md b/docs/audits/b04-frontend-integration-2026-11-09.md new file mode 100644 index 0000000..8edb5bf --- /dev/null +++ b/docs/audits/b04-frontend-integration-2026-11-09.md @@ -0,0 +1,82 @@ +# 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 整体完成或项目可以直接生成视频。 diff --git a/src/features/production/components/ContinuityReviewDrawer.vue b/src/features/production/components/ContinuityReviewDrawer.vue index e790403..a8d65df 100644 --- a/src/features/production/components/ContinuityReviewDrawer.vue +++ b/src/features/production/components/ContinuityReviewDrawer.vue @@ -605,6 +605,9 @@ function updateFrame(index: number, value: GeometryFrameObservation) {
镜头 {{ issue.scope }}:{{ userFacingText(issue.message) }}
++ 保留非阻断未知:{{ item.featureKey }} · {{ item.evidence }}(未核实通过) +
本次提交的固定结构观察未发现冲突。
+ 保留非阻断未知:{{ item.featureKey }} · {{ item.evidence }}(未核实通过) +
++ 当前性:{{ + reviewQuery.data.value.invalidation ? '已失效' : '当前有效' + }};本组签收不代表整个项目可生成视频。 +
原审核结论:{{ continuityStatusLabels[reviewQuery.data.value.diagnosis.status] }}
当前状态:{{ continuityStatusLabels[reviewQuery.data.value.status] }}
+import { validationPreviewApi } from '../validation-preview' +import ValidationPreviewPanel from './ValidationPreviewPanel.vue' import { userFacingText } from '../../../lib/user-facing-text' import { videoOperationAllowed } from '../video-permissions' import FeedbackMessage from '../../../components/ui/FeedbackMessage.vue' @@ -61,6 +63,30 @@ const visionKey = computed(() => : '' ) const vision = useKeyframeVision(visionKey) +/** 免费计划随候选范围取消旧请求。 */ +const validationPlan = useQuery(visionKey, async (value, signal) => { + if (!value) return null + const [shot, image, project] = JSON.parse(value) as [string, string, string] + return validationPreviewApi(shot, image, project, signal) +}) +/** 计划加载或改变后撤销旧批准。 */ +watch([validationPlan.data, validationPlan.loading], () => { + acknowledged.value = false +}) +/** 任务终态后重新免费核对计划,当前质量由既有观察器回读。 */ +watch( + () => vision.execution.data.value?.status, + status => { + if (visionKey.value && (status === 'completed' || status === 'failed')) void validationPlan.refresh() + } +) +/** 普通审核必须先取得可执行计划。 */ +const planBlocked = computed( + () => + props.target?.kind === 'keyframe' && + action.value === 'validate' && + (validationPlan.loading.value || !!validationPlan.error.value || validationPlan.data.value?.status !== 'ready') +) /** 当前候选质量独立回读,不以本会话或后台回执作为当前结论。 */ const currentQuality = useEffectiveKeyframeQuality(visionKey, vision) /** 人工审核完成后同步当前质量和外层资产。 */ @@ -267,6 +293,7 @@ watch( async function submit() { if ( !acknowledged.value || + planBlocked.value || !valid.value || blocked.value || visionBlocked.value || @@ -275,7 +302,16 @@ async function submit() { ) return acknowledged.value = false - await run(action.value, input.value) + const planned = props.target?.kind === 'keyframe' && action.value === 'validate' + await run( + action.value, + planned ? { ...input.value, allowedTexts: [] } : input.value, + undefined, + planned && validationPlan.data.value + ? { expectedValidationFingerprint: validationPlan.data.value.validationFingerprint } + : undefined + ) + if (planned) await validationPlan.refresh() if (visionKey.value) void vision.history.refresh() } @@ -322,6 +358,21 @@ const optionsExpanded = ref+ {{ userFacingText(validationPlan.error.value) }} +
正式动作 {{ action.actionId }} 是否依赖此证据
+非阻断未知只允许继续来源审核;不代表视觉审核通过或可以生成视频。
++ 机位:{{ + form.preview.value.applicabilityBasis.cameraMovement === 'static' + ? '固定机位' + : '非固定或尚未确认的机位' + }} + · 正式动作 + {{ form.preview.value.applicabilityBasis.actionIds?.join('、') || '未提供,不能判为非阻断' }} +
+{{ action.id }}:{{ action.description }}
+未读到完整正式动作原文,请核对高级详情;不能凭动作编号猜测依赖。
++ 参考 {{ item.imageNumber }} · + {{ + sourceFindingLabels[item.dimension as keyof typeof sourceFindingLabels] ?? item.dimension + }}:原观察 {{ findingOptions.find(option => option.value === item.finding)?.label ?? '未知' }} · + {{ + item.applicability === 'non_blocking_unknown' + ? '非阻断未知(未核实通过)' + : item.applicability === 'blocking_unknown' + ? '阻断未知' + : '必要证据' + }} +
+
结果或费用待核查,仅可只读刷新,不自动重发。
diff --git a/src/features/production/components/ValidationPreviewPanel.vue b/src/features/production/components/ValidationPreviewPanel.vue
new file mode 100644
index 0000000..7e793e4
--- /dev/null
+++ b/src/features/production/components/ValidationPreviewPanel.vue
@@ -0,0 +1,73 @@
+
+
+
+
+ {{
+ plan.status === 'ready'
+ ? '可以准备本次审核确认'
+ : plan.status === 'blocked'
+ ? '暂不能开始新审核'
+ : '已有同计划结果,可直接查看'
+ }}
+
+ 模型:{{ plan.model }} ·
+ {{ plan.steps.map(s => validationStepNames[s as keyof typeof validationStepNames] ?? s).join(' → ') }}
+ 每步 {{ plan.actualImagesPerStep }} 张图片,最多 {{ plan.maximumProviderRequests }} 次请求。
+ 执行费用:{{
+ plan.feeEstimate.amount === null
+ ? '未知,需先核对费用范围'
+ : `${plan.feeEstimate.amount} ${plan.feeEstimate.currency}`
+ }}。预检免费。
+ 有 {{ plan.activeTasks.length }} 个审核正在执行,请查看原任务。 有 {{ plan.unresolvedTasks.length }} 个任务的结果或费用待核查。 审核模型或步骤已变化,请先处理已有计划冲突。
+ 历史审核:{{ plan.reusableResult.passed ? '通过' : '未通过' }}。{{ plan.reusableResult.summary }}
+ 当前可用性以当前质量为准。
+ 审核图片 1 · 原图({{ plan.image.width }} × {{ plan.image.height }}) SHA:{{ plan.image.sha256 }} 审核图片 {{ reference.imageNumber }} · 生成参考 {{ reference.generationImageNumber }}
+ {{ binding.subjectRef }} · {{ binding.role }}
+ SHA:{{ reference.sha256 }}
+ {{ change.subjectRef }}:{{ change.before || '未填写' }} → {{ change.after }}
+ 理由:{{ reviewed.selection.draft.subjectStateRevision.reason }} 当前质量可能变为来源过期;修订不代表视觉审核通过。免费审核预检
+
当前正式视线:{{ formalGaze.gaze || '未填写' }}
+ + ++ 只修改所选主体视线。采用后需要重新核对来源与质量,历史审核结论和主图保留。 +
+前镜 {{ previousShot.beatNo }}.{{ previousShot.shotNo }} · {{ previousShot.title }}
diff --git a/src/features/storyboard/derived-review.ts b/src/features/storyboard/derived-review.ts index 8d245d4..8efaf07 100644 --- a/src/features/storyboard/derived-review.ts +++ b/src/features/storyboard/derived-review.ts @@ -62,3 +62,31 @@ export function draftFromFormal(shot: DesignedShot, keyframe: KeyframeSpec, fing } } } + +/** + * 在正式草案副本上声明单主体视线修订,其它事实原样保留。 + * @param formal 当前正式草案 + * @param subjectRef 正式主体 + * @param after 新视线 + * @param reason 人工理由 + * @returns 仅视线变化的完整草案 + */ +export function reviseSubjectGaze( + formal: ShotReviewDraft, + subjectRef: string, + after: string, + reason: string +): ShotReviewDraft { + if (formal.subjectStateRevision || formal.sceneStateCarryForward) + throw new Error('请从当前正式状态重新修订,不能混入其它草案。') + const draft = JSON.parse(JSON.stringify(formal)) as ShotReviewDraft + const subject = draft.visualState.subjects.find(s => s.subjectRef === subjectRef) + if (!subject || !after.trim() || !reason.trim() || subject.gaze === after.trim()) + throw new Error('请选择正式主体,并填写不同的新视线和修订理由。') + draft.subjectStateRevision = { + reason: reason.trim(), + changes: [{ subjectRef, field: 'gaze', before: subject.gaze, after: after.trim() }] + } + subject.gaze = after.trim() + return draft +} diff --git a/src/features/storyboard/derived-review.types.ts b/src/features/storyboard/derived-review.types.ts index b48550c..33f761b 100644 --- a/src/features/storyboard/derived-review.types.ts +++ b/src/features/storyboard/derived-review.types.ts @@ -36,6 +36,16 @@ export interface ShotReviewDraft { /** 参考图编号。 */ imageId: string /** 几何版本。 */ spatialLayoutVersion: string }> + /** 仅明确声明的主体视线修订,不混入其它模式。 */ + subjectStateRevision?: { + /** 人工确认理由。 */ reason: string + /** 完整的原值与目标值。 */ changes: Array<{ + /** 当前正式主体。 */ subjectRef: string + /** 首版仅允许视线。 */ field: 'gaze' + /** 正式原值。 */ before: string + /** 明确的新值。 */ after: string + }> + } /** 用户明确选择的前镜状态来源。 */ sceneStateCarryForward?: { /** 同集紧邻前镜。 */ previousShotId: string diff --git a/src/lib/user-facing-text.ts b/src/lib/user-facing-text.ts index c40549f..0000bc1 100644 --- a/src/lib/user-facing-text.ts +++ b/src/lib/user-facing-text.ts @@ -1,5 +1,11 @@ /** 项目配置的确定性业务状态说明,不将配置限制显示为系统故障。 */ const configurationErrorLabels: Record