feat(short-drama-agent-front): 补齐后端生产与质量功能

This commit is contained in:
GJ committed 2026-10-08 18:28:35 +08:00
1 parent 967c4ebea1
commit 470b52e26d
52 files changed
+3754 -1075

No files matched your search

+173 -115
View File
@@ -5,17 +5,7 @@ import { integerRule } from '../../lib/form-rules'
import WorkspacePage from '../../components/ui/WorkspacePage.vue'
import ActionMenu from '../../components/ui/ActionMenu.vue'
import WorkspaceTools from '../../components/ui/WorkspaceTools.vue'
import {
NScrollbar,
NAlert,
NButton,
NCheckbox,
NInputNumber,
NProgress,
NSelect,
NTab,
NTabs
} from 'naive-ui'
import { NScrollbar, NAlert, NButton, NCheckbox, NInputNumber, NProgress, NSelect, NTab, NTabs } from 'naive-ui'
import { computed, ref, watch } from 'vue'
import { ArrowLeft, RefreshCw } from '@lucide/vue'
import { EmptyState } from '../../components/ui'
@@ -25,6 +15,9 @@ import GenerationReceipt from './components/GenerationReceipt.vue'
import ShotDesign from './components/ShotDesign.vue'
import ShotTools from './components/ShotTools.vue'
import BeatShotDirectory from './components/BeatShotDirectory.vue'
import SubjectCoverageAudit from './components/SubjectCoverageAudit.vue'
import type { SubjectCoverageIssue } from './coverage.types'
import WorkflowExecutionPanel from '../workflows/WorkflowExecutionPanel.vue'
import { useStoryboard } from './useStoryboard'
import { useProjectContext } from '../projects/context'
@@ -43,6 +36,7 @@ const {
shot,
query,
data,
episodeSourceUnavailable,
prerequisites,
session,
operation,
@@ -54,6 +48,7 @@ const {
directionComplete,
visualStateComplete,
hasCurrentEpisodeShots,
executions,
run
} = useStoryboard()
const productionReady = computed(() => directionComplete.value && visualStateComplete.value)
@@ -90,6 +85,51 @@ function exportEpisode() {
}
/** 回执到达后打开诊断区;平时留出镜头检查空间。 */
const toolsOpen = ref(false)
/** 覆盖审计只保存剧集与镜头坐标,正式 ID 从当前查询结果中定位。 */
const auditLocation = ref<SubjectCoverageIssue | null>(null)
/** 覆盖定位失败时保留明确反馈,不猜测其它镜头。 */
const auditLocationError = ref('')
/**
* 切换到引用遗漏发生的剧集,等待正式镜头数据后定位。
* @param issue 后端实际覆盖问题
*/
function locateCoverageIssue(issue: SubjectCoverageIssue) {
if (!episodeOptions.value.some(episode => episode.episodeNo === issue.episodeNo)) {
auditLocationError.value = '审计中的剧集不在当前项目,请刷新分镜与审计结果。'
return
}
auditLocation.value = issue
auditLocationError.value = ''
selectedEpisode.value = issue.episodeNo
}
/** 当前集查询完成后按唯一坐标匹配正式镜头;目标缺失时不切到其他镜头。 */
watch(
[episodeNo, shots, () => query.loading.value, auditLocation],
() => {
const issue = auditLocation.value
if (
!issue ||
query.loading.value ||
episodeNo.value !== issue.episodeNo ||
data.value?.directions.episodeNo !== issue.episodeNo
)
return
if (issue.shotNo !== null) {
const target = shots.value.find(item => item.beatNo === issue.beatNo && item.shotNo === issue.shotNo)
if (!target) {
auditLocationError.value = '目标镜头已变化,请刷新后重新检查主体引用。'
auditLocation.value = null
return
}
selectedShot.value = target.shotId
}
toolsOpen.value = false
auditLocation.value = null
},
{ flush: 'post' }
)
watch(
() => session.value.receipt,
receipt => {
@@ -105,6 +145,9 @@ const rules = { concurrency: integerRule('批量并发'), maxRepairAttempts: int
<template>
<WorkspacePage split compact class="storyboard-workspace-page">
<template #notice>
<NAlert v-if="episodeSourceUnavailable" type="info" :show-icon="false">
本集镜头已重新生成。新标题和剧情详情尚未提供,当前只显示正式镜头编号;请按实际生成规格核对内容。
</NAlert>
<NAlert v-if="stageComplete" type="success" :show-icon="false">
分镜设计已经准备完成,可以继续生成首帧、视频提示词和视频。
<RouterLink :to="`/projects/${id}/production`" class="text-button ml-2">继续镜头生产 →</RouterLink>
@@ -226,109 +269,124 @@ const rules = { concurrency: integerRule('批量并发'), maxRepairAttempts: int
</div>
<div class="workspace-overview-panel">
<div class="overview-content workspace-section-stack">
<!-- 以下是零费用主体引用覆盖检查模块 -->
<SubjectCoverageAudit :project-id="id" @locate="locateCoverageIssue" />
<NAlert v-if="auditLocationError" type="warning" :show-icon="false">{{
auditLocationError
}}</NAlert>
<h3 class="mb-3 text-sm font-semibold">生成与恢复</h3>
<div class="generation-row">
<div>
<h3 class="text-sm font-semibold">
<span class="mr-2 font-mono text-xs text-muted">00</span
>本集镜头拆解
</h3>
<p class="mt-2 text-xs leading-6 text-muted">
只重新拆解当前选择的第
{{ episodeNo }}
集,其它剧集不受影响。新镜头会替换旧镜头,并清空本集已有的导演设计、即时状态、首帧与视频结果。
</p>
</div>
<div class="flex flex-wrap gap-2">
<ConfirmAction
:label="`重生成第 ${episodeNo} 集镜头`"
:disabled="!allowed['shots-current']"
acknowledgement
:description="`将删除并重建第 ${episodeNo} 集的正式镜头。该集已有导演设计、即时状态、首帧、提示词和视频结果会随旧镜头一并失效,且无法撤销;其它剧集保持不变。`"
@confirm="run('shots-current')"
/>
</div>
</div>
<p v-if="!hasCurrentEpisodeShots" class="mt-3 text-[11px] text-muted">
当前集还没有可用镜头,请先完成剧本拆解。
<div class="generation-row">
<div>
<h3 class="text-sm font-semibold">
<span class="mr-2 font-mono text-xs text-muted">00</span>本集镜头拆解
</h3>
<p class="mt-2 text-xs leading-6 text-muted">
只重新拆解当前选择的第
{{ episodeNo }}
集,其它剧集不受影响。新镜头会替换旧镜头,并清空本集已有的导演设计、即时状态、首帧与视频结果。
</p>
<div class="generation-row">
<div>
<h3 class="text-sm font-semibold">
<span class="mr-2 font-mono text-xs text-muted">01</span
>导演摄影设计
</h3>
<p class="mt-2 text-xs leading-6 text-muted">
景别、机位、运镜与构图。正式项目生成默认跳过已完整剧集,覆盖模式会重新生成全部剧集。
</p>
</div>
<div class="flex flex-wrap gap-2">
<ConfirmAction
:label="force ? '重生成全部导演设计' : '补齐项目导演设计'"
:disabled="!allowed['direction-all']"
acknowledgement
:description="
force
? '重新生成项目全部剧集的导演设计,覆盖已有结果。'
: '对整个项目生成导演设计,跳过已完整保存的剧集,可用于重试失败或未完成的剧集。'
"
@confirm="run('direction-all')"
/>
</div>
</div>
<div class="generation-row">
<div>
<h3 class="text-sm font-semibold">
<span class="mr-2 font-mono text-xs text-muted">02</span
>即时视觉状态
</h3>
<p class="mt-2 text-xs leading-6 text-muted">
表情、姿态、位置、环境与连续性。每集需要完整导演设计;批量中缺少前置设计的剧集会单独报错。
</p>
</div>
<div class="flex flex-wrap gap-2">
<ConfirmAction
:label="force ? '重生成全部即时状态' : '补齐项目即时状态'"
:disabled="!allowed['visual-all']"
acknowledgement
:description="
force
? '重新生成整个项目的即时状态,覆盖已有结果。每集必须先有完整导演设计。'
: '补齐项目即时状态,跳过完整剧集;未完成导演设计的剧集会返回失败原因。'
"
@confirm="run('visual-all')"
/>
</div>
</div>
<p class="mt-4 text-[11px] leading-6 text-muted">
修改或覆盖前面的设计后,已有状态和视频提示词不会自动更新;请按顺序重新生成后续内容。自动修复次数仅用于
VisualState。
</p>
<section>
<h3 class="text-sm font-semibold">视频提示词批量操作</h3>
<p class="my-3 text-xs leading-6 text-muted">
生成前会检查镜头设计和主体参考图是否齐全。这里只生成提示词;首帧、视频任务、状态检查与失败重试已整理到
<RouterLink
:to="`/projects/${id}/production`"
class="text-button mx-1"
>镜头生产</RouterLink
>。
</p>
<ConfirmAction
:label="force ? '重生成全部视频提示词' : '补齐项目视频提示词'"
:disabled="!allowed.prompts"
acknowledgement
:description="
force
? '调用模型重新生成全项目镜头的视频提示词,覆盖已有正文。'
: '调用模型生成缺少视频提示词的镜头,已有提示词直接跳过。参考图缺失会返回失败。'
"
@confirm="run('prompts')" />
</section>
<GenerationReceipt
v-if="session.receipt"
:receipt="session.receipt"
</div>
<div class="flex flex-wrap gap-2">
<ConfirmAction
:label="`重生成第 ${episodeNo} 集镜头`"
:disabled="!allowed['shots-current']"
acknowledgement
:description="`将删除并重建第 ${episodeNo} 集的正式镜头。该集已有导演设计、即时状态、首帧、提示词和视频结果会随旧镜头一并失效,且无法撤销;其它剧集保持不变。`"
@confirm="run('shots-current')"
/>
</div>
</div>
<p v-if="!hasCurrentEpisodeShots" class="mt-3 text-[11px] text-muted">
当前集还没有可用镜头,请先完成剧本拆解。
</p>
<div class="generation-row">
<div>
<h3 class="text-sm font-semibold">
<span class="mr-2 font-mono text-xs text-muted">01</span>导演摄影设计
</h3>
<p class="mt-2 text-xs leading-6 text-muted">
景别、机位、运镜与构图。正式项目生成默认跳过已完整剧集,覆盖模式会重新生成全部剧集。
</p>
</div>
<div class="flex flex-wrap gap-2">
<ConfirmAction
:label="force ? '重生成全部导演设计' : '补齐项目导演设计'"
:disabled="!allowed['direction-all']"
acknowledgement
:description="
force
? '重新生成项目全部剧集的导演设计,覆盖已有结果。'
: '对整个项目生成导演设计,跳过已完整保存的剧集,可用于重试失败或未完成的剧集。'
"
@confirm="run('direction-all')"
/>
</div>
</div>
<div class="generation-row">
<div>
<h3 class="text-sm font-semibold">
<span class="mr-2 font-mono text-xs text-muted">02</span>即时视觉状态
</h3>
<p class="mt-2 text-xs leading-6 text-muted">
表情、姿态、位置、环境与连续性。每集需要完整导演设计;批量中缺少前置设计的剧集会单独报错。
</p>
</div>
<div class="flex flex-wrap gap-2">
<ConfirmAction
:label="force ? '重生成全部即时状态' : '补齐项目即时状态'"
:disabled="!allowed['visual-all']"
acknowledgement
:description="
force
? '重新生成整个项目的即时状态,覆盖已有结果。每集必须先有完整导演设计。'
: '补齐项目即时状态,跳过完整剧集;未完成导演设计的剧集会返回失败原因。'
"
@confirm="run('visual-all')"
/>
</div>
</div>
<p class="mt-4 text-[11px] leading-6 text-muted">
修改或覆盖前面的设计后,已有状态和视频提示词不会自动更新;请按顺序重新生成后续内容。自动修复次数仅用于
VisualState。
</p>
<section>
<h3 class="text-sm font-semibold">视频提示词批量操作</h3>
<p class="my-3 text-xs leading-6 text-muted">
生成前会检查镜头设计和主体参考图是否齐全。这里只生成提示词;首帧、视频任务、状态检查与失败重试已整理到
<RouterLink :to="`/projects/${id}/production`" class="text-button mx-1"
>镜头生产</RouterLink
>。
</p>
<ConfirmAction
:label="force ? '重生成全部视频提示词' : '补齐项目视频提示词'"
:disabled="!allowed.prompts"
acknowledgement
:description="
force
? '调用模型重新生成全项目镜头的视频提示词,覆盖已有正文。'
: '调用模型生成缺少视频提示词的镜头,已有提示词直接跳过。参考图缺失会返回失败。'
"
@confirm="run('prompts')"
/>
</section>
<!-- 以下是正式分镜后台执行状态模块 -->
<WorkflowExecutionPanel
v-for="entry in executions.filter(
item =>
item.observer.executionId.value &&
(item.title !== '单集镜头重生成' ||
item.observer.query.data.value?.metadata?.action ===
'regenerate-storyboard-episode')
)"
:key="entry.title"
:title="entry.title"
:execution="entry.observer.query.data.value"
:loading="entry.observer.query.loading.value"
:error="entry.observer.query.error.value"
@refresh="entry.observer.query.refresh"
@dismiss="entry.observer.dismiss"
/>
<GenerationReceipt v-if="session.receipt" :receipt="session.receipt" />
</div>
</div>
</WorkspaceTools>
@@ -360,9 +418,9 @@ const rules = { concurrency: integerRule('批量并发'), maxRepairAttempts: int
>
<strong>Production 前置设计未完成。</strong>
当前导演设计 {{ data.directions.directionCount }}/{{ data.directions.shotCount }},即时视觉状态
{{ data.visualStates.visualStateCount }}/{{ data.visualStates.shotCount }}。请先补齐后再进入镜头生产,避免
后续镜头制作无法开始。
</NAlert
{{ data.visualStates.visualStateCount }}/{{
data.visualStates.shotCount
}}。请先补齐后再进入镜头生产,避免 后续镜头制作无法开始。 </NAlert
><NAlert
v-if="!prerequisites.directionEpisode || !prerequisites.visualEpisode"
type="info"
@@ -424,7 +482,7 @@ const rules = { concurrency: integerRule('批量并发'), maxRepairAttempts: int
视觉重点:{{ shot.visualFocus }}
</p>
<p class="mt-3 break-all font-mono text-[10px] text-muted">Shot ID · {{ shot.shotId }}</p>
<p class="mt-1 text-[10px] text-muted">
<p v-if="!episodeSourceUnavailable" class="mt-1 text-[10px] text-muted">
标题与剧情描述取自最近可用 Breakdown 快照;以下设计与状态取自数据库。
</p>
</header>
+29 -8
View File
@@ -1,13 +1,11 @@
import type { WorkflowExecutionStart } from '../workflows/execution.types'
import { request } from '../../lib/http'
import type {
EpisodeDirections,
EpisodeVisualStates,
PromptBatchResult,
ShotPromptResult,
ShotReferences,
StoryboardBatchInput,
StoryboardBatchResult,
StoryboardShotRegenerationResult,
VisualStateBatchInput
} from './types'
import type { ShotGenerationSpec } from './generation-spec.types'
@@ -24,9 +22,14 @@ function shotPath(id: string) {
/** Storyboard 正式路由契约;测试路由不暴露为前端生产入口。 */
export const storyboardApi = {
/** 强制重生成指定单集的镜头拆解;后端校验通过后才覆盖正式 Storyboard。 */
/**
* 后台重生成指定单集镜头,终态后再读取正式分镜。
* @param id 正式项目 ID
* @param episodeNo 目标剧集编号
* @returns 真实后台任务观察句柄
*/
regenerateEpisodeShots: (id: string, episodeNo: number) =>
request<StoryboardShotRegenerationResult>(`${projectPath(id)}/storyboard-shots/regenerate`, {
request<WorkflowExecutionStart>(`${projectPath(id)}/storyboard-shots/regenerate`, {
method: 'POST',
body: { episodeNo },
timeoutMs: 0
@@ -35,14 +38,26 @@ export const storyboardApi = {
request<EpisodeDirections>(`${projectPath(id)}/storyboard-directions?episodeNo=${episodeNo}`, { signal }),
visualStates: (id: string, episodeNo: number, signal?: AbortSignal) =>
request<EpisodeVisualStates>(`${projectPath(id)}/storyboard-visual-states?episodeNo=${episodeNo}`, { signal }),
/**
* 后台生成项目导演设计。
* @param id 正式项目 ID
* @param input 并发与覆盖范围
* @returns 真实后台任务观察句柄
*/
generateDirections: (id: string, input: StoryboardBatchInput) =>
request<StoryboardBatchResult>(`${projectPath(id)}/storyboard-directions/generate`, {
request<WorkflowExecutionStart>(`${projectPath(id)}/storyboard-directions/generate`, {
method: 'POST',
body: input,
timeoutMs: 0
}),
/**
* 后台生成项目即时状态。
* @param id 正式项目 ID
* @param input 并发、覆盖与有限修复配置
* @returns 真实后台任务观察句柄
*/
generateVisualStates: (id: string, input: VisualStateBatchInput) =>
request<StoryboardBatchResult>(`${projectPath(id)}/storyboard-visual-states/generate`, {
request<WorkflowExecutionStart>(`${projectPath(id)}/storyboard-visual-states/generate`, {
method: 'POST',
body: input,
timeoutMs: 0
@@ -59,8 +74,14 @@ export const storyboardApi = {
body: { force },
timeoutMs: 0
}),
/**
* 后台批量生成项目视频提示词。
* @param id 正式项目 ID
* @param input 并发与覆盖参数
* @returns 真实后台任务观察句柄
*/
generatePrompts: (id: string, input: StoryboardBatchInput) =>
request<PromptBatchResult>(`${projectPath(id)}/video-prompts/generate`, {
request<WorkflowExecutionStart>(`${projectPath(id)}/video-prompts/generate`, {
method: 'POST',
body: input,
timeoutMs: 0
@@ -0,0 +1,77 @@
<script setup lang="ts">
import { computed, ref } from 'vue'
import { NAlert, NButton } from 'naive-ui'
import ReadonlyInspection from '../../../components/ui/ReadonlyInspection.vue'
import { useQuery } from '../../../composables/useQuery'
import { auditSubjectCoverage } from '../coverage-api'
import type { SubjectCoverageIssue } from '../coverage.types'
/** 审计范围始终是当前正式项目。 */
const props = defineProps<{ /** 项目 ID。 */ projectId: string }>()
/** 定位只交给当前分镜页处理,不自行拼接猜测的镜头 ID。 */
const emit = defineEmits<{ locate: [issue: SubjectCoverageIssue] }>()
/** 展开才会读取零费用审计结果。 */
const open = ref(false)
/** 项目或展开状态变化时清空旧审计。 */
const key = computed(() => (open.value ? props.projectId : ''))
/** 请求取消和迟到响应保护复用公共查询。 */
const query = useQuery(key, async (projectId, signal) => {
if (!projectId) return null
const result = await auditSubjectCoverage(projectId, signal)
if (result.projectId !== projectId || !Array.isArray(result.issues) || typeof result.valid !== 'boolean')
throw new Error('覆盖检查返回了不匹配的项目或无效结果,请刷新。')
return result
})
/** 当前后端实际审计汇总。 */
const result = computed(() => query.data.value)
</script>
<template>
<!-- 以下是零费用主体引用覆盖审计模块 -->
<ReadonlyInspection
v-model:open="open"
title="主体引用覆盖检查"
description="检查分镜文本与主体绑定是否一致,只读取数据,不自动生成或修改分镜。"
:loading="query.loading.value"
:error="query.error.value"
@refresh="query.refresh"
>
<template v-if="result">
<NAlert :type="result.valid ? 'success' : 'warning'" :show-icon="false">
{{ result.valid ? '未发现主体引用遗漏' : `发现 ${result.issueCount} 项引用遗漏` }} ·
{{ result.episodeCount }} 集 / {{ result.beatCount }} 个 Beat / {{ result.shotCount }} 镜
</NAlert>
<p class="mt-2 text-muted">
检查主体 {{ result.subjectSummary.total }} · 人物 {{ result.subjectSummary.character }} / 场景
{{ result.subjectSummary.scene }} / 道具 {{ result.subjectSummary.prop }}
</p>
<article
v-for="(issue, index) in result.issues"
:key="`${issue.level}:${issue.episodeNo}:${issue.beatNo}:${issue.shotNo}:${issue.subjectRef}:${index}`"
class="surface-inset mt-3 p-3"
>
<div class="flex flex-wrap items-center justify-between gap-3">
<strong
>第 {{ issue.episodeNo }} 集 · Beat {{ issue.beatNo
}}{{ issue.shotNo !== null ? ` · 镜头 ${issue.shotNo}` : '' }} · {{ issue.subjectName }}
{{ issue.subjectRef }}</strong
>
<NButton text size="small" @click="emit('locate', issue)">{{
issue.shotNo === null ? '查看所在剧集' : '定位镜头'
}}</NButton>
</div>
<p>{{ issue.message }}</p>
<p class="text-muted">
原文匹配:{{ issue.matchedTerm }} ·
{{
issue.level === 'visual_state'
? '即时状态'
: issue.level === 'beat'
? 'Beat 主体引用'
: '镜头主体绑定'
}}
</p>
</article>
</template>
</ReadonlyInspection>
</template>
+14
View File
@@ -0,0 +1,14 @@
import { request } from '../../lib/http'
import type { SubjectCoverageAudit } from './coverage.types'
/**
* 只读检查正式分镜的主体引用覆盖,不调用任何 Agent。
* @param projectId 当前正式项目 ID
* @param signal 取消信号
* @returns 后端实际覆盖审计结果
*/
export function auditSubjectCoverage(projectId: string, signal?: AbortSignal) {
return request<SubjectCoverageAudit>(`/projects/${encodeURIComponent(projectId)}/storyboard/subject-coverage`, {
signal
})
}
+61
View File
@@ -0,0 +1,61 @@
/** 主体引用覆盖检查中的单个遗漏,不推测正式 Shot ID。 */
export interface SubjectCoverageIssue {
/** 遗漏发生的层级。 */
level: 'beat' | 'shot' | 'visual_state'
/** 正式剧集编号。 */
episodeNo: number
/** Beat 编号。 */
beatNo: number
/** 镜头编号,Beat 层级为空。 */
shotNo: number | null
/** 漏引用的主体 Ref。 */
subjectRef: string
/** 主体名称。 */
subjectName: string
/** 主体模块。 */
module: string
/** 原文中匹配的用语。 */
matchedTerm: string
/** 后端问题描述。 */
message: string
}
/** 零费用主体引用覆盖审计的实际汇总。 */
export interface SubjectCoverageAudit {
/** 当前项目正式 ID。 */
projectId: string
/** 后端是否判定引用覆盖完整。 */
valid: boolean
/** 审计的剧集数量。 */
episodeCount: number
/** 审计的 Beat 数量。 */
beatCount: number
/** 审计的镜头数量。 */
shotCount: number
/** 遗漏问题数量。 */
issueCount: number
/** 后端用于本次审计的主体快照。 */
subjectSnapshot: {
/** 正式主体 ID。 */
id: string
/** 主体引用。 */
ref: string
/** 主体名称。 */
name: string
/** 主体模块。 */
module: string
}[]
/** 本次审计的各类型主体数量。 */
subjectSummary: {
/** 主体总数。 */
total: number
/** 人物数量。 */
character: number
/** 场景数量。 */
scene: number
/** 道具数量。 */
prop: number
}
/** 真实引用遗漏列表。 */
issues: SubjectCoverageIssue[]
}
+81 -1
View File
@@ -7,9 +7,89 @@ import type { DesignedShot, EpisodeDirections, EpisodeVisualStates, StoryboardSe
/** 仅保存本会话回执和已返回的 Prompt,切换路由不丢失长请求结果。 */
const sessions = reactive<Record<string, StoryboardSession>>({})
/**
* 恢复整个项目已失效的剧集集合,兼容隐私模式或损坏的浏览器缓存。
* @param projectId 正式项目 ID
* @returns 只包含正整数剧集编号的失效标记
*/
function savedEpisodeInvalidations(projectId: string): Record<number, boolean> {
try {
if (typeof localStorage === 'undefined') return {}
const value: unknown = JSON.parse(
localStorage.getItem(`short-drama:storyboard-invalidated:${projectId}`) ?? '[]'
)
if (!Array.isArray(value)) return {}
return Object.fromEntries(
value
.filter(number => typeof number === 'number' && Number.isSafeInteger(number) && number > 0)
.map(number => [number, true])
)
} catch {
return {}
}
}
/** 获取指定项目的独立回执容器。 */
export function getStoryboardSession(id: string): StoryboardSession {
return (sessions[id] ??= { receipt: null, prompts: {}, regeneratedEpisodes: {} })
return (sessions[id] ??= {
receipt: null,
prompts: {},
regeneratedEpisodes: {},
invalidatedEpisodeSources: savedEpisodeInvalidations(id)
})
}
/**
* 根据真实有效终态废弃旧正文,并持久化全部剧集,隐藏任务不影响恢复。
* @param projectId 正式项目 ID
* @param episodeNo 已有效重生成的剧集编号
*/
export function invalidateEpisodeSource(projectId: string, episodeNo: number) {
if (!Number.isSafeInteger(episodeNo) || episodeNo <= 0) return
const session = getStoryboardSession(projectId)
delete session.regeneratedEpisodes[episodeNo]
session.invalidatedEpisodeSources = {
...savedEpisodeInvalidations(projectId),
...session.invalidatedEpisodeSources,
[episodeNo]: true
}
try {
if (typeof localStorage !== 'undefined')
localStorage.setItem(
`short-drama:storyboard-invalidated:${projectId}`,
JSON.stringify(Object.keys(session.invalidatedEpisodeSources).map(Number))
)
} catch {
/* 浏览器禁止存储时仍保留当前会话保护。 */
}
}
/**
* 仅可信完整重新拆解完成后清除旧失效集合。
* @param projectId 正式项目 ID
*/
export function clearEpisodeSourceInvalidations(projectId: string) {
getStoryboardSession(projectId).invalidatedEpisodeSources = {}
try {
if (typeof localStorage !== 'undefined')
localStorage.removeItem(`short-drama:storyboard-invalidated:${projectId}`)
} catch {
/* 当前会话已经清除,存储限制不会触发业务请求。 */
}
}
/**
* 重生成后不向新 Shot ID 回填旧 checkpoint 的标题、剧情或时长。
* @param projectId 当前正式项目 ID
* @param episodeNo 当前剧集编号
* @param fallback 未失效的原始分集快照
* @returns 实际正文或缺省;缺省时仅展示正式镜头编号
*/
export function currentEpisodeSource(projectId: string, episodeNo: number, fallback?: EpisodeShots) {
const session = getStoryboardSession(projectId)
return (
session.regeneratedEpisodes[episodeNo] ?? (session.invalidatedEpisodeSources[episodeNo] ? undefined : fallback)
)
}
/** 后端生成服务只读取最新 Breakdown;不能用历史可恢复快照冒充当前生成前置条件。 */
+13 -1
View File
@@ -181,13 +181,25 @@ export interface DesignedShot {
/** 生成回执按操作区分,切换剧集时仍保留原始目标信息。 */
export type StoryboardReceipt =
| { kind: 'shots'; title: string; result: StoryboardShotRegenerationResult }
| {
kind: 'shots'
title: string
result: Pick<
StoryboardShotRegenerationResult,
'episodeNo' | 'storyboardShotSummary' | 'storyboardShotValidation'
>
}
| { kind: 'batch'; title: string; result: StoryboardBatchResult }
| { kind: 'prompts'; title: string; result: PromptBatchResult }
/** 当前浏览器会话保存回执,不将其当作持久化运行状态。 */
export interface StoryboardSession {
/** 当前真实操作回执。 */
receipt: StoryboardReceipt | null
/** 按正式镜头缓存的实际视频提示词。 */
prompts: Record<string, ShotPromptResult>
/** 已实际返回的重生成分集正文,缺少正文时不构造缓存。 */
regeneratedEpisodes: Record<number, EpisodeShots>
/** 已重生成且旧 checkpoint 正文不再可信的剧集。 */
invalidatedEpisodeSources: Record<number, boolean>
}
+105 -47
View File
@@ -1,10 +1,18 @@
import { computed, ref } from 'vue'
import { useWorkflowExecution } from '../workflows/execution'
import type { StoryboardBatchResult, PromptBatchResult, StoryboardShotRegenerationResult } from './types'
import { computed, ref, watch } from 'vue'
import { useQuery } from '../../composables/useQuery'
import { useProjectContext } from '../projects/context'
import { breakdownSnapshot } from '../workflows/selectors'
import { getOperation, runOperation } from '../workflows/operations'
import { storyboardApi } from './api'
import { getStoryboardSession, mergeDesignedShots, storyboardPrerequisites } from './model'
import {
currentEpisodeSource,
getStoryboardSession,
invalidateEpisodeSource,
mergeDesignedShots,
storyboardPrerequisites
} from './model'
/** 分镜页只提供正式主流程命令,不暴露后端测试路由。 */
export type StoryboardCommand = 'shots-current' | 'direction-all' | 'visual-all' | 'prompts'
@@ -12,16 +20,25 @@ export type StoryboardCommand = 'shots-current' | 'direction-all' | 'visual-all'
/** 分镜查询、依赖判断与操作入口;不修改后端 graph。 */
export function useStoryboard() {
const context = useProjectContext()
/** 当前工作区的响应式状态或派生业务条件。 */
const id = computed(() => context.project.value?.id ?? '')
/** 当前工作区的响应式状态或派生业务条件。 */
const selectedEpisode = ref<number>()
/** 当前工作区的响应式状态或派生业务条件。 */
const selectedShot = ref('')
/** 当前工作区的响应式状态或派生业务条件。 */
const concurrency = ref(2)
/** 当前工作区的响应式状态或派生业务条件。 */
const maxRepairAttempts = ref(2)
/** 当前工作区的响应式状态或派生业务条件。 */
const force = ref(false)
/** 当前工作区的响应式状态或派生业务条件。 */
const snapshot = computed(() => breakdownSnapshot(context.checkpoints.value))
/** 当前工作区的响应式状态或派生业务条件。 */
const sourceEpisodes = computed(
() => snapshot.value?.storyboardEpisodeShots ?? snapshot.value?.breakdownResult?.storyboardEpisodeShots ?? []
)
/** 当前工作区的响应式状态或派生业务条件。 */
const episodeOptions = computed(() => {
const entries = new Map(context.project.value?.episodes.map(episode => [episode.episode, episode.title]) ?? [])
for (const episode of sourceEpisodes.value) {
@@ -31,12 +48,14 @@ export function useStoryboard() {
.map(([episodeNo, title]) => ({ episodeNo, title }))
.toSorted((a, b) => a.episodeNo - b.episodeNo)
})
/** 当前工作区的响应式状态或派生业务条件。 */
const episodeNo = computed(
() =>
episodeOptions.value.find(item => item.episodeNo === selectedEpisode.value)?.episodeNo ??
episodeOptions.value[0]?.episodeNo ??
0
)
/** 当前工作区的响应式状态或派生业务条件。 */
const queryKey = computed(() => JSON.stringify([id.value, episodeNo.value]))
/** 分镜页仅在进入、切换剧集或显式刷新时读取。 */
const query = useQuery(queryKey, async (key, signal) => {
@@ -57,21 +76,33 @@ export function useStoryboard() {
return { directions, visualStates }
})
const data = query.data
/** 当前工作区的响应式状态或派生业务条件。 */
const session = computed(() => getStoryboardSession(id.value))
/** 单集重生成返回的是最新镜头正文,优先于不会随局部覆盖更新的历史 Breakdown 快照。 */
const source = computed(
() =>
session.value.regeneratedEpisodes[episodeNo.value] ??
const source = computed(() =>
currentEpisodeSource(
id.value,
episodeNo.value,
sourceEpisodes.value.find(item => item.episodeNo === episodeNo.value)
)
)
/** 重生成接口未返回新正文时,明确标记辅助剧情信息不可用。 */
const episodeSourceUnavailable = computed(() => !!session.value.invalidatedEpisodeSources[episodeNo.value])
/** 当前工作区的响应式状态或派生业务条件。 */
const shots = computed(() =>
mergeDesignedShots(data.value?.directions ?? null, data.value?.visualStates ?? null, source.value)
)
/** 当前工作区的响应式状态或派生业务条件。 */
const shot = computed(() => shots.value.find(item => item.shotId === selectedShot.value) ?? shots.value[0])
/** 当前工作区的响应式状态或派生业务条件。 */
const prerequisites = computed(() => storyboardPrerequisites(context.checkpoints.value, episodeNo.value))
/** 当前工作区的响应式状态或派生业务条件。 */
const operation = computed(() => getOperation(id.value))
/** 当前工作区的响应式状态或派生业务条件。 */
const batchValid = computed(() => Number.isSafeInteger(concurrency.value) && concurrency.value > 0)
/** 当前工作区的响应式状态或派生业务条件。 */
const repairsValid = computed(() => Number.isSafeInteger(maxRepairAttempts.value) && maxRepairAttempts.value >= 0)
/** 当前工作区的响应式状态或派生业务条件。 */
const blocked = computed(
() =>
operation.value.pending ||
@@ -81,18 +112,21 @@ export function useStoryboard() {
context.project.value?.status !== 'completed' ||
prerequisites.value.breakdownRunning
)
/** 当前工作区的响应式状态或派生业务条件。 */
const directionComplete = computed(
() =>
!!data.value?.directions.shotCount &&
data.value.directions.directionCount === data.value.directions.shotCount &&
data.value.directions.coverage === 1
)
/** 当前工作区的响应式状态或派生业务条件。 */
const visualStateComplete = computed(
() =>
!!data.value?.visualStates.shotCount &&
data.value.visualStates.visualStateCount === data.value.visualStates.shotCount &&
data.value.visualStates.coverage === 1
)
/** 当前工作区的响应式状态或派生业务条件。 */
const hasCurrentEpisodeShots = computed(
() => Math.max(data.value?.directions.shotCount ?? 0, data.value?.visualStates.shotCount ?? 0) > 0
)
@@ -103,6 +137,54 @@ export function useStoryboard() {
prompts: !blocked.value && shots.value.length > 0 && batchValid.value
}))
/** 正式后台任务观察器;重生成使用后端 breakdown 名称并通过 metadata 区分。 */
const executions = [
{ title: '单集镜头重生成', observer: useWorkflowExecution(id, 'breakdown') },
{ title: '项目导演设计', observer: useWorkflowExecution(id, 'storyboard-direction') },
{ title: '项目即时状态', observer: useWorkflowExecution(id, 'storyboard-visual-state') },
{ title: '项目视频提示词', observer: useWorkflowExecution(id, 'video-prompt') }
]
/** 真实终态结果才发布回执;刷新恢复也按后端 metadata 归属。 */
for (const [index, entry] of executions.entries()) {
watch(
() => entry.observer.query.data.value,
record => {
if (!record || record.projectId !== id.value || !['completed', 'failed'].includes(record.status)) return
const target = getStoryboardSession(record.projectId)
if (index === 0 && record.metadata?.action !== 'regenerate-storyboard-episode') return
if (record.status === 'completed' && record.result) {
if (index === 0) {
const result = record.result as unknown as StoryboardShotRegenerationResult
const number = record.metadata?.episodeNo
if (
typeof number !== 'number' ||
result.episodeNo !== number ||
!result.storyboardShotValidation ||
!result.storyboardShotSummary
)
return
target.receipt = { kind: 'shots', title: `第 ${number} 集镜头`, result }
if (result.storyboardShotValidation.valid) {
delete target.regeneratedEpisodes[number]
invalidateEpisodeSource(record.projectId, number)
target.prompts = {}
if (episodeNo.value === number) selectedShot.value = ''
}
} else if (index === 3) {
const result = record.result as unknown as PromptBatchResult
if (typeof result.failed !== 'number') return
target.receipt = { kind: 'prompts', title: entry.title, result }
} else {
const result = record.result as unknown as StoryboardBatchResult
if (result.projectId !== record.projectId || !Array.isArray(result.episodes)) return
target.receipt = { kind: 'batch', title: entry.title, result }
}
}
void Promise.all([query.refresh(), context.refresh(), context.refreshStageReadiness()])
}
)
}
/** 捕获提交时的目标与配置,切换剧集不改变正在运行的请求或回执。 */
async function run(command: StoryboardCommand) {
if (!allowed.value[command]) return
@@ -119,48 +201,22 @@ export function useStoryboard() {
}
target.receipt = null
await runOperation(projectId, `生成${titles[command]}`, async () => {
switch (command) {
case 'shots-current': {
const result = await storyboardApi.regenerateEpisodeShots(projectId, targetEpisode)
if (result.projectId !== projectId || result.episodeNo !== targetEpisode) {
throw new Error('镜头重生成返回了不匹配的项目或剧集,请刷新后重试。')
}
target.receipt = { kind: 'shots', title: titles[command], result }
if (!result.storyboardShotValidation.valid) {
throw new Error('本集镜头校验未通过,后端未覆盖正式 Storyboard。')
}
target.regeneratedEpisodes[targetEpisode] = result.episodeShot
// 新镜头会获得新的数据库 ID,废弃所有按旧 Shot ID 缓存的提示词。
target.prompts = {}
if (episodeNo.value === targetEpisode) selectedShot.value = ''
break
}
case 'direction-all':
target.receipt = {
kind: 'batch',
title: titles[command],
result: await storyboardApi.generateDirections(projectId, batch)
}
break
case 'visual-all':
target.receipt = {
kind: 'batch',
title: titles[command],
result: await storyboardApi.generateVisualStates(projectId, {
...batch,
maxRepairAttempts: repairs
})
}
break
case 'prompts':
// 断网时也可能已部分覆盖,先清空缓存,避免继续展示可能失效的正文。
target.prompts = {}
target.receipt = {
kind: 'prompts',
title: titles[command],
result: await storyboardApi.generatePrompts(projectId, batch)
}
break
if (command === 'shots-current') {
const started = await storyboardApi.regenerateEpisodeShots(projectId, targetEpisode)
await executions[0]!.observer.track(started.executionId, projectId)
} else if (command === 'direction-all') {
const started = await storyboardApi.generateDirections(projectId, batch)
await executions[1]!.observer.track(started.executionId, projectId)
} else if (command === 'visual-all') {
const started = await storyboardApi.generateVisualStates(projectId, {
...batch,
maxRepairAttempts: repairs
})
await executions[2]!.observer.track(started.executionId, projectId)
} else {
target.prompts = {}
const started = await storyboardApi.generatePrompts(projectId, batch)
await executions[3]!.observer.track(started.executionId, projectId)
}
})
await Promise.all([query.refresh(), context.refreshStageReadiness()])
@@ -177,6 +233,7 @@ export function useStoryboard() {
query,
data,
source,
episodeSourceUnavailable,
prerequisites,
session,
operation,
@@ -190,6 +247,7 @@ export function useStoryboard() {
directionComplete,
visualStateComplete,
hasCurrentEpisodeShots,
executions,
run
}
}