Files
short-drama-agent-front/src/features/storyboard-preparation/StoryboardPreparation.vue
T

188 lines
20 KiB
Vue
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.
<script setup lang="ts">
import { computed, ref, watch } from 'vue'
import { NButton, NCheckbox, NFormItem, NInput, NTag } from 'naive-ui'
import { ArrowLeft, CheckCheck, RefreshCw, Save, ShieldCheck, Wrench } from '@lucide/vue'
import AppDrawer from '../../components/ui/AppDrawer.vue'
import WorkspaceSectionHeading from '../../components/ui/WorkspaceSectionHeading.vue'
import QualityPolicySettings from '../generation-config/components/QualityPolicySettings.vue'
import FormalRepairEditor from './FormalRepairEditor.vue'
import ConfirmAction from '../workflows/ConfirmAction.vue'
import WorkflowExecutionPanel from '../workflows/WorkflowExecutionPanel.vue'
import { useWorkflowExecution, hasActiveWorkflowExecution } from '../workflows/execution'
import { getOperation, runOperation } from '../workflows/operations'
import { storyboardApi } from '../storyboard/api'
import { projectsApi } from '../projects/api'
import { useStoryboardPreparation } from './useStoryboardPreparation'
import { currentStoryboardApproval } from './model'
import { preparationApi } from './api'
import type { PreparationIssue } from './types'
import { qualityPolicyConfirmed, qualityPolicySignature, validateQualityPolicyReceipt } from '../projects/quality-policy-confirmation'
import { userFacingText } from '../../lib/user-facing-text'
/** 制作前检查统一入口,即使后续页面尚未开放也可以补齐审核。 */
const props = withDefaults(defineProps<{
/** 当前正式项目。 */ projectId: string
/** 外部项目读取失败或主任务锁。 */ disabled?: boolean
}>(), { disabled: false })
/** 所有写入或后台终态后让调用方刷新实际导航状态。 */
const emit = defineEmits<{ changed: [] }>()
/** 全屏入口,未打开不读取完整复检。 */
const open = ref(false)
/** 当前项目任务观察与表单共同绑定项目。 */
const id = computed(() => props.projectId)
/** 首次打开后才观察派生任务,关闭不丢失正在运行的任务。 */
const watchedProject = ref('')
/** 镜头设计与画面状态沿用真实持久化任务。 */
const directionTask = useWorkflowExecution(watchedProject, 'storyboard-direction')
/** 画面状态单独观察,不把 HTTP 受理当作完成。 */
const visualTask = useWorkflowExecution(watchedProject, 'storyboard-visual-state')
/** 活动任务及发现失败时暂停写入,不依赖本次点击的加载状态。 */
const locked = computed(() => props.disabled || getOperation(id.value).pending || hasActiveWorkflowExecution(id.value) ||
directionTask.discovering.value || visualTask.discovering.value || !!directionTask.discoveryError.value || !!visualTask.discoveryError.value)
/** 复检与独立人工确认流程。 */
const flow = useStoryboardPreparation(id, locked)
/** 当前查看的正式修订目标,在同一抽屉中切换正文。 */
const repairIssue = ref<PreparationIssue | null>(null)
/** 正式修订编辑器,底栏调用统一保存。 */
const repairEditor = ref<InstanceType<typeof FormalRepairEditor> | null>(null)
/** 真实正式修订写入时锁定关闭。 */
const repairWriting = ref(false)
/** 项目质量规则表单,完整保留旧例外。 */
const policyEditor = ref<InstanceType<typeof QualityPolicySettings> | null>(null)
/** 规则确认及派生生成启动中的真实请求。 */
const actionWriting = ref(false)
/** 明确核对项目规则,打开时不默认勾选。 */
const policyAcknowledged = ref(false)
/** 旧分镜重新采用当前规则的明确确认。 */
const baselineAcknowledged = ref(false)
/** 当前正式分镜的整体人工确认。 */
const reviewAcknowledged = ref(false)
/** 真实审核人,不自动代填。 */
const reviewer = ref('')
/** 两种确认使用用户当前填写的说明,不使用模型代填。 */
const reviewNote = ref('')
/** 当前提交后的反馈,普通加载不加常驻错误。 */
const actionError = ref('')
/** 真实写入期间统一锁定抽屉。 */
const busy = computed(() => flow.writing.value || repairWriting.value || actionWriting.value)
/** 必要分项检查只依据真实返回,不使用结构通过代替质量通过。 */
const checks = computed(() => {
const data = flow.data.value
if (!data) return []
return [
{ label: '项目质量规则已确认', passed: flow.policyConfirmed.value },
{ label: '正式分镜采用的规则来源一致', passed: data.quality.provenance.qualityPolicyConsistent === true },
{ label: '结构与镜头来源检查通过', passed: data.quality.structure.valid === true && data.quality.sourceAudit.valid === true },
{ label: '主体引用与动作问题已处理', passed: data.quality.preflightEligible === true },
{ label: '当前版本已完成人工审核', passed: flow.approved.value },
{ label: '可以进入制作计划', passed: data.entry.ready === true }
]
})
/** 任何规则或镜头证据变化都撤销旧勾选,不清空人工说明。 */
watch(flow.sourceKey, () => { policyAcknowledged.value = false; baselineAcknowledged.value = false; reviewAcknowledged.value = false })
/** 打开时读取;关闭立即废弃旧结果及未完成只读请求。 */
watch([open, id], ([shown]) => {
if (shown) watchedProject.value = id.value
else if (watchedProject.value !== id.value) watchedProject.value = ''
repairIssue.value = null; actionError.value = ''
if (shown) void flow.load()
else flow.cancel()
}, { flush: 'sync' })
/** 两个独立派生任务终态后重新读取真实准入。 */
for (const task of [directionTask, visualTask]) watch(() => task.query.data.value?.status, (status, before) => {
if (status !== before && ['completed', 'failed'].includes(status ?? '')) { if (open.value) void flow.load(); emit('changed') }
})
/** 明确确认当前项目规则,必要时先 CAS 保存,不调用拆解或模型。 */
async function confirmPolicy() {
if (locked.value || busy.value || flow.reading.value || !policyAcknowledged.value || !flow.data.value) return
const draft = policyEditor.value?.validatedDraft()
if (!draft) return
const projectId = id.value, expected = flow.data.value.policy
actionWriting.value = true; actionError.value = ''
const ok = await runOperation(projectId, '确认项目质量规则', async () => {
let current = validateQualityPolicyReceipt(await projectsApi.qualityPolicy(projectId), projectId)
if (id.value !== projectId || !open.value) throw new Error('项目或确认页面已变化,请重新核对。')
if (current.revision !== expected.revision || current.fingerprint !== expected.fingerprint) throw new Error('质量规则已变化,请刷新后重新核对。')
if (qualityPolicySignature(draft) !== qualityPolicySignature(current.policy)) current = validateQualityPolicyReceipt(await projectsApi.saveQualityPolicy(projectId, draft, current.revision), projectId)
if (qualityPolicySignature(current.policy) !== qualityPolicySignature(draft)) throw new Error('规则保存内容尚未确认,请重新核对。')
if (id.value !== projectId || !open.value) throw new Error('项目或确认页面已变化,请重新核对。')
const result = validateQualityPolicyReceipt(await projectsApi.confirmQualityPolicy(projectId, current.revision), projectId)
if (!qualityPolicyConfirmed(result) || result.revision !== current.revision || result.fingerprint !== current.fingerprint) throw new Error('规则确认结果不一致,请刷新。')
}, { type: 'info', content: '项目质量规则已确认,还需核对正式分镜的来源和质量。' })
actionWriting.value = false
if (id.value !== projectId) return
if (!ok) actionError.value = getOperation(projectId).error
await flow.load(); emit('changed')
}
/**
* 保存用户当前明确选择的审核记录,两种确认不能互相替代。
* @param kind 旧分镜规则来源或整体审核
*/
async function confirmReview(kind: 'baseline' | 'approval') {
if (!(kind === 'baseline' ? baselineAcknowledged.value : reviewAcknowledged.value)) return
if (await flow.confirm(kind, reviewer.value, reviewNote.value)) emit('changed')
}
/**
* 费用确认后重新核对正式审核,再启动需要补齐或更新的派生设计。
* @param kind 镜头设计或画面状态
*/
async function generate(kind: 'direction' | 'visual') {
if (locked.value || busy.value || flow.reading.value || !flow.approved.value || !flow.data.value) return
const projectId = id.value, expected = flow.data.value.approval.evidence
actionWriting.value = true; actionError.value = ''
const ok = await runOperation(projectId, kind === 'direction' ? '补齐镜头设计' : '补齐画面状态', async () => {
const latest = await preparationApi.approval(projectId)
if (id.value !== projectId || !open.value) return
if (!currentStoryboardApproval(latest, projectId) || latest.evidence.shotFingerprint !== expected.shotFingerprint || latest.evidence.checkpointId !== expected.checkpointId || latest.evidence.qualityPolicyRevision !== expected.qualityPolicyRevision || latest.evidence.qualityPolicyFingerprint !== expected.qualityPolicyFingerprint) throw new Error('正式分镜审核已变化,请重新检查并确认。')
const result = kind === 'direction' ? await storyboardApi.generateDirections(projectId, { concurrency: 2, force: false }) : await storyboardApi.generateVisualStates(projectId, { concurrency: 2, force: false, maxRepairAttempts: 2 })
if (!result.executionId) throw new Error('未取得任务编号,请刷新状态,避免重复提交。')
await (kind === 'direction' ? directionTask : visualTask).track(result.executionId, projectId)
}, { type: 'info', content: '设计任务已受理,请等待实际结果;已有当前有效设计会跳过。' })
actionWriting.value = false
if (id.value === projectId && !ok) actionError.value = getOperation(projectId).error
}
/** 正式保存后返回全局复检,不把局部修复当作整体通过。 */
async function repaired() { repairIssue.value = null; repairWriting.value = false; await flow.load(); emit('changed') }
</script>
<template>
<!-- 以下是项目顶部始终可到达的制作前检查入口 -->
<NButton size="small" class="preparation-trigger workspace-action-button" :disabled="disabled || !projectId" aria-label="制作前检查" @click="open = true"><template #icon><ShieldCheck :size="15" aria-hidden="true" /></template><span class="preparation-trigger-label">制作前检查</span></NButton>
<AppDrawer v-model:open="open" :title="repairIssue ? '修订正式分镜问题' : '制作前检查'" :busy="busy" description="先核对分镜、处理问题并完成人工审核,再补齐设计和进入镜头制作。">
<!-- 以下是在同一抽屉内查看当前正式镜头的修订模块 -->
<FormalRepairEditor v-if="open && repairIssue" ref="repairEditor" :project-id="projectId" :issue="repairIssue" :disabled="locked" @busy="repairWriting = $event" @saved="repaired" />
<div v-else-if="open" class="preparation-content space-y-6">
<div class="flex flex-wrap items-center justify-between gap-3"><span class="text-sm text-muted">检查只读取已有数据;确认、修订和生成均需单独操作。</span><NButton :loading="flow.reading.value" :disabled="busy" @click="flow.load"><template #icon><RefreshCw :size="15" /></template>刷新检查</NButton></div>
<p v-if="flow.reading.value && !flow.data.value" role="status" class="text-sm text-muted">正在检查当前正式分镜…</p>
<p v-if="flow.error.value || actionError" role="alert" class="problem-surface p-4 text-sm">{{ flow.error.value || actionError }}</p>
<p v-if="flow.notice.value" role="status" class="text-sm text-muted">{{ flow.notice.value }}</p>
<template v-if="flow.data.value">
<!-- 以下是分项检查,未知或未通过不伪装成成功 -->
<section class="space-y-4"><WorkspaceSectionHeading title="当前准备情况" description="结构通过、局部修订完成和整体审核是不同步骤。" /><div class="preparation-checks"><div v-for="check in checks" :key="check.label" class="flex items-center justify-between gap-4 text-sm"><span>{{ check.label }}</span><NTag :type="check.passed ? 'success' : 'default'" size="small" :bordered="false">{{ check.passed ? '已满足' : '待完成' }}</NTag></div></div></section>
<!-- 以下是第一次明确确认规则,不显示空白精确例外 -->
<section v-if="!flow.policyConfirmed.value" class="space-y-4"><WorkspaceSectionHeading title="核对项目质量规则" description="确认故事允许哪些动作;已有精确例外会继续保留。" /><QualityPolicySettings ref="policyEditor" :key="flow.data.value.policy.revision" :project-id="projectId" :initial-policy="flow.data.value.policy" :disabled="locked || busy" /><NCheckbox v-model:checked="policyAcknowledged" :disabled="locked || busy">我已核对当前项目质量规则</NCheckbox><NButton type="primary" :disabled="!policyAcknowledged || locked || busy || flow.reading.value" :loading="actionWriting" @click="confirmPolicy"><template #icon><ShieldCheck :size="15" /></template>确认项目质量规则</NButton></section>
<!-- 以下是旧分镜缺少规则记录时的明确重新核对,不重跑拆解 -->
<section v-if="!flow.data.value.quality.provenance.qualityPolicyConsistent" class="space-y-4"><WorkspaceSectionHeading title="核对旧分镜采用的规则" description="旧分镜没有完整规则记录时,由复核人明确采用当前已确认规则重新检查。不会重写历史记录,也不会重新拆解。" /><p v-for="reason in flow.data.value.baseline.reasons" :key="reason" class="text-sm text-muted">{{ userFacingText(reason) }}</p><template v-if="flow.baselineAllowed.value"><NFormItem label="复核人"><NInput aria-label="来源复核人" v-model:value="reviewer" placeholder="填写实际复核人" /></NFormItem><NFormItem label="核对说明"><NInput aria-label="来源核对说明" v-model:value="reviewNote" type="textarea" placeholder="说明核对范围及采用当前规则的依据" /></NFormItem><NCheckbox v-model:checked="baselineAcknowledged" :disabled="locked || busy">我已核对旧分镜,明确采用当前规则继续复检</NCheckbox><NButton type="primary" :disabled="!baselineAcknowledged || locked || busy || flow.reading.value" @click="confirmReview('baseline')">确认规则来源</NButton></template></section>
<!-- 以下是正式主体、动作及来源问题,局部修订独立确认 -->
<section class="space-y-4"><WorkspaceSectionHeading title="处理正式分镜问题" description="只修订明确的问题镜头。涉及规则来源或现有素材保护时,先处理对应限制。" /><p v-if="!flow.issues.value.length" class="text-sm text-muted">当前未返回具体镜头问题,请继续核对上面的来源条件和人工审核。</p><article v-for="(item, index) in flow.issues.value" :key="`${item.kind}-${index}`" class="problem-surface p-4 space-y-3"><p class="text-xs text-muted">第 {{ item.episodeNo }} 集 · 剧情段落 {{ item.beatNo }} · 镜头 {{ item.shotNo ?? '待核对' }}</p><p class="text-sm leading-6">{{ userFacingText(item.message) }}</p><NButton class="workspace-action-button" v-if="item.kind !== 'source' && item.shotNo" :disabled="locked || busy || flow.reading.value" @click="repairIssue = item"><template #icon><Wrench :size="15" /></template>查看并修订</NButton></article></section>
<!-- 以下是正式整体人工审核,不以只读预检或旧记录代替 -->
<section class="space-y-4"><WorkspaceSectionHeading title="人工确认整体分镜" description="检查通过后,由复核人核对动作、主体及镜头衔接。规则或镜头变化后原审核会失效。" /><p v-if="flow.approved.value" class="text-sm text-muted">当前正式分镜已有有效审核记录。</p><p v-else-if="!flow.reviewable.value" class="text-sm text-muted">请先处理规则来源、动作与主体问题,再进行整体审核。</p><template v-else><NFormItem label="审核人"><NInput aria-label="整体审核人" v-model:value="reviewer" placeholder="填写实际审核人" /></NFormItem><NFormItem label="审核说明"><NInput aria-label="整体审核说明" v-model:value="reviewNote" type="textarea" placeholder="说明已核对的动作、主体、画面衔接及结论" /></NFormItem><NCheckbox v-model:checked="reviewAcknowledged" :disabled="locked || busy">我已人工核对当前版本的全部正式分镜</NCheckbox><NButton type="primary" :disabled="!reviewAcknowledged || locked || busy || flow.reading.value" @click="confirmReview('approval')"><template #icon><CheckCheck :size="15" /></template>确认整体审核</NButton></template></section>
<!-- 以下是审核之后的设计补齐与真实生产入口状态 -->
<section class="space-y-4"><WorkspaceSectionHeading title="补齐镜头设计与画面状态" description="先更新镜头设计,再更新画面状态。只补齐缺失或过期结果,生成可能产生模型费用。" /><p class="text-sm text-muted">已保存镜头设计 {{ flow.data.value.entry.derivedAssets.directionCount }} / {{ flow.data.value.entry.derivedAssets.shotCount }} · 画面状态 {{ flow.data.value.entry.derivedAssets.visualStateCount }} / {{ flow.data.value.entry.derivedAssets.shotCount }}</p><div class="flex flex-wrap gap-3"><ConfirmAction label="补齐或更新镜头设计" description="处理整个项目中缺失或过期的镜头设计,已有当前有效结果会跳过。会调用文字模型并产生费用,不生成图片或视频。" :disabled="!flow.approved.value || flow.data.value.entry.ready || locked || busy || flow.reading.value" @confirm="generate('direction')" /><ConfirmAction label="补齐或更新画面状态" description="根据正式镜头和最新镜头设计处理整个项目的画面状态,已有当前有效结果会跳过。会调用文字模型并可能进行最多两次修复,可能产生费用。" :disabled="!flow.approved.value || flow.data.value.entry.ready || locked || busy || flow.reading.value || flow.data.value.entry.derivedAssets.directionCount !== flow.data.value.entry.derivedAssets.shotCount" @confirm="generate('visual')" /></div><p class="text-sm" :class="flow.data.value.entry.ready ? 'text-muted' : 'text-danger'">{{ flow.data.value.entry.ready ? '正式分镜已满足制作入口条件。制作计划还会继续检查主体素材和镜头资产。' : userFacingText(flow.data.value.entry.reason, '制作入口尚未满足条件。') }}</p></section>
</template>
<!-- 以下是服务持久化的派生任务,关闭抽屉后仍可观察 -->
<WorkflowExecutionPanel v-if="directionTask.executionId.value" title="镜头设计任务" :execution="directionTask.query.data.value ?? null" :loading="directionTask.query.loading.value" :error="directionTask.query.error.value ?? ''" @refresh="directionTask.query.refresh()" @dismiss="directionTask.dismiss()" />
<WorkflowExecutionPanel v-if="visualTask.executionId.value" title="画面状态任务" :execution="visualTask.query.data.value ?? null" :loading="visualTask.query.loading.value" :error="visualTask.query.error.value ?? ''" @refresh="visualTask.query.refresh()" @dismiss="visualTask.dismiss()" />
</div>
<template #footer><NButton :disabled="busy" @click="open = false">关闭</NButton><template v-if="repairIssue"><NButton :disabled="busy" @click="repairIssue = null"><template #icon><ArrowLeft :size="15" /></template>返回检查</NButton><NButton type="primary" :loading="repairWriting" :disabled="!repairEditor?.canSave || busy || locked" @click="repairEditor?.save()"><template #icon><Save :size="15" /></template>保存本次修订</NButton></template></template>
</AppDrawer>
</template>
<style scoped>
.preparation-checks { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px 40px; }
.preparation-checks > div { min-width: 0; }
@media (max-width: 760px) { .preparation-checks { grid-template-columns: minmax(0, 1fr); } }
@media (max-width: 639px) { .preparation-trigger-label { display: none; } }
</style>