feat(short-drama-agent-front): 接入素材预览审核并完善创作流程

This commit is contained in:
GJ committed 2026-11-02 10:16:10 +08:00
1 parent f8b0fbb8ca
commit dc8bb17a23
66 files changed
+2864 -632

No files matched your search

+2 -2
View File
@@ -1179,8 +1179,8 @@ const isInitialEmpty = computed(
@confirm="run('retry')"
/><ConfirmAction
:loading="isOperationRunning(operation, '正在补齐镜头')"
label="补齐缺失镜头"
description="保留已经完成的镜头,只补齐缺失的镜头,然后检查并保存。"
label="继续整理镜头"
description="复用已生成内容,修正可确定的状态标记并补齐缺失镜头,再执行完整质量检查。"
acknowledgement
:disabled="issueActionsDisabled || !recovery.shots"
@confirm="run('resume-shots')"
@@ -305,7 +305,7 @@ async function repairActions() {
description="仅展示当前阻断镜头。逐项选择并填写可观察的动作过程,提交前核对修复摘要。"
/>
<p v-if="!actionDrafts.length" class="text-xs text-muted">
当前阻断不属于批量接口支持的结果状态引用问题,无法在此自动修订。
此处仅支持填写结果状态引用的动作修订。其它问题可先使用下方“继续整理镜头”,由系统检查可修正项并保留剩余阻断。
</p>
<article
v-for="draft in actionDrafts"
@@ -117,7 +117,7 @@ defineExpose({ locate })
</p>
</div>
<ContextNotice v-if="!episode" type="info" :show-icon="false" class="mb-5">
本集已完成节拍规划,镜头尚未生成。请等待进度更新,或在确认中断后使用“补齐缺失镜头”。
本集已完成节拍规划,镜头尚未生成。请等待进度更新,或在确认中断后使用“继续整理镜头”。
</ContextNotice>
<section
v-for="beat in plan.beats"
+17 -5
View File
@@ -29,7 +29,14 @@ const nodes = [
] as const
/** 改写相关节点归入已有审核阶段,不影响其它节点的状态。 */
const reviewNodes = ['reviewDrama', 'generateRewriteSuggestion', 'rewrite', 'resumeRewrite']
const reviewNodes = [
'reviewDrama',
'generateRewriteSuggestion',
'rewrite',
'resumeRewrite',
'resumeReview',
'resolveDramaQuality'
]
/**
* 合并当前执行与最新保存记录,既不由节点顺序推断成功,也不复用新任务之前的旧审核结果。
@@ -48,6 +55,10 @@ export function dramaStages(
!execution ||
(!!checkpoint && Date.parse(checkpoint.createdAt) >= Date.parse(execution.startedAt ?? execution.createdAt))
const saved = currentSnapshot ? state : undefined
// 仅恢复审核时,服务端预检已绑定具体保存记录,前序产物继续有效;旧审核不能当成本轮结论。
const reusesReviewSource =
execution?.metadata?.action === 'resume-review' && execution.metadata.checkpointId === checkpoint?.checkpointId
const savedContent = currentSnapshot || reusesReviewSource ? state : undefined
const count = project?.episodeCount ?? saved?.episodeCount
const completed: Record<string, boolean> = {
// 恢复服务明确复用最新保存记录中的规划;不从 Episode、Character 或执行顺序反推规划成功。
@@ -55,10 +66,11 @@ export function dramaStages(
!!state?.storyPlan &&
(currentSnapshot ||
execution?.metadata?.action === 'resume-generation' ||
execution?.metadata?.action === 'resume-rewrite'),
generateEpisode: !!count && (saved?.episodes?.length ?? 0) >= count,
generateCharacter: !!saved?.characters,
generateWorld: !!saved?.world,
execution?.metadata?.action === 'resume-rewrite' ||
reusesReviewSource),
generateEpisode: !!count && (savedContent?.episodes?.length ?? 0) >= count,
generateCharacter: !!savedContent?.characters,
generateWorld: !!savedContent?.world,
reviewDrama: typeof saved?.reviewPassed === 'boolean',
finishProject: project?.status === 'completed'
}
@@ -10,6 +10,7 @@ import { useQuery } from '../../../composables/useQuery'
import { useProjectContext } from '../../projects/context'
import { workflowCheckpoints } from '../../workflows/selectors'
import DramaRewriteAction from './DramaRewriteAction.vue'
import DramaSystemReviewAction from './DramaSystemReviewAction.vue'
import ManualReviewIssueEditor from './ManualReviewIssueEditor.vue'
import ReviewUncertaintyCard from './ReviewUncertaintyCard.vue'
import { reviewCategoryOptions, suggestionForUncertainty, savedReviewDecisions } from './model'
@@ -87,12 +88,12 @@ const hasRewriteTargets = computed(
)
)
/** 当前有效预检只强调一个下一步入口,配色不代替服务端操作权限。 */
const primaryAction = computed<'confirm' | 'rewrite' | null>(() => {
const primaryAction = computed<'review' | 'rewrite' | null>(() => {
if (flow.locked.value || rewriteQuery.loading.value || rewriteQuery.error.value || latest.value?.passed !== false)
return null
if (currentRewrite.value?.status === 'blocked' || currentRewrite.value?.status === 'stale') return null
if (hasRewriteTargets.value) return currentRewrite.value?.ready === true ? 'rewrite' : null
return hasManualIssues.value ? 'confirm' : null
return hasManualIssues.value ? 'review' : null
})
/** 剧集范围同样读取真实改写预检,设定单独改写不伪造成剧集任务。 */
const rewriteEpisodeSummary = computed(() => {
@@ -117,9 +118,9 @@ const nextStep = computed(() => {
description: `${scope}已有改写依据。点击“改写预检”核对范围${hasManualIssues.value ? ';待确认问题仍可继续人工处理' : ''}。开始改写前会再次确认费用。`
}
: {
title: '请先核对审核问题',
title: '可由系统继续核查',
description:
'点击“人工确认”对照原文逐项处理。确认后如需改写,会显示“改写预检”入口;所有处理都需要你确认。'
'点击“系统重新核查”检查已保存正文,系统会优先复核疑点。只有仍无法确认的关键问题才需要人工处理。'
}
})
/** 正式正文的当前阅读集号。 */
@@ -283,10 +284,16 @@ function editorClosed() {
:disabled="flow.writing.value"
@refresh="flow.query.refresh"
/>
<DramaSystemReviewAction
v-if="latest?.passed === false"
:project-id="projectId"
:primary="primaryAction === 'review'"
:disabled="disabled || flow.locked.value"
@started="context.refresh"
/>
<NButton
v-if="hasManualIssues"
:class="{ 'workspace-action-button': primaryAction !== 'confirm' }"
:type="primaryAction === 'confirm' ? 'primary' : 'default'"
class="workspace-action-button"
aria-label="人工确认"
:disabled="!latest || latest.passed || flow.writing.value"
@click="flow.openEditor"
@@ -321,6 +328,15 @@ function editorClosed() {
reviewUncertain ? '审核状态待核对' : latest.passed ? '当前审核已通过' : '当前审核尚未通过'
}}</NTag>
</div>
<!-- 以下是系统已完成的逐项复核摘要,保留关键待核对数 -->
<p v-if="latest.automaticQualityResolution" class="text-sm text-muted">
<template v-if="latest.automaticQualityResolution.status === 'completed'">
系统复核了 {{ latest.automaticQualityResolution.candidateCount }} 项初审疑点, 其中
{{ latest.automaticQualityResolution.resolvedCount }} 项已有依据,
{{ latest.automaticQualityResolution.remainingCount }} 项仍需核对。
</template>
<template v-else>系统复核未完成,原审核疑点已保留。</template>
</p>
<!-- 以下是当前审核的下一步引导,仅在来源有效且读取完成后显示 -->
<ContextNotice
v-if="
@@ -0,0 +1,155 @@
<script setup lang="ts">
import { computed, onScopeDispose, ref, watch } from 'vue'
import { NButton } from 'naive-ui'
import { FileSearch } from '@lucide/vue'
import { AppDialog, WorkspaceRefreshButton } from '../../../components/ui'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import { useQuery } from '../../../composables/useQuery'
import { errorMessage } from '../../../lib/http'
import { getOperation, runOperation } from '../../workflows/operations'
import { useWorkflowExecution } from '../../workflows/execution'
import { dramaReviewApi, loadDramaReviewResumePreview } from './api'
/** 已保存剧本的系统核查入口,沿用项目级活动任务锁。 */
const props = withDefaults(
defineProps<{
/** 当前正式项目。 */ projectId: string
/** 当前外部操作锁。 */ disabled?: boolean
/** 无明确改写目标时强调系统核查。 */ primary?: boolean
}>(),
{ disabled: false, primary: false }
)
/** 后台实际受理后才通知页面刷新。 */
const emit = defineEmits<{ started: [executionId: string, projectId: string] }>()
/** 费用与范围确认弹窗。 */
const open = ref(false)
/** 正在提交,防止重复收费请求。 */
const writing = ref(false)
/** 只展示当前项目的操作错误。 */
const actionError = ref('')
/** 当前项目的公共操作状态。 */
const operation = computed(() => getOperation(props.projectId))
/** 弹窗打开后才查询来源。 */
const queryKey = computed(() => (open.value ? props.projectId : ''))
/** 只读查询可取消,关闭弹窗不启动模型。 */
const query = useQuery(queryKey, (id, signal) =>
id ? loadDramaReviewResumePreview(id, signal) : Promise.resolve(null)
)
/** 页面布局观察后台任务,本入口仅保存真实句柄。 */
const trackerProject = ref('')
/** 与其他创作入口共用持久化任务句柄。 */
const tracker = useWorkflowExecution(trackerProject, 'create-drama')
/** 当前确认来源版本。 */
let revision = 0
/** 二次预检的取消控制器。 */
let controller: AbortController | undefined
watch([open, () => props.projectId], () => {
revision++
controller?.abort()
actionError.value = ''
})
onScopeDispose(() => {
revision++
controller?.abort()
})
/** 仅使用当前预检与真实活动状态开放提交。 */
const ready = computed(
() =>
query.data.value?.ready === true &&
!query.loading.value &&
!query.error.value &&
!props.disabled &&
!operation.value.pending &&
!writing.value
)
/** 二次核对保存记录后提交一次核查;来源变化或网络不确定时不自动重试。 */
async function confirm() {
if (!ready.value || !query.data.value) return
const expected = query.data.value
const id = props.projectId
const version = revision
writing.value = true
actionError.value = ''
controller = new AbortController()
try {
await runOperation(
id,
'系统核查剧本',
async () => {
const current = await loadDramaReviewResumePreview(id, controller!.signal)
if (version !== revision || props.projectId !== id) throw new Error('当前项目已变化,请重新核对。')
if (
!current.ready ||
current.checkpointId !== expected.checkpointId ||
current.episodeCount !== expected.episodeCount
) {
query.data.value = current
throw new Error('保存记录已变化,请重新核对本次范围。')
}
const started = await dramaReviewApi.resumeReview(id, expected.checkpointId)
await tracker.track(started.executionId, id)
if (version === revision && props.projectId === id) {
emit('started', started.executionId, id)
open.value = false
}
return started
},
{ type: 'info', content: '系统核查已开始,请查看创作任务进度。' }
)
if (version === revision && props.projectId === id && getOperation(id).error)
actionError.value = getOperation(id).error
} catch (cause) {
if (version === revision && props.projectId === id) actionError.value = errorMessage(cause)
} finally {
writing.value = false
}
}
</script>
<template>
<span class="inline-flex">
<!-- 以下是系统核查入口,打开仅执行只读预检 -->
<NButton
:type="primary ? 'primary' : 'default'"
:disabled="disabled || operation.pending || writing"
aria-label="系统重新核查"
aria-haspopup="dialog"
:aria-expanded="open"
@click="open = true"
>
<template #icon><FileSearch :size="15" aria-hidden="true" /></template>系统重新核查
</NButton>
<AppDialog
v-model:open="open"
title="系统重新核查"
description="核查已保存的剧本,先由系统处理可确认的问题。"
:busy="writing"
>
<!-- 以下是范围、模型费用与错误反馈模块 -->
<div class="grid gap-5">
<p v-if="query.loading.value" class="text-sm text-muted">正在核对保存记录…</p>
<p v-if="query.data.value" class="text-sm">
本次核查已保存的 {{ query.data.value.episodeCount }} 集,不会重写正文、角色设定或世界观。
</p>
<ContextNotice type="info" title="本次操作会调用模型"
>系统会检查完整正文,必要时再复核一次疑点。明确错误会保留为改写依据,无法确认的关键问题仍会保留;请勿重复提交。</ContextNotice
>
<ContextNotice v-if="query.error.value || actionError" type="error" title="暂不能开始核查">{{
actionError || query.error.value
}}</ContextNotice>
</div>
<!-- 以下是固定取消、重新读取与明确开始操作模块 -->
<template #footer>
<NButton :disabled="writing" @click="open = false">取消</NButton>
<WorkspaceRefreshButton
label="重新检查"
:loading="query.loading.value"
:disabled="writing"
@refresh="query.refresh"
/>
<NButton type="primary" :loading="writing" :disabled="!ready" @click="confirm">开始系统核查</NButton>
</template>
</AppDialog>
</span>
</template>
+46
View File
@@ -3,6 +3,7 @@ import type {
ConfirmDramaIssuesInput,
ConfirmDramaIssuesResult,
DramaReviewPreview,
DramaReviewResumePreview,
DramaReviewSnapshot,
DramaRewritePreview,
LatestDramaReview
@@ -100,6 +101,28 @@ function validSuggestions(value: unknown): boolean {
/** 真实剧本审核接口;只读预检和人工确认均不调用模型。 */
export const dramaReviewApi = {
/**
* 读取重新核查已保存剧本的来源,不调用模型。
* @param id 正式项目
* @param signal 取消过期查询
* @returns 可核查的正文版本与集数
*/
resumePreview: (id: string, signal?: AbortSignal) =>
request<DramaReviewResumePreview>(`/projects/${encodeURIComponent(id)}/resume-review/preview`, { signal }),
/**
* 明确启动当前保存版本的系统核查,不重写正文。
* @param id 正式项目
* @param expectedCheckpointId 用户核对的来源版本
* @returns 持久化任务句柄
*/
resumeReview: (id: string, expectedCheckpointId: string) =>
request<{ executionId: string; projectId: string; status: string }>(
`/projects/${encodeURIComponent(id)}/resume-review`,
{
method: 'POST',
body: { confirmed: true, expectedCheckpointId }
}
),
/**
* 读取最新正式审核,尚无审核时返回空值。
* @param id 正式项目编号
@@ -198,3 +221,26 @@ export async function loadDramaReview(id: string, signal?: AbortSignal): Promise
return { latest, preview: null, previewError: errorMessage(cause) }
}
}
/**
* 核对系统核查预检的归属与完整字段,不能据本地状态补造就绪结果。
* @param id 正式项目
* @param signal 取消过期查询
* @returns 当前可信核查预检
*/
export async function loadDramaReviewResumePreview(
id: string,
signal?: AbortSignal
): Promise<DramaReviewResumePreview> {
const value = await dramaReviewApi.resumePreview(id, signal)
if (
value.projectId !== id ||
!value.checkpointId ||
value.readOnly !== true ||
typeof value.ready !== 'boolean' ||
!Number.isSafeInteger(value.episodeCount) ||
value.episodeCount < 1
)
throw new Error('系统核查的保存记录不完整,请重新读取。')
return value
}
+19
View File
@@ -35,6 +35,15 @@ export interface ManualReviewDecision {
/** 已保存的后续核验标准。 */ verificationCriteria?: string
}
/** 系统核查已保存正文前的只读来源预检。 */
export interface DramaReviewResumePreview {
/** 正式项目。 */ projectId: string
/** 当前完整正文对应的保存记录。 */ checkpointId: string
/** 实际保存的剧集数。 */ episodeCount: number
/** 后端已确认可核查。 */ ready: boolean
/** 预检不调用模型。 */ readOnly: true
}
/** 最新正式审核,不从保存记录的布尔值虚构明细。 */
export interface LatestDramaReview {
/** 正式审核编号。 */ id: string
@@ -48,6 +57,16 @@ export interface LatestDramaReview {
} | null
/** 原始待人工确认的问题。 */ pendingQualityIssues: DramaReviewIssue[]
/** 已保存的人工裁决。 */ manualUncertaintyDecisions: ManualReviewDecision[]
/** 系统逐项复核摘要;不等同于人工确认。 */ automaticQualityResolution?: {
/** 本次复核候选数。 */ candidateCount: number
/** 已有有效依据的项数。 */ resolvedCount: number
/** 仍需核对的项数。 */ remainingCount: number
/** 系统复核实际状态。 */ status: 'completed' | 'failed'
/** 实际判断依据,仅供追溯。 */ decisions: Array<{
/** 本轮候选索引。 */ candidateIndex: number
/** 判断原因。 */ reason: string
}>
} | null
/** 已有改写目标集数。 */ affectedEpisodes: number[]
/** 敏感词审核结果。 */ hitWords: string[]
}
@@ -0,0 +1,27 @@
import type { CreativeProfile, GenerationModelCatalog, GenerationOptions } from './types'
/**
* 从当前项目与能力目录恢复单图配置,丢弃目录不支持的旧尺寸。
* @param catalog 当前模型能力目录
* @param profile 当前项目保存的配置
* @returns 可用供应方及本次独立的参数副本
*/
export function imageGenerationDefaults(
catalog: GenerationModelCatalog,
profile: CreativeProfile
): {
/** 可用供应方。 */ provider: string
/** 模型默认值与项目值合并后的参数。 */ options: GenerationOptions
} {
const selected =
catalog.images.find(item => item.provider === profile.imageProvider && item.enabled) ??
catalog.images.find(item => item.enabled)
const options: GenerationOptions = {
...selected?.defaults,
...(selected?.provider === profile.imageProvider ? profile.imageOptions : {})
}
const size = selected?.generationOptions.find(item => item.key === 'size')
if (size?.options?.length && !size.options.some(option => option.value === options.size))
options.size = selected?.defaults.size ?? size.options[0]?.value ?? ''
return { provider: selected?.provider ?? '', options }
}
+2 -1
View File
@@ -67,8 +67,9 @@ export const productionApi = {
plan: (projectId: string, signal?: AbortSignal, input: ProductionPlanInput = {}) =>
request<ProductionPlanResponse>(`${projectPath(projectId)}/production/plan`, {
method: 'POST',
// 计划只解析这三项;阶段范围及视频参数只由启动接口消费。
// 计划携带与当前准备范围一致的阶段,不创建任务。
body: {
stage: input.stage,
imageProvider: input.imageProvider,
imageGenerationOptions: input.imageGenerationOptions,
videoProvider: input.videoProvider
@@ -0,0 +1,142 @@
<script setup lang="ts">
import { computed } from 'vue'
import { NButton, NCollapse, NCollapseItem, NTag } from 'naive-ui'
import { RouterLink } from 'vue-router'
import { ArrowUpRight } from '@lucide/vue'
import WorkspaceSectionHeading from '../../../components/ui/WorkspaceSectionHeading.vue'
import { userFacingText } from '../../../lib/user-facing-text'
import type { ProductionPlan } from '../types'
/** 图片准备与生产计划共用同一份后端规格及依赖。 */
const props = defineProps<{
/** 当前真实制作计划。 */ plan: ProductionPlan
/** 图片准备抽屉允许明确准备文字资料,生产计划仍只读。 */ allowPreparation?: boolean
/** 当前项目存在任务或检查未成功时禁止准备。 */ disabled?: boolean
}>()
/** 从计划转到资产处理时关闭外层检查抽屉。 */
const emit = defineEmits<{
/** 转到现有资产处理页面。 */ navigate: []
/** 确认前选择一次文字准备操作。 */ prepare: [formId: string, kind: 'prompt' | 'structure']
}>()
/** 顶层规格与稳定母版携带的规格来自同一后端检查。 */
const specs = computed(() => props.plan.propStructureSpecs ?? props.plan.stableIdentityAnchors?.propStructureSpecs)
/** 以服务端依赖顺序展示母版,未返回顺序时保留原始顺序。 */
const anchors = computed(() => {
const items = props.plan.stableIdentityAnchors?.items ?? props.plan.details.stableIdentityAnchors ?? []
const order = props.plan.stableIdentityAnchors?.dependencyOrder ?? []
return items.toSorted((a, b) => {
const left = order.indexOf(a.subjectId),
right = order.indexOf(b.subjectId)
return (left < 0 ? order.length : left) - (right < 0 ? order.length : right)
})
})
/** 主体名称从真实计划取得,不由引用或案例推断。 */
const names = computed(() => new Map(anchors.value.map(item => [item.subjectId, item.subjectName])))
/** 质量失败或过期只提供候选审核入口,不自动重生。 */
const qualityIssues = computed(() =>
props.plan.details.subjectImages.filter(item =>
item.issues.some(issue => ['quality_failed', 'quality_stale'].includes(issue.code))
)
)
</script>
<template>
<!-- 以下是道具结构规格准备模块,可准备不等于已经完成 -->
<section v-if="specs" class="space-y-4" aria-label="道具结构规格">
<WorkspaceSectionHeading
title="道具结构规格"
description="仅检查已有资料。待准备项需先补齐画面描述或规格,尚未执行。"
/>
<div class="flex flex-wrap gap-x-5 gap-y-2 text-xs">
<span>共 {{ specs.total }} 项</span><span>已就绪 {{ specs.ready }}</span
><span>待准备 {{ specs.upstreamResolvable }}</span
><span :class="specs.manualBlocked ? 'text-danger' : 'text-muted'"
>需人工处理 {{ specs.manualBlocked }}</span
>
</div>
<NCollapse v-if="specs.items.length" :default-expanded-names="specs.manualBlocked ? ['specs'] : []">
<NCollapseItem name="specs" title="查看规格准备明细">
<ul class="space-y-4 text-xs leading-6">
<li v-for="item in specs.items" :key="item.subjectFormId ?? item.subjectId">
<div class="flex flex-wrap items-center gap-2">
<strong>{{ names.get(item.subjectId) ?? item.subjectRef }}</strong
><NTag
size="small"
:bordered="false"
:type="item.status === 'blocked' ? 'error' : 'default'"
>{{ { ready: '已就绪', upstream: '待准备', blocked: '需人工处理' }[item.status] }}</NTag
>
</div>
<p class="mt-1 wrap-anywhere text-muted">{{ userFacingText(item.reason) }}</p>
<NButton
v-if="allowPreparation && item.status === 'upstream' && item.subjectFormId"
size="small"
class="workspace-action-button mt-2"
:disabled="disabled"
@click="
emit('prepare', item.subjectFormId, item.requiresFormPrompt ? 'prompt' : 'structure')
"
>{{ item.requiresFormPrompt ? '准备形态画面描述' : '准备结构规格' }}</NButton
>
</li>
</ul>
</NCollapseItem>
</NCollapse>
</section>
<!-- 以下是已确认母版依赖及准备顺序模块 -->
<section v-if="anchors.length" class="space-y-4" aria-label="母版准备顺序">
<WorkspaceSectionHeading
title="母版准备顺序"
description="按已确认的共享关系排列;锁定资产和人工阻断需要先核对。"
/>
<ol class="space-y-4 text-xs leading-6">
<li v-for="(item, index) in anchors" :key="item.subjectId" class="min-w-0">
<div class="flex flex-wrap items-center gap-2">
<strong>{{ index + 1 }}. {{ item.subjectName }}</strong
><NTag :bordered="false" size="small" :type="item.status === 'blocked' ? 'error' : 'default'">{{
{ skipped: '已有母版', ready: '待生成', upstream: '待准备资料', blocked: '需人工处理' }[
item.status
]
}}</NTag>
</div>
<p v-if="item.dependencySubjectIds?.length" class="mt-1 text-muted">
先准备:{{ item.dependencySubjectIds.map(id => names.get(id) ?? '关联主体').join('、') }}
</p>
<p class="mt-1 wrap-anywhere text-muted">{{ userFacingText(item.reason) }}</p>
<RouterLink
v-if="item.status === 'blocked'"
class="text-button mt-2 inline-flex items-center gap-2"
:to="{ path: `/projects/${plan.projectId}/subject-identity`, query: { subjectId: item.subjectId } }"
@click="emit('navigate')"
><ArrowUpRight :size="14" />查看主体与候选</RouterLink
>
</li>
</ol>
</section>
<!-- 以下是图片质量问题处理入口模块,保留旧图且不自动生成 -->
<section v-if="qualityIssues.length" class="space-y-4 lg:col-span-2" aria-label="图片质量待处理">
<WorkspaceSectionHeading
title="图片质量待处理"
description="审核失败或证据过期时,先核对候选并明确重新审核。"
/>
<article v-for="item in qualityIssues" :key="item.subjectFormId" class="space-y-2 text-xs leading-6">
<strong>{{ item.subjectName }} · {{ item.formName }}</strong>
<p
v-for="issue in item.issues.filter(issue => ['quality_failed', 'quality_stale'].includes(issue.code))"
:key="issue.code"
class="text-danger"
>
{{ userFacingText(issue.reason) }}
</p>
<RouterLink
class="text-button inline-flex items-center gap-2"
:to="{
path: `/projects/${plan.projectId}/subject-images`,
query: { subjectFormId: item.subjectFormId }
}"
@click="emit('navigate')"
><ArrowUpRight :size="14" />查看候选与审核</RouterLink
>
</article>
</section>
</template>
@@ -1,12 +1,17 @@
<script setup lang="ts">
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import ImagePreparationPlan from './ImagePreparationPlan.vue'
import { userFacingText } from '../../../lib/user-facing-text'
import { computed } from 'vue'
import { NCollapse, NCollapseItem, NScrollbar } from 'naive-ui'
import type { ProductionPlan, ProjectProductionStatus } from '../types'
/** 展示当前制作计划与真实资产状态,不在页面重复推断业务规则。 */
const props = defineProps<{ plan: ProductionPlan; status: ProjectProductionStatus }>()
const props = defineProps<{
/** 当前真实计划。 */ plan: ProductionPlan
/** 可选的已生成资产统计。 */ status?: ProjectProductionStatus
}>()
/** 生产阶段共享计划字段,角色身份就绪信息单独展示,避免混用不同 DTO。 */
const rows = computed(() => [
...(props.plan.stableIdentityAnchors ? [{ label: '稳定身份锚点', stage: props.plan.stableIdentityAnchors }] : []),
@@ -56,7 +61,7 @@ const problems = computed(() => [
{{ plan.characterIdentity.pending }} · 可自动补齐 {{ plan.characterIdentity.autoResolvable }} · 需人工处理
{{ plan.characterIdentity.manualBlocked }}
</p>
<p class="mt-2 text-xs" role="status">
<p v-if="status" class="mt-2 text-xs" role="status">
当前制作状态:{{ status.completed ? '制作已完成' : `待完成${stageNames[status.stage]}` }} · 有效主体图
{{ status.subjectImages.current }}/{{ status.subjectImages.total }} · 有效首帧
{{ status.keyframes.skipped }}/{{ status.keyframes.total }} · 有效主视频 {{ status.videos.skipped }}/{{
@@ -92,20 +97,22 @@ const problems = computed(() => [
</table>
</NScrollbar>
<p class="mt-2 text-xs text-muted">
计划会根据当前素材自动更新。已有有效结果会直接复用;重新生成的过期主体图会自动设为当前主图,手动生成的候选仍可在形态图片页自行确认。
计划只反映当前准备情况。图片生成完成后仍需通过质量和来源检查;失败候选会保留,不能用重新生图自动消除质量阻断。
</p>
<ContextNotice v-if="plan.hasManualBlockers" type="warning" :show-icon="false" class="mt-3">
当前有
{{ plan.manualBlocked }}
项独立准备问题需人工处理。上表各阶段的影响数量可能重叠,不能直接相加。可先生成就绪的主体参考图;成功结果会保留,遇到阻塞时后续阶段可能暂停。
</ContextNotice>
<!-- 以下是当前道具规格、共享母版依赖与质量处理入口 -->
<div class="mt-5 grid items-start gap-6 lg:grid-cols-2"><ImagePreparationPlan :plan="plan" /></div>
<NCollapse v-if="problems.length" class="mt-3" :default-expanded-names="['issues']">
<NCollapseItem name="issues" title="查看还需要准备的内容">
<ul class="space-y-3 text-xs">
<li v-for="item in problems" :key="item.key">
<strong class="break-all">{{ item.label }}</strong>
<p v-for="(issue, index) in item.issues" :key="index" class="mt-1 break-words">
{{ issue.reason
{{ userFacingText(issue.reason)
}}<span v-if="issue.missingSubjects?.length">
· 关联主体:{{ issue.missingSubjects.join('、') }}</span
>
+2
View File
@@ -68,6 +68,8 @@ export function issueLabel(code: ProductionIssueCode): string {
missing_primary_keyframe: '缺少可用首帧',
missing_identity: '缺少角色身份',
missing_identity_anchor: '缺少演员母版',
quality_failed: '主体图片质量未通过',
quality_stale: '主体图片审核需更新',
identity_unlocked: '演员身份未锁定',
missing_prompt: '缺少视频提示词',
stale_prompt: '视频提示词需要更新',
+43
View File
@@ -11,6 +11,10 @@ export type ProductionIssueCode =
| 'missing_primary_keyframe'
| 'missing_identity'
| 'missing_identity_anchor'
/** 当前主图质量未通过。 */
| 'quality_failed'
/** 当前主图审核证据已失效。 */
| 'quality_stale'
| 'identity_unlocked'
| 'missing_prompt'
| 'stale_prompt'
@@ -555,9 +559,15 @@ export interface ProductionPlan {
characterIdentity?: ProductionCharacterIdentityPlan
/** 稳定身份母版阶段与真实逐项计划。 */
stableIdentityAnchors?: ProductionPlanStage & {
/** 按已确认共享关系给出的准备顺序。 */
dependencyOrder?: string[]
/** 同源的道具规格统计。 */
propStructureSpecs?: PropStructurePreparation
/** 稳定主体的逐项就绪结果。 */
items?: ProductionStableIdentityItem[]
}
/** 道具规格准备统计,仅表示当前计划,不代表执行完成。 */
propStructureSpecs?: PropStructurePreparation | null
stage: ProductionStatusStage
hasManualBlockers: boolean
manualBlocked: number
@@ -746,6 +756,8 @@ export type ProductionStage = 'subjectImages' | 'keyframes' | 'videoPrompts'
/** 无消耗生产计划与实际启动共用的模型配置。 */
export interface ProductionPlanInput {
/** 只读核对本轮阶段范围。 */
stage?: ProductionStage
/** 本轮图片模型供应方。 */
imageProvider?: string
/** 主体图片与首帧共用的图片生成参数。 */
@@ -790,6 +802,8 @@ export interface ProductionCharacterIdentityPlan {
/** 后端稳定身份母版计划的单个主体。 */
export interface ProductionStableIdentityItem {
/** 本主体依赖的已确认共享主体编号。 */
dependencySubjectIds?: string[]
/** 数据库主体 ID。 */
subjectId: string
/** 主体引用标识。 */
@@ -803,3 +817,32 @@ export interface ProductionStableIdentityItem {
/** 后端提供的就绪或阻塞原因。 */
reason: string
}
/** 只读道具规格的准备情况。 */
export interface PropStructurePreparation {
/** 规格总数。 */
total: number
/** 当前有效规格数。 */
ready: number
/** 需先补描述或规格的数量。 */
upstreamResolvable: number
/** 需人工处理的数量。 */
manualBlocked: number
/** 逐形态真实检查结果。 */
items: Array<{
/** 所属正式主体编号。 */
subjectId: string
/** 主体引用。 */
subjectRef: string
/** 正式形态编号,缺少形态时为 null。 */
subjectFormId: string | null
/** 有效、需准备或人工阻断。 */
status: 'ready' | 'upstream' | 'blocked'
/** 规格的真实状态。 */
specStatus: 'ready' | 'missing' | 'stale' | 'missing_form'
/** 是否需先准备正式画面描述。 */
requiresFormPrompt: boolean
/** 后端具体原因。 */
reason: string
}>
}
+4 -2
View File
@@ -77,7 +77,7 @@ const operation = computed(() => getOperation(id.value))
const createDramaExecution = useWorkflowExecution(id, 'create-drama', { discover: true })
/** 项目内跨页面继续观察首帧后台任务,维持活动锁并在真实终态后释放。 */
useWorkflowExecution(id, 'keyframe-quality')
/** 既有生成入口在跨页面时继续观察,保持项目活动锁。 */
/** 派生设计从服务端发现新任务;其它既有入口继续观察已知任务,保持项目活动锁。 */
for (const workflowName of [
'storyboard-direction',
'storyboard-visual-state',
@@ -85,7 +85,9 @@ for (const workflowName of [
'keyframe-generation',
'video-quality'
]) {
useWorkflowExecution(id, workflowName)
useWorkflowExecution(id, workflowName, {
discover: ['storyboard-direction', 'storyboard-visual-state'].includes(workflowName)
})
}
/** 即使直接刷新到生产页,也按真实重生成任务恢复旧剧情快照的失效标记。 */
const breakdownExecution = useWorkflowExecution(id, 'breakdown', { discover: true })
@@ -39,6 +39,7 @@ const durationOptions = [
{ label: '固定集数与总时长', value: 'fixed_episode_count' },
{ label: '根据单集时长推导集数', value: 'flexible_episode_count' }
]
/** 根据目标总时长和单集范围推导可行集数,无法满足范围时返回空值。 */
const estimatedCount = computed(() => {
if (form.durationMode !== 'flexible_episode_count' || form.minSeconds <= 0 || form.maxSeconds < form.minSeconds)
return null
@@ -49,6 +50,17 @@ const estimatedCount = computed(() => {
const midpoint = (form.minSeconds + form.maxSeconds) / 2
return Math.max(minimum, Math.min(maximum, Math.round(total / midpoint)))
})
/** 生成前展示当前模式的集数与时长摘要,便于核对创作规模。 */
const durationSummary = computed(() => {
if (form.durationMode === 'auto') return `计划 ${form.episodeCount} 集,时长由故事内容规划。`
const count = form.durationMode === 'fixed_episode_count' ? form.episodeCount : estimatedCount.value
if (!count || form.totalMinutes <= 0) return '调整时长与集数后,可在这里查看创作规模。'
const averageSeconds = Math.round((form.totalMinutes * 60) / count)
if (form.durationMode === 'fixed_episode_count') {
return `计划 ${count} 集,总时长 ${form.totalMinutes} 分钟,平均每集约 ${averageSeconds} 秒。`
}
return `预计 ${count} 集,总时长 ${form.totalMinutes} 分钟,平均每集约 ${averageSeconds} 秒。`
})
/** 只发送当前模式所需字段,避免弹性模式携带顶层 episodeCount。 */
function durationBudget(): DramaDurationBudget {
if (form.durationMode === 'auto') return { mode: 'auto', episodeCount: form.episodeCount }
@@ -220,6 +232,8 @@ const rules = computed(() => ({
:step="1"
></NInputNumber
></NFormItem>
<!-- 以下是生成前的集数与时长核对摘要模块 -->
<p class="text-sm text-muted" role="status" aria-live="polite">{{ durationSummary }}</p>
</div>
<FeedbackMessage v-if="feedback" :message="feedback" />
</AppForm>
+8 -7
View File
@@ -121,13 +121,14 @@ export interface DramaState {
/** 项目制作导航使用的服务端统一阶段状态。 */
export interface ProjectStageReadiness {
projectId: string
script: { ready: boolean; reason: string | null }
breakdown: { ready: boolean; reason: string | null }
visualStyle: { ready: boolean; reason: string | null }
identity: { ready: boolean; reason: string | null }
subjectAssets: { ready: boolean; reason: string | null }
storyboard: { ready: boolean; reason: string | null }
/** 正式项目编号。 */ projectId: string
/** 剧本审核和保存状态。 */ script: { ready: boolean; reason: string | null }
/** 正式分镜完整审核,供镜头设计和制作使用。 */ breakdown: { ready: boolean; reason: string | null }
/** 来源、结构和动作自动检查通过,可先准备风格和主体素材。 */ preparation: { ready: boolean; reason: string | null }
/** 项目视觉风格是否已保存。 */ visualStyle: { ready: boolean; reason: string | null }
/** 角色身份是否已准备。 */ identity: { ready: boolean; reason: string | null }
/** 主体素材是否已准备。 */ subjectAssets: { ready: boolean; reason: string | null }
/** 镜头设计是否已准备。 */ storyboard: { ready: boolean; reason: string | null }
}
/** 单集分镜时长偏差审计结果。 */
+11 -21
View File
@@ -25,33 +25,23 @@ export function useProjectStageAccess(projectId: Ref<string>, readiness: Ref<Pro
nextLabel: '前往剧本创作'
},
'visual-style': {
...accessState(state?.breakdown.ready, state?.breakdown.reason, '请先完成剧本拆解'),
...accessState(state?.preparation?.ready, state?.preparation?.reason, '请先完成剧本拆解'),
nextPath: 'breakdown',
nextLabel: '前往剧本拆解'
},
'subject-identity': {
enabled: Boolean(state?.breakdown.ready && state?.visualStyle.ready),
reason: state?.breakdown.reason || state?.visualStyle.reason || '请先准备视觉风格',
nextPath: state?.breakdown.ready ? 'visual-style' : 'breakdown',
nextLabel: state?.breakdown.ready ? '前往视觉风格' : '前往剧本拆解'
enabled: Boolean(state?.preparation?.ready && state?.visualStyle.ready),
reason: state?.preparation?.reason || state?.visualStyle.reason || '请先准备视觉风格',
nextPath: state?.preparation?.ready ? 'visual-style' : 'breakdown',
nextLabel: state?.preparation?.ready ? '前往视觉风格' : '前往剧本拆解'
},
'subject-images': {
enabled: Boolean(state?.breakdown.ready && state?.visualStyle.ready && state?.identity.ready),
reason:
state?.breakdown.reason ||
state?.visualStyle.reason ||
state?.identity.reason ||
'请先完成主体身份准备',
nextPath: state?.visualStyle.ready
? 'subject-identity'
: state?.breakdown.ready
? 'visual-style'
: 'breakdown',
nextLabel: state?.visualStyle.ready
? '前往主体身份'
: state?.breakdown.ready
? '前往视觉风格'
: '前往剧本拆解'
// 此页同时准备单个素材的Prompt与规格;全项目身份未齐备不阻断只读检查和逐项准备。
// 付费生成仍由本素材的实际预览、身份/规格与版本门禁决定。
enabled: Boolean(state?.preparation?.ready && state?.visualStyle.ready),
reason: state?.preparation?.reason || state?.visualStyle.reason || '请先准备视觉风格',
nextPath: state?.preparation?.ready ? 'visual-style' : 'breakdown',
nextLabel: state?.preparation?.ready ? '前往视觉风格' : '前往剧本拆解'
},
storyboard: {
enabled: Boolean(state?.breakdown.ready && state?.subjectAssets.ready),
@@ -433,6 +433,18 @@ async function repaired() {
title="补齐镜头设计与画面状态"
description="先更新镜头设计,再更新画面状态。只补齐缺失或过期结果,生成可能产生模型费用。"
/>
<p
class="text-sm"
:class="flow.data.value.entry.storyboardValid === false ? 'text-danger' : 'text-muted'"
>
正式分镜结构检查:{{
flow.data.value.entry.storyboardValid === true
? '通过'
: flow.data.value.entry.storyboardValid === false
? '未通过或已过期'
: '待确认'
}}。镜头设计和画面状态覆盖单独检查,入口就绪不代表图片质量已通过。
</p>
<p class="text-sm text-muted">
已保存镜头设计 {{ flow.data.value.entry.derivedAssets.directionCount }} /
{{ flow.data.value.entry.derivedAssets.shotCount }} · 画面状态
@@ -10,9 +10,11 @@ import type { StoryboardReceipt } from '../types'
/** 独立展示提交结果,不能将 HTTP 成功或局部成功显示为整批完成。 */
const props = defineProps<{ receipt: StoryboardReceipt }>()
/** 部分失败与待人工核对均不表示批次通过。 */
const failed = computed(() => {
if (props.receipt.kind === 'shots') return !props.receipt.result.storyboardShotValidation.valid
if (props.receipt.kind === 'batch') return props.receipt.result.failedEpisodes > 0
if (props.receipt.kind === 'batch')
return props.receipt.result.failedEpisodes > 0 || props.receipt.result.manualReviewRequired === true
return props.receipt.result.failed > 0
})
+2
View File
@@ -85,6 +85,8 @@ export interface EpisodeGenerationResult {
/** 两种设计批处理返回相同的汇总结构。 */
export interface StoryboardBatchResult {
/** 部分失败后的真实人工核对标记。 */
manualReviewRequired?: boolean
/** 本轮结束后仍然过期的设计记录,不因覆盖率完整而忽略。 */
staleCount?: number
projectId: string
+1 -1
View File
@@ -175,7 +175,7 @@ export function useStoryboard() {
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 (record.result && (record.status === 'completed' || index === 1 || index === 2)) {
if (index === 0) {
const result = record.result as unknown as StoryboardShotRegenerationResult
const number = record.metadata?.episodeNo
@@ -91,7 +91,8 @@ const {
confirmCasting,
validateImage,
generateStableAnchorQuality,
pendingImageOperation
pendingImageOperation,
validationResult
} = useSubjectIdentity()
/** 所有形态图片入口复用侧栏和路由的服务端阶段准入规则。 */
const stageAccess = useProjectStageAccess(projectId, projectContext.stageReadiness)
@@ -225,30 +226,6 @@ function exportReceipt() {
downloadText('subject-identities-receipt.json', JSON.stringify(session.value.receipt, null, 2), 'application/json')
}
/**
* 前置校验通过并开始提交时关闭原主体弹窗,后续状态通过消息反馈。
* @param input 已确认的身份图生成参数
* @returns 提交与详情刷新完成
*/
async function submitIdentityImage(input: Parameters<typeof generateImage>[0]) {
const targetId = selectedId.value
await generateImage(input, () => {
if (selectedId.value === targetId) imageOpen.value = false
})
}
/**
* 前置校验通过并开始提交时关闭原主体选角弹窗,不等待接口返回。
* @param input 已确认的选角生成参数
* @returns 提交与列表刷新完成
*/
async function submitCastingCandidate(input: Parameters<typeof generateCastingCandidate>[0]) {
const targetId = selectedId.value
await generateCastingCandidate(input, () => {
if (selectedId.value === targetId) castingOpen.value = false
})
}
/**
* 按主体类型确认母版,成功后关闭原主体的管理弹窗。
* @param imageId 用户明确选择的图片编号
@@ -461,8 +438,7 @@ const nextAction = computed<{ action: IdentityFlowAction; title: string; descrip
return {
action: 'confirm',
title: '第 3 步:确认并锁定',
description:
'在下方图片卡片中确认母版;其他图片可通过“管理候选”查看。人物会同时锁定,场景和道具还需保存锁定状态。',
description: '在下方图片卡片中核对并确认母版,质量通过后会同时锁定身份;其他图片可通过“管理候选”查看。',
label: '查看候选并确认'
}
return {
@@ -642,7 +618,7 @@ function runNextAction() {
</p>
<p class="mt-2 text-xs leading-6 text-muted">
未注明人物背景时,AI
默认采用中国人物特征;剧本和角色设定优先。点击下方角色可关闭此界面并查看详情,不会确认或更改选角。
遵循剧本与角色特征;未明确人物背景时保持地域与族裔中性。点击下方角色可关闭此界面并查看详情,不会确认或更改选角。
</p>
<div class="casting-list" role="group" aria-label="角色选角进度">
<NButton
@@ -982,6 +958,7 @@ function runNextAction() {
detailBlocked || (subject.module === 'character' && !!castingQuery.error.value)
"
:pending-operation="pendingImageOperation"
:validation-result="validationResult"
:retry-disabled-reason="imageRetryDisabledReason"
@validate="validateImage"
@anchor="chooseAnchor"
@@ -1068,7 +1045,7 @@ function runNextAction() {
:catalog="generationModelsQuery.data.value"
:profile="profileQuery.data.value.profile"
:disabled="!canGenerateImage"
@generate="submitIdentityImage" />
:submit-generation="generateImage" />
<CastingCandidateDialog
v-if="
subject?.module === 'character' && profileQuery.data.value?.profile && generationModelsQuery.data.value
@@ -1079,7 +1056,7 @@ function runNextAction() {
:catalog="generationModelsQuery.data.value"
:profile="profileQuery.data.value.profile"
:disabled="!canGenerateCandidate"
@generate="submitCastingCandidate"
:submit-generation="generateCastingCandidate"
/></WorkspacePage>
<!-- 以下是点击生图时才展示的模型配置引导,关闭后交给唯一项目配置抽屉 -->
<AppDialog v-model:open="modelPromptOpen" title="需要配置生成模型" status="warning" @closed="finishModelPrompt">
+26 -5
View File
@@ -81,10 +81,10 @@ export const subjectIdentityApi = {
timeoutMs: 0
}),
/**
* 读取与实际生图同源的输入预览,道具可能执行已确认的结构模型编译。
* 只读编译当前已有资料,与实际生图输入同源,不补齐结构规格。
* @param subjectId 正式主体 ID
* @param input 与实际生图相同的参数
* @param signal 只读预览取消信号,可能付费的道具不传
* @param signal 取消过期预览
* @returns 后端真实输入与最终参数
*/
previewImage: (subjectId: string, input: GenerateIdentityImageInput, signal?: AbortSignal) =>
@@ -117,19 +117,40 @@ export const subjectIdentityApi = {
body: input,
timeoutMs: 0
}),
/**
* 确认身份母版,质量审核可能耗时,等待真实服务结果。
* @param subjectId 正式主体编号
* @param imageId 当前候选编号
* @returns 已通过事务确认的图片或锁定回执
*/
setAnchor: (subjectId: string, imageId: string) =>
request<IdentityImage>(`${identityPath(subjectId)}/images/${encodeURIComponent(imageId)}/anchor`, {
method: 'PUT'
method: 'PUT',
timeoutMs: 0
}),
/**
* 确认场景或道具母版,通过质量门禁后锁定身份。
* @param subjectId 正式主体编号
* @param imageId 当前候选编号
* @returns 已通过事务确认的图片或锁定回执
*/
confirmStableAnchor: (subjectId: string, imageId: string) =>
request<ConfirmCastingResult>(
`${identityPath(subjectId)}/images/${encodeURIComponent(imageId)}/stable-anchor`,
{
method: 'PUT'
method: 'PUT',
timeoutMs: 0
}
),
/**
* 确认角色选角,通过质量门禁后锁定演员。
* @param subjectId 正式主体编号
* @param imageId 当前候选编号
* @returns 已通过事务确认的图片或锁定回执
*/
confirmCasting: (subjectId: string, imageId: string) =>
request<ConfirmCastingResult>(`${identityPath(subjectId)}/images/${encodeURIComponent(imageId)}/casting`, {
method: 'PUT'
method: 'PUT',
timeoutMs: 0
})
}
@@ -1,9 +1,13 @@
<script setup lang="ts">
import { imageGenerationDefaults } from '../../generation-config/image-defaults'
import ImageGenerationPreview from '../../subject-images/components/ImageGenerationPreview.vue'
import { useImageGenerationPreview, type ImageGenerationSubmission } from '../../subject-images/generation-preview'
import { subjectIdentityApi } from '../api'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import { NButton, NCheckbox, NFormItem, NInput } from 'naive-ui'
import { computed, ref, watch } from 'vue'
import { AppDialog } from '../../../components/ui'
import { AppDrawer } from '../../../components/ui'
import AppForm from '../../../components/ui/AppForm.vue'
import GenerationModelControls from '../../generation-config/components/GenerationModelControls.vue'
import type { CreativeProfile, GenerationModelCatalog, GenerationOptions } from '../../generation-config/types'
@@ -11,67 +15,78 @@ import type { GenerateCastingCandidateInput } from '../types'
/** Character 选角候选表单固定使用 primary,每次独立生成且不会自动选择演员。 */
const props = defineProps<{
/** 正式主体编号。 */
subjectId: string
/** 主体名称。 */
subjectName: string
/** 项目活动任务锁。 */
disabled: boolean
/** 模型能力目录。 */
catalog: GenerationModelCatalog
/** 项目默认配置。 */
profile: CreativeProfile
/** 提交已核对的独立选角输入。 */
submitGeneration: (input: GenerateCastingCandidateInput) => Promise<ImageGenerationSubmission>
}>()
/** 全屏生成表单开关。 */
const open = defineModel<boolean>('open', { default: false })
const emit = defineEmits<{ generate: [input: GenerateCastingCandidateInput] }>()
/** 统一表单校验入口。 */
const formRef = ref<InstanceType<typeof AppForm> | null>(null)
/** 仅本次使用的完整画面描述。 */
const prompt = ref('')
/** 当前模型供应方。 */
const provider = ref('')
/** 模型动态参数。 */
const generationOptions = ref<GenerationOptions>({})
const acknowledged = ref(false)
/** 供应方是否可用。 */
const valid = computed(() => Boolean(provider.value))
/** 每次切换角色或重新打开都恢复项目当前图片模型与参数。 */
function reset() {
prompt.value = ''
provider.value = props.profile.imageProvider
const selected =
props.catalog.images.find(item => item.provider === props.profile.imageProvider && item.enabled) ??
props.catalog.images.find(item => item.enabled)
provider.value = selected?.provider ?? ''
generationOptions.value = {
...selected?.defaults,
...(selected?.provider === props.profile.imageProvider ? props.profile.imageOptions : {})
}
const sizeSchema = selected?.generationOptions.find(item => item.key === 'size')
if (
sizeSchema?.options?.length &&
!sizeSchema.options.some(option => option.value === generationOptions.value.size)
) {
generationOptions.value.size = selected?.defaults.size ?? sizeSchema.options[0]?.value ?? ''
}
acknowledged.value = false
const defaults = imageGenerationDefaults(props.catalog, props.profile)
provider.value = defaults.provider
generationOptions.value = defaults.options
}
watch([() => props.subjectId, open, () => props.profile], reset, { immediate: true })
/** 候选生成显式携带当前图片 Provider 与动态参数,避免 Seedream 尺寸污染 Qwen。 */
function submit() {
if (props.disabled || !valid.value || !acknowledged.value) return
emit('generate', {
...(prompt.value.trim() ? { prompt: prompt.value.trim() } : {}),
provider: provider.value,
generationOptions: generationOptions.value
/** 选角正式请求不接收视角和母版开关,固定规则只传入预览。 */
const generationInput = computed<GenerateCastingCandidateInput>(() => ({
...(prompt.value.trim() ? { prompt: prompt.value.trim() } : {}),
provider: provider.value,
generationOptions: { ...generationOptions.value }
}))
/** 选角使用 primary 且不引用当前母版,与正式候选生成一致。 */
const { preview, acknowledged, loading, submitting, error, staleNotice, canSubmit, loadPreview, submit } =
useImageGenerationPreview({
open,
target: () => JSON.stringify([props.subjectId, props.profile]),
input: () => generationInput.value,
disabled: () => props.disabled || !valid.value,
load: (input, signal) =>
subjectIdentityApi.previewImage(
props.subjectId,
{ ...input, viewType: 'primary', useAnchorReference: false },
signal
),
generate: input => props.submitGeneration(input)
})
}
/** 当前描述草稿对应的表单模型。 */
const formModel = computed(() => ({ prompt: prompt.value }))
</script>
<template>
<!-- 以下是 AI 生成角色候选图模块,生成后仍需用户确认选角 -->
<AppDialog
<AppDrawer
v-model:open="open"
title="AI 生成角色候选图"
:busy="submitting"
:description="`${subjectName} · 生成后需确认选角,才能设为角色母版`"
>
<AppForm
ref="formRef"
:model="formModel"
:disabled="disabled"
:disabled="disabled || submitting"
:reset-key="`${open}:${subjectId}`"
validate-on-change
class="dialog-form-stack"
@@ -88,7 +103,7 @@ const formModel = computed(() => ({ prompt: prompt.value }))
:label-props="{ for: 'casting-candidate-prompt' }"
>
<NInput
placeholder="建议留空,自动使用已保存的角色特征;未明确人物背景时默认中国人物"
placeholder="建议留空,自动使用已保存的角色特征;未明确人物背景时保持地域与族裔中性"
:input-props="{ id: 'casting-candidate-prompt' }"
class="min-h-24"
v-model:value="prompt"
@@ -105,27 +120,32 @@ const formModel = computed(() => ({ prompt: prompt.value }))
:provider="provider"
:options="generationOptions"
:aspect-ratio="profile.aspectRatio"
:disabled="disabled"
:disabled="disabled || submitting"
@update:provider="provider = $event"
@update:options="generationOptions = $event"
/>
<!-- 以下是独立选角的输入预览与费用确认模块 -->
<ImageGenerationPreview
:preview="preview"
:loading="loading"
:disabled="disabled || submitting || !valid"
:error="error"
:stale-notice="staleNotice"
@load="loadPreview"
/>
<NCheckbox
id="casting-candidate-cost"
v-model:checked="acknowledged"
:disabled="!preview || submitting"
class="flex items-start gap-2 text-xs leading-6"
>我已确认调用图片模型可能产生费用,且当前没有同项目生成任务。
>我已核对本次独立选角预览,确认图片模型费用。
</NCheckbox>
</AppForm>
<template #footer>
<NButton @click="open = false">取消</NButton>
<NButton
:disabled="disabled || !valid || !acknowledged"
:loading="disabled"
type="primary"
@click="formRef?.validate(submit)"
>
{{ disabled ? '生成中…' : 'AI 生成角色候选图' }}
<NButton :disabled="submitting" @click="open = false">取消</NButton>
<NButton :disabled="!canSubmit" :loading="submitting" type="primary" @click="formRef?.validate(submit)">
{{ submitting ? '提交中…' : 'AI 生成角色候选图' }}
</NButton>
</template>
</AppDialog>
</AppDrawer>
</template>
@@ -1,4 +1,6 @@
<script setup lang="ts">
import ImageValidationPanel from '../../subject-images/components/ImageValidationPanel.vue'
import type { IdentityValidationResult } from '../types'
import { NButton, NTag } from 'naive-ui'
import { LoaderCircle } from '@lucide/vue'
import { computed, ref, watch } from 'vue'
@@ -24,6 +26,8 @@ const props = defineProps<{
pendingOperation?: IdentityImageOperation | null
/** 重新生成暂不可用的具体恢复步骤。 */
retryDisabledReason?: string
/** 本主体最近一次显式图片审核结果。 */
validationResult?: IdentityValidationResult | null
}>()
/** 图片操作交给父页面核验并执行,浏览候选不会修改母版。 */
const emit = defineEmits<{
@@ -133,6 +137,12 @@ defineExpose({ openCandidates, closeCandidates })
@regenerate="regenerate"
/>
</div>
<!-- 以下是主页面图片本次审核证据模块 -->
<ImageValidationPanel
v-if="validationResult && images.some(image => image.id === validationResult?.imageId) && !candidatesOpen"
class="mt-5"
:result="validationResult"
/>
<!-- 以下是与镜头生产一致的底部图片操作模块 -->
<div class="identity-gallery-actions">
<NButton v-if="managedCandidates.length" @click="openCandidates"
@@ -147,6 +157,7 @@ defineExpose({ openCandidates, closeCandidates })
title="身份候选管理"
:description="`${subjectName} 的其他候选与辅助参考图;已在主页面展示的图片不重复列出。辅助参考图不能设为母版。`"
:width="candidatesWidth"
:busy="!!pendingOperation"
>
<div class="identity-candidate-grid">
<IdentityImageCard
@@ -165,6 +176,12 @@ defineExpose({ openCandidates, closeCandidates })
@regenerate="regenerate"
/>
</div>
<!-- 以下是候选管理中的审核证据模块 -->
<ImageValidationPanel
v-if="validationResult && managedCandidates.some(image => image.id === validationResult?.imageId)"
class="mt-5"
:result="validationResult"
/>
</AppDialog>
</section>
</template>
@@ -132,8 +132,11 @@ function regenerate() {
<div class="identity-image-card-body">
<div class="flex flex-wrap items-center gap-2">
<!-- 母版已是完成图,仅保留身份标识;候选继续显示生成状态。 -->
<NTag v-if="!image.isAnchor && image.status === 'completed'" :bordered="false" size="small"
>图片已生成</NTag
>
<StatusBadge
v-if="!image.isAnchor && !failureNotice"
v-else-if="!image.isAnchor && !failureNotice"
:status="image.status"
:label="image.status === 'pending' ? '排队中' : undefined"
/>
@@ -236,6 +239,10 @@ function regenerate() {
: `确认切换 ${subjectName} 的身份母版?旧母版会保留在候选记录中,后续形态图片生成会使用新母版。`
"
>
<!-- 以下是身份母版采纳的费用与门禁说明模块 -->
<p class="text-sm leading-7 text-muted">
确认时会核对当前来源和质量,可能调用视觉模型并产生审核费用。通过后才锁定并采纳;未通过时保留旧母版,不自动追加生图。
</p>
<template #footer>
<NButton @click="confirming = false">取消</NButton>
<NButton :disabled="!canSelect" type="primary" @click="chooseAnchor">{{
@@ -1,22 +1,18 @@
<script setup lang="ts">
import RawDataDetails from '../../../components/ui/RawDataDetails.vue'
import FeedbackMessage from '../../../components/ui/FeedbackMessage.vue'
import { imageGenerationDefaults } from '../../generation-config/image-defaults'
import ImageGenerationPreview from '../../subject-images/components/ImageGenerationPreview.vue'
import { useImageGenerationPreview, type ImageGenerationSubmission } from '../../subject-images/generation-preview'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import { referenceGenerationCatalog, referenceGenerationOptions } from '../reference-generation'
import ConfirmAction from '../../workflows/ConfirmAction.vue'
import { getOperation, runOperation } from '../../workflows/operations'
import AppForm from '../../../components/ui/AppForm.vue'
import { NFormItem } from 'naive-ui'
import { fieldRule } from '../../../lib/form-rules'
import { NButton, NCheckbox, NInput, NSelect } from 'naive-ui'
import { computed, onBeforeUnmount, ref, watch } from 'vue'
import { AppDialog, FieldLabel } from '../../../components/ui'
import { computed, ref, watch } from 'vue'
import { AppDrawer, FieldLabel } from '../../../components/ui'
import GenerationModelControls from '../../generation-config/components/GenerationModelControls.vue'
import type { CreativeProfile, GenerationModelCatalog, GenerationOptions } from '../../generation-config/types'
import { subjectIdentityApi } from '../api'
import type { IdentityImagePreview } from '../types'
import { currentAnchor, identityViewLabels } from '../model'
import type { GenerateIdentityImageInput, IdentityImage, IdentityViewType } from '../types'
@@ -38,12 +34,14 @@ const props = defineProps<{
catalog: GenerationModelCatalog
/** 已保存的项目默认生成配置。 */
profile: CreativeProfile
/** 提交当前参数与已核对的输入版本。 */
submitGeneration: (input: GenerateIdentityImageInput) => Promise<ImageGenerationSubmission>
}>()
/** open 的当前界面状态与输入绑定。 */
const open = defineModel<boolean>('open', { default: false })
/** emit 的当前界面状态与输入绑定。 */
const emit = defineEmits<{ generate: [input: GenerateIdentityImageInput] }>()
/** 统一表单校验入口。 */
const formRef = ref<InstanceType<typeof AppForm> | null>(null)
/** 当前生成视角。 */
const viewType = ref<IdentityViewType>('primary')
/** referenceImageId 的当前界面状态与输入绑定。 */
const referenceImageId = ref('')
@@ -51,9 +49,8 @@ const referenceImageId = ref('')
const prompt = ref('')
/** provider 的当前界面状态与输入绑定。 */
const provider = ref('')
/** 当前模型参数。 */
const generationOptions = ref<GenerationOptions>({})
/** acknowledged 的当前界面状态与输入绑定。 */
const acknowledged = ref(false)
/** anchor 的当前界面状态与输入绑定。 */
const anchor = computed(() => currentAnchor(props.images))
/** allowedViews 的当前界面状态与输入绑定。 */
@@ -82,22 +79,9 @@ watch(
: 'primary'
referenceImageId.value = ''
prompt.value = ''
const selected =
props.catalog.images.find(item => item.provider === props.profile.imageProvider && item.enabled) ??
props.catalog.images.find(item => item.enabled)
provider.value = selected?.provider ?? ''
generationOptions.value = {
...selected?.defaults,
...(selected?.provider === props.profile.imageProvider ? props.profile.imageOptions : {})
}
const sizeSchema = selected?.generationOptions.find(item => item.key === 'size')
if (
sizeSchema?.options?.length &&
!sizeSchema.options.some(option => option.value === generationOptions.value.size)
) {
generationOptions.value.size = selected?.defaults.size ?? sizeSchema.options[0]?.value ?? ''
}
acknowledged.value = false
const defaults = imageGenerationDefaults(props.catalog, props.profile)
provider.value = defaults.provider
generationOptions.value = defaults.options
},
{ immediate: true }
)
@@ -118,69 +102,26 @@ const generationInput = computed<GenerateIdentityImageInput>(() => ({
provider: provider.value,
generationOptions: { ...compatibleOptions.value }
}))
/** 当前参数的预览结果。 */
const preview = ref<IdentityImagePreview | null>(null)
/** 预览读取状态。 */
const previewLoading = ref(false)
/** 道具预览可能付费,保持项目锁直到真实请求结束,不能因关闭弹窗提前释放。 */
const paidPreviewPending = ref(false)
/** 预览读取错误。 */
const previewError = ref('')
/** 用于取消迟到预览的请求控制器。 */
let previewController: AbortController | undefined
/** 参数、主体或弹窗变化时清除旧结果和费用确认。 */
/** 监听界面目标变化并重置关联确认状态。 */
watch(
() => [props.subjectId, open.value, JSON.stringify(generationInput.value), JSON.stringify(props.images)],
() => {
previewController?.abort()
preview.value = null
previewError.value = ''
previewLoading.value = false
acknowledged.value = false
}
)
/** 卸载时取消未完成的只读请求。 */
onBeforeUnmount(() => previewController?.abort())
/** 读取当前参数的真实预览;道具后端可能编译结构模型,禁止当作免费读取。 */
async function loadPreview() {
if (props.disabled || !valid.value || previewLoading.value || paidPreviewPending.value) return
previewController?.abort()
const controller = new AbortController()
previewController = controller
const subjectId = props.subjectId
const projectId = props.profile.projectId
const paid = props.module === 'prop'
const input = { ...generationInput.value, generationOptions: { ...generationInput.value.generationOptions } }
previewLoading.value = true
previewError.value = ''
paidPreviewPending.value = paid
/** 道具请求不传取消信号,取消客户端展示不能取消后端结构模型的工作。 */
const inspect = async () => {
const result = await subjectIdentityApi.previewImage(subjectId, input, paid ? undefined : controller.signal)
if (!controller.signal.aborted && previewController === controller && subjectId === props.subjectId)
preview.value = result
}
try {
if (paid) {
const ok = await runOperation(projectId, '预览道具结构输入', inspect)
if (!ok && !controller.signal.aborted && subjectId === props.subjectId)
previewError.value = getOperation(projectId).error
} else await inspect()
} catch (error) {
if (!controller.signal.aborted)
previewError.value = error instanceof Error ? error.message : '身份输入预览读取失败'
} finally {
paidPreviewPending.value = false
if (previewController === controller) previewLoading.value = false
}
}
/** 提交生图参数;省略空参考 ID 以保留后端自动选择逻辑。 */
function submit() {
if (props.disabled || paidPreviewPending.value || !valid.value || !acknowledged.value) return
emit('generate', generationInput.value)
}
/** 三类生图共用预览版本和确认失效保护,预览本身不收费。 */
const {
preview,
acknowledged,
loading: previewLoading,
submitting,
error: previewError,
staleNotice,
canSubmit,
loadPreview,
submit
} = useImageGenerationPreview({
open,
target: () =>
JSON.stringify([props.subjectId, props.images.filter(image => image.status === 'completed'), props.profile]),
input: () => generationInput.value,
disabled: () => props.disabled || !valid.value,
load: (input, signal) => subjectIdentityApi.previewImage(props.subjectId, input, signal),
generate: input => props.submitGeneration(input)
})
/** formModel 的当前界面状态与输入绑定。 */
const formModel = computed(() => ({
prompt: prompt.value,
@@ -197,12 +138,12 @@ const rules = {
</script>
<template>
<AppDialog v-model:open="open" title="生成身份参考图" :description="subjectName" :busy="paidPreviewPending">
<AppDrawer v-model:open="open" title="生成身份参考图" :description="subjectName" :busy="submitting">
<AppForm
ref="formRef"
:model="formModel"
:rules="rules"
:disabled="disabled"
:disabled="disabled || submitting"
:reset-key="`${open}:${subjectId}`"
validate-on-change
class="dialog-form-stack"
@@ -210,7 +151,7 @@ const rules = {
>
<ContextNotice type="info" :show-icon="false" class="text-xs">
调用
图片模型,每次新增一张图片,可能产生费用。第一张成功的主视图会成为标准参考图;已经有标准参考图时,新主视图只作为候选保留。
图片模型,每次新增一张图片,可能产生费用。新图片只作为候选保留,质量审核通过并由你确认后,才能成为身份母版。
</ContextNotice>
<!-- 以下是多视角与已有身份图选择模块,单一选项不显示选择器 -->
<NFormItem
@@ -278,51 +219,32 @@ const rules = {
:provider="provider"
:options="compatibleOptions"
:aspect-ratio="profile.aspectRatio"
:disabled="disabled"
:disabled="disabled || submitting"
@update:provider="provider = $event"
@update:options="generationOptions = $event"
/>
<!-- 以下是真实生图输入预览模块 -->
<ConfirmAction
v-if="module === 'prop'"
label="预览道具真实输入"
description="缺少有效结构缓存时可能调用文本模型并产生费用;不会生成身份图片。确认后读取本次最终参数。"
:disabled="disabled || !valid || previewLoading"
acknowledgement
@confirm="loadPreview"
<ImageGenerationPreview
:preview="preview"
:loading="previewLoading"
:disabled="disabled || submitting || !valid"
:error="previewError"
:stale-notice="staleNotice"
@load="loadPreview"
/>
<NButton v-else :disabled="disabled || !valid" :loading="previewLoading" @click="loadPreview"
>预览本次真实输入</NButton
>
<FeedbackMessage v-if="previewError" :message="previewError" />
<div v-if="preview" class="text-xs space-y-3">
<p>实际供应方:{{ preview.provider }} · 模型:{{ preview.model }}</p>
<p class="whitespace-pre-wrap">最终提示词:{{ preview.providerPrompt }}</p>
<RawDataDetails
:value="{
referenceImages: preview.referenceImages,
referencePlan: preview.referencePlan,
generationConfig: preview.generationConfig
}"
title="参考图与生成设置(高级)"
/>
</div>
<NCheckbox
id="identity-image-cost"
v-model:checked="acknowledged"
:disabled="!preview || submitting"
class="flex items-start gap-2 text-xs leading-6"
>我已确认后台没有同项目任务,了解本次会调用模型并可能产生费用。</NCheckbox
>我已核对本次预览,确认调用图片模型产生的费用。</NCheckbox
>
</AppForm>
<template #footer>
<NButton @click="open = false">取消</NButton
><NButton
:disabled="disabled || paidPreviewPending || !valid || !acknowledged"
type="primary"
@click="formRef?.validate(submit)"
>
<NButton :disabled="submitting" @click="open = false">取消</NButton
><NButton :disabled="!canSubmit" :loading="submitting" type="primary" @click="formRef?.validate(submit)">
确认生成身份图
</NButton>
</template>
</AppDialog>
</AppDrawer>
</template>
+21 -38
View File
@@ -1,4 +1,6 @@
import type { SubjectImageStatus, SubjectFormAsset } from '../subject-images/types'
import type { ImageGenerationPreview } from '../subject-images/generation-preview'
import type { ImageValidationResult } from '../subject-images/validation'
/** 只有 primary 视图可以选为身份母版,其余视图是辅助参考。 */
export type IdentityViewType = 'primary' | 'front' | 'three-quarter' | 'full-body'
@@ -62,19 +64,31 @@ export type SaveIdentityInput = Partial<Pick<SubjectIdentity, 'description' | 'g
/** 单张身份生图;空 referenceImageId 应省略,由后端自动引用当前母版。 */
export interface GenerateIdentityImageInput {
/** 本次参考视角。 */
viewType: IdentityViewType
/** 用户显式选择的同主体参考图。 */
referenceImageId?: string
/** 是否使用当前母版,选角预览固定为 false。 */
useAnchorReference?: boolean
/** 用户核对的来源与输入版本。 */
expectedPreviewFingerprint?: string
/** 本次可选宽度。 */
width?: number
/** 本次可选高度。 */
height?: number
/** 本次完整画面描述。 */
prompt?: string
/** 本次图片供应方。 */
provider?: string
/** 模型支持的动态参数。 */
generationOptions?: Record<string, string | number | boolean>
}
/** Character 选角候选固定独立生成 primary,不复用旧 Anchor,也不会自动成为新 Anchor。 */
export interface GenerateCastingCandidateInput {
prompt?: string
provider?: string
generationOptions?: Record<string, string | number | boolean>
}
export type GenerateCastingCandidateInput = Omit<
GenerateIdentityImageInput,
'viewType' | 'referenceImageId' | 'useAnchorReference'
>
/** 身份文本批量生成回执,不代表已生成参考图。 */
export interface IdentityBatchResult {
@@ -189,41 +203,10 @@ export type IdentityReceipt =
| { kind: 'stable-anchors'; title: string; result: StableAnchorBatchResult }
/** 最终身份图片 Provider 输入,直接对应身份预览接口。 */
export interface IdentityImagePreview {
/** 实际供应方。 */
provider: string
/** 实际模型。 */
model: string
/** 最终提示词。 */
providerPrompt: string
/** 实际引用图片地址。 */
referenceImages: string[]
/** 后端参考图选择计划。 */
referencePlan: Record<string, unknown>
/** 后端解析后的生成配置。 */
generationConfig: Record<string, unknown>
}
export type IdentityImagePreview = ImageGenerationPreview
/** 指定身份图片的视觉校验回执。 */
export interface IdentityValidationResult {
/** 正式主体 ID。 */
subjectId: string
/** 被校验的图片 ID。 */
imageId: string
/** 是否通过本次校验。 */
passed: boolean
/** 校验总结。 */
summary: string
/** 具体问题。 */
issues: Array<{
/** 问题类型。 */
type: string
/** 严重程度。 */
severity: string
/** 问题描述。 */
description: string
}>
}
export type IdentityValidationResult = ImageValidationResult
/** 有限预算的单主体稳定母版生成参数。 */
export interface StableAnchorQualityInput {
@@ -1,3 +1,5 @@
import { imageValidationPassed } from '../subject-images/validation'
import type { ImageGenerationSubmission } from '../subject-images/generation-preview'
import { computed, ref, shallowRef, watch } from 'vue'
import { usePolling } from '../../composables/usePolling'
import { visualStyleApi } from '../visual-style'
@@ -5,7 +7,7 @@ import { useProjectGenerationRevision } from '../generation-config/context'
import { generationConfigApi } from '../generation-config/api'
import { subjectImagesApi } from '../subject-images/api'
import { hasRunningImages } from '../subject-images/model'
import { batchResultNotice, runOperation, type OperationNotice } from '../workflows/operations'
import { batchResultNotice, getOperation, runOperation, type OperationNotice } from '../workflows/operations'
import { useProjectMutationGuard } from '../workflows/useProjectMutationGuard'
import { useProjectContext } from '../projects/context'
import { subjectIdentityApi } from './api'
@@ -207,6 +209,18 @@ export function useSubjectIdentity() {
const validationResults = ref<Record<string, IdentityValidationResult>>({})
/** 质量闭环结果以正式主体 ID 保存。 */
const qualityResults = ref<Record<string, StableAnchorQualityResult>>({})
/** 审核只适用于本次主体、身份版本和图片输入。 */
const validationSourceKey = computed(() =>
JSON.stringify([projectId.value, selectedId.value, identity.value, images.value])
)
/** 来源变化或切换主体后清除旧审核展示,不能沿用历史通过。 */
watch(
validationSourceKey,
() => {
delete validationResults.value[selectedId.value]
},
{ flush: 'sync' }
)
/** 当前主体的指定图片校验结果。 */
const validationResult = computed(() => validationResults.value[selectedId.value] ?? null)
/** 当前主体的质量闭环回执。 */
@@ -261,6 +275,7 @@ export function useSubjectIdentity() {
const id = subject.value.id
const name = subject.value.name
delete validationResults.value[id]
const sourceKey = validationSourceKey.value
await runImageOperation(
'validate',
imageId,
@@ -269,12 +284,12 @@ export function useSubjectIdentity() {
const result = await subjectIdentityApi.validateImage(id, imageId)
if (result.subjectId !== id || result.imageId !== imageId)
throw new Error('身份校验回执与提交目标不匹配')
validationResults.value[id] = result
if (validationSourceKey.value === sourceKey) validationResults.value[id] = result
return result
},
result => ({
type: result.passed ? 'success' : 'warning',
content: `${name} 的身份图片校验${result.passed ? '通过' : '未通过'}:${result.summary}`
type: imageValidationPassed(result) ? 'success' : 'warning',
content: `${name} 的身份图片校验${imageValidationPassed(result) ? '通过' : '未通过或待复核'}:${result.summary}`
})
)
}
@@ -478,26 +493,25 @@ export function useSubjectIdentity() {
/**
* 生图不修改文字锁定;即使有自定义提示词,也需已有身份提示词与项目风格。
* @param input 已确认的视图、模型与参考图片参数
* @param onSubmitStarted 通过前置检查并开始提交时的回调
* @returns 任务创建结果及原始错误
*/
async function generateImage(input: GenerateIdentityImageInput, onSubmitStarted?: () => void) {
if (!canGenerateImage.value || !subject.value || !identity.value) return
async function generateImage(input: GenerateIdentityImageInput): Promise<ImageGenerationSubmission> {
if (!canGenerateImage.value || !subject.value || !identity.value) return { accepted: false }
if (
input.referenceImageId &&
!images.value.some(
image => image.id === input.referenceImageId && image.status === 'completed' && image.imageUrl
)
)
return
return { accepted: false }
const id = subject.value.id
const identityId = identity.value.id
const project = projectId.value
const name = subject.value.name
await runOperation(
const accepted = await runOperation(
project,
`提交 ${name} 身份参考图生成`,
async () => {
onSubmitStarted?.()
const started = await subjectIdentityApi.generateImage(id, input)
const image = started?.image
if (
@@ -521,24 +535,24 @@ export function useSubjectIdentity() {
},
{ type: 'info', content: `${name} 的身份参考图已提交生成,完成后会显示结果。` }
)
return { accepted, cause: getOperation(project).cause }
}
/**
* 单角色候选图固定独立生成,不复用旧母版,生成成功后仍需人工确认选角。
* @param input 已确认的候选图模型与生成参数
* @param onSubmitStarted 通过前置检查并开始提交时的回调
* @returns 任务创建结果及原始错误
*/
async function generateCastingCandidate(input: GenerateCastingCandidateInput, onSubmitStarted?: () => void) {
if (!canGenerateCandidate.value || !subject.value || !identity.value) return
async function generateCastingCandidate(input: GenerateCastingCandidateInput): Promise<ImageGenerationSubmission> {
if (!canGenerateCandidate.value || !subject.value || !identity.value) return { accepted: false }
const id = subject.value.id
const identityId = identity.value.id
const project = projectId.value
const name = subject.value.name
await runOperation(
const accepted = await runOperation(
project,
`提交 ${name} 角色候选图生成`,
async () => {
onSubmitStarted?.()
const image = await subjectIdentityApi.generateCastingCandidate(id, input)
if (!image || image.identityId !== identityId || !['pending', 'generating'].includes(image.status)) {
throw new Error(image?.error || '选角候选任务未成功创建,请刷新后重试。')
@@ -552,6 +566,7 @@ export function useSubjectIdentity() {
},
{ type: 'info', content: `${name} 的角色候选图已提交生成,完成后会显示结果。` }
)
return { accepted, cause: getOperation(project).cause }
}
/**
@@ -14,14 +14,25 @@ import WorkspaceTools from '../../components/ui/WorkspaceTools.vue'
import { NButton, NCheckbox, NInput, NInputNumber, NPopover, NScrollbar, NSelect, NTag } from 'naive-ui'
import { computed, onScopeDispose, ref, watch, type Directive } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { Search, Download, ImagePlus, ArrowLeft, LayoutGrid, Columns3, LoaderCircle, Settings2 } from '@lucide/vue'
import {
Search,
Download,
ImagePlus,
ArrowLeft,
LayoutGrid,
Columns3,
LoaderCircle,
Settings2,
ClipboardCheck
} from '@lucide/vue'
import { AssetImage, EmptyState, StatusBadge } from '../../components/ui'
import { downloadText } from '../../lib/format'
import ConfirmAction from '../workflows/ConfirmAction.vue'
import { useSubjectImages } from './useSubjectImages'
import { hasRunningImages, primaryImage, isIdentityAnchorReuse } from './model'
import type { GenerateFormImageInput, SubjectFormAsset } from './types'
import type { SubjectFormAsset } from './types'
import GenerateImageDialog from './components/GenerateImageDialog.vue'
import ImagePreparationDrawer from './components/ImagePreparationDrawer.vue'
import ImageGalleryDialog from './components/ImageGalleryDialog.vue'
import FormPromptDialog from './components/FormPromptDialog.vue'
import FormPromptBatch from './components/FormPromptBatch.vue'
@@ -107,6 +118,8 @@ const impactOptions = computed(() => {
}))
})
const toolsOpen = ref(false)
/** 免费检查图片阶段规格和母版依赖。 */
const preparationOpen = ref(false)
/** 移动端禁用纯图标按钮的悬浮说明,避免触摸操作弹出多余浮层。 */
const isMobile = ref(false)
if (typeof window !== 'undefined') {
@@ -262,10 +275,6 @@ function openGallery(form: SubjectFormAsset) {
galleryId.value = form.id
galleryOpen.value = true
}
/** 本次提交的 ID 和配置由弹窗固定,关闭弹窗不会取消制作任务。 */
function submitGenerate(formId: string, input: GenerateFormImageInput) {
void generate(formId, input)
}
/** 导出真实批量回执供排障,不构造成功图片地址。 */
function exportReceipt() {
downloadText('subject-images-receipt.json', JSON.stringify(session.value.receipt, null, 2), 'application/json')
@@ -316,7 +325,7 @@ const rules = { concurrency: integerRule('批量并发'), limit: integerRule('
</div>
</div>
<DetailDisclosure title="母版继承与过期处理" class="mt-4">
人物、场景、道具的基础形态默认复用已确认并锁定的身份母版,无需再次生图。其他形态仍需单独生成。自动复用的主图随母版更新;你手选或独立生成的主图保留,母版变化后需要核对。
基础形态可复用已确认并锁定的身份母版,其他形态仍需单独生成。浏览图库不会补建或切换主图;母版变化后,已有图片保留并需重新核对来源与质量。
</DetailDisclosure>
<FormPromptBatch
:generating="isOperationRunning(operation, '批量生成形态正式提示词')"
@@ -351,7 +360,7 @@ const rules = { concurrency: integerRule('批量并发'), limit: integerRule('
</p>
</div>
<p class="mt-2 text-[11px] leading-6 text-muted">
图库在进入和操作完成后读取最新记录。基础形态会自动复用已锁定身份母版,主图可直接供分镜引用;独立候选与历史失败记录均保留。
图库仅查看已保存的图片。已有主图仍须通过当前来源和质量检查,才能用于后续分镜;独立候选与历史失败记录均保留。
</p>
<section class="mt-4 pt-4">
<h3 class="text-sm font-semibold">项目批量生图</h3>
@@ -581,6 +590,18 @@ const rules = { concurrency: integerRule('批量并发'), limit: integerRule('
<span class="filter-result-count">{{ filtered.length }} 个形态</span>
<!-- 四个纯图标按钮使用统一间距;桌面端通过 Popover 解释用途。 -->
<div class="gallery-layout-switch" role="group" aria-label="图库视图与操作">
<!-- 以下是图片阶段免费准备检查入口 -->
<NPopover trigger="hover" placement="top" :disabled="preparationOpen">
<template #trigger
><NButton
class="icon-button"
size="small"
aria-label="图片准备检查"
@click="preparationOpen = true"
><template #icon><ClipboardCheck :size="16" /></template></NButton
></template>
图片准备检查
</NPopover>
<NPopover trigger="hover" placement="top" :disabled="isMobile">
<template #trigger>
<NButton
@@ -734,7 +755,7 @@ const rules = { concurrency: integerRule('批量并发'), limit: integerRule('
: form.images.some(image => image.status === 'completed' && image.imageUrl)
? '已有候选图,请确认主参考图'
: form.isDefault
? '确认并锁定身份母版后自动复用'
? '请先确认并锁定身份母版'
: '尚未生成主参考图'
"
/>
@@ -842,13 +863,15 @@ const rules = { concurrency: integerRule('批量并发'), limit: integerRule('
:catalog="generationModelsQuery.data.value"
:profile="profileQuery.data.value.profile"
:disabled="blocked || !generateForm || hasRunningImages(generateForm.images)"
@generate="submitGenerate" /><ImageGalleryDialog
:submit-generation="generate" /><ImageGalleryDialog
v-model:open="galleryOpen"
:project-id="id"
:form="galleryForm"
:disabled="blocked || !galleryForm"
@changed="refreshAssets" /></template
></WorkspacePage>
<!-- 以下是免费图片准备计划全屏模块 -->
<ImagePreparationDrawer v-model:open="preparationOpen" :project-id="id" />
</template>
<style>
+58 -5
View File
@@ -1,6 +1,9 @@
import { request } from '../../lib/http'
import type { ImageValidationResult } from './validation'
import type {
GenerateFormImageInput,
FormImageQualityInput,
FormImageQualityResult,
GenerateProjectImagesInput,
GenerateFormPromptsInput,
FormPromptResult,
@@ -17,6 +20,16 @@ function formPath(id: string) {
/** 形态图库 API:读取与生成分离,生成不自动重试,不设置客户端短超时。 */
export const subjectImagesApi = {
/**
* 显式准备道具结构规格,可能调用文字模型,不生成图片。
* @param formId 正式形态编号
* @returns 当前结构规格,页面随后重新读取正式准备状态
*/
prepareStructure: (formId: string) =>
request<Record<string, unknown>>(`/subject-forms/${encodeURIComponent(formId)}/prop-structure-spec/generate`, {
method: 'POST',
timeoutMs: 0
}),
/** 生成并保存正式生图提示词;force 仅覆盖提示词,不生成或替换图片。 */
generatePrompt: (formId: string, force: boolean) =>
request<FormPromptResult | null>(`/subject-forms/${encodeURIComponent(formId)}/generation-prompt`, {
@@ -34,10 +47,41 @@ export const subjectImagesApi = {
listForms: (projectId: string, signal?: AbortSignal) =>
request<SubjectFormAsset[]>(`/projects/${encodeURIComponent(projectId)}/subject-forms`, { signal }),
listImages: (formId: string, signal?: AbortSignal) => request<SubjectImage[]>(formPath(formId), { signal }),
/** 解析正式 Prompt、参考图顺序与后端生成配置,不创建图片任务。 */
/** 预览与本次生成使用相同的提示词、模型和参数。 */
preview: (formId: string, input: Pick<GenerateFormImageInput, 'prompt' | 'provider' | 'generationOptions'> = {}) =>
request<SubjectImageGenerationPreview>(`${formPath(formId)}/preview`, { method: 'POST', body: input }),
/**
* 用户确认费用后审核指定候选,不自动切换主图。
* @param formId 正式形态编号
* @param imageId 本形态的图片编号
* @returns 本次结构化审核与原始定义证据
*/
validate: (formId: string, imageId: string) =>
request<ImageValidationResult>(`${formPath(formId)}/${encodeURIComponent(imageId)}/validate`, {
method: 'POST',
timeoutMs: 0
}),
/**
* 按用户明确预算审核并修复已有候选,通过后才晋升主图。
* @param formId 正式形态编号
* @param input 候选、供应方与有限修复次数
* @returns 各轮候选和主图变化的真实回执
*/
generateQuality: (formId: string, input: FormImageQualityInput) =>
request<FormImageQualityResult>(`${formPath(formId)}/generate-quality`, {
method: 'POST',
body: input,
timeoutMs: 0
}),
/**
* 只读编译当前已有资料,不自动补齐描述或规格。
* @param formId 正式形态编号
* @param input 本次生成参数
* @param signal 取消过期预览
* @returns 绑定来源版本的实际输入
*/
preview: (
formId: string,
input: Omit<GenerateFormImageInput, 'setPrimary' | 'expectedPreviewFingerprint'> = {},
signal?: AbortSignal
) => request<SubjectImageGenerationPreview>(`${formPath(formId)}/preview`, { method: 'POST', body: input, signal }),
generate: (formId: string, input: GenerateFormImageInput) =>
request<SubjectImage | null>(formPath(formId), { method: 'POST', body: input, timeoutMs: 0 }),
generateProject: (projectId: string, input: GenerateProjectImagesInput) =>
@@ -46,6 +90,15 @@ export const subjectImagesApi = {
body: input,
timeoutMs: 0
}),
/**
* 当前质量和来源检查通过后切换主图,不提前乐观更新。
* @param formId 正式形态编号
* @param imageId 当前候选编号
* @returns 已确认的正式主图
*/
setPrimary: (formId: string, imageId: string) =>
request<SubjectImage | null>(`${formPath(formId)}/${encodeURIComponent(imageId)}/primary`, { method: 'PUT' })
request<SubjectImage | null>(`${formPath(formId)}/${encodeURIComponent(imageId)}/primary`, {
method: 'PUT',
timeoutMs: 0
})
}
@@ -1,225 +1,146 @@
<script setup lang="ts">
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import AppForm from '../../../components/ui/AppForm.vue'
import { NFormItem } from 'naive-ui'
import { NButton, NCheckbox, NCollapse, NCollapseItem, NInput, NTag } from 'naive-ui'
import { imageGenerationDefaults } from '../../generation-config/image-defaults'
import { NButton, NCheckbox, NCollapse, NCollapseItem, NFormItem, NInput } from 'naive-ui'
import { computed, ref, watch } from 'vue'
import { AppDialog } from '../../../components/ui'
import { errorMessage } from '../../../lib/http'
import { subjectImagesApi } from '../api'
import { AppDrawer } from '../../../components/ui'
import AppForm from '../../../components/ui/AppForm.vue'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import GenerationModelControls from '../../generation-config/components/GenerationModelControls.vue'
import type { CreativeProfile, GenerationModelCatalog, GenerationOptions } from '../../generation-config/types'
import { subjectImagesApi } from '../api'
import { useImageGenerationPreview, type ImageGenerationSubmission } from '../generation-preview'
import { primaryImage } from '../model'
import type { GenerateFormImageInput, SubjectFormAsset, SubjectImageGenerationPreview } from '../types'
import type { GenerateFormImageInput, SubjectFormAsset } from '../types'
import ImageGenerationPreview from './ImageGenerationPreview.vue'
/** 单形态生成确认:尺寸与自定义 Prompt 只用于本次请求。 */
/** 单形态生图先核对最终输入,再明确提交一次。 */
const props = defineProps<{
/** 当前正式形态。 */
form: SubjectFormAsset | null
/** 项目或图片任务锁。 */
disabled: boolean
/** 模型参数目录。 */
catalog: GenerationModelCatalog
/** 项目默认配置。 */
profile: CreativeProfile
/** 提交固定形态与预览版本,返回任务是否已创建。 */
submitGeneration: (formId: string, input: GenerateFormImageInput) => Promise<ImageGenerationSubmission>
}>()
/** 全屏表单开关。 */
const open = defineModel<boolean>('open', { default: false })
const emit = defineEmits<{ generate: [formId: string, input: GenerateFormImageInput] }>()
const formRef = ref<InstanceType<typeof AppForm> | null>(null)
/** 仅本次使用的完整描述。 */
const prompt = ref('')
/** 当前图片供应方。 */
const provider = ref('')
/** 当前模型动态参数。 */
const generationOptions = ref<GenerationOptions>({})
/** 明确选择质量通过后切换主图,默认只保留候选。 */
const setPrimary = ref(false)
const acknowledged = ref(false)
const preview = ref<SubjectImageGenerationPreview | null>(null)
const previewError = ref('')
const previewPending = ref(false)
/** 预览与当前形态、提示词及模型配置绑定,避免显示过期结果。 */
const previewKey = computed(() =>
JSON.stringify([props.form?.id, prompt.value, provider.value, generationOptions.value])
)
watch(previewKey, () => {
preview.value = null
previewError.value = ''
})
/** 每次打开重新建立表单,避免把另一形态的 Prompt 或尺寸带入请求。 */
/** 预览与生成共用同一份输入。 */
const generationInput = computed<GenerateFormImageInput>(() => ({
...(prompt.value.trim() ? { prompt: prompt.value.trim() } : {}),
provider: provider.value,
generationOptions: { ...generationOptions.value },
setPrimary: setPrimary.value
}))
/** 表单模型用于统一禁用与间距。 */
const formModel = computed(() => ({ prompt: prompt.value }))
/** 目标、参数与可见周期变化后废弃旧确认。 */
const { preview, acknowledged, loading, submitting, error, staleNotice, canSubmit, loadPreview, submit } =
useImageGenerationPreview({
open,
target: () =>
JSON.stringify([props.form?.id, props.form?.generationPrompt, props.form?.subject.identity, props.profile]),
input: () => generationInput.value,
disabled: () => props.disabled || !props.form || !provider.value,
load: async (input, signal) => {
const formId = props.form!.id
const { setPrimary: _setPrimary, ...previewInput } = input
const result = await subjectImagesApi.preview(formId, previewInput, signal)
if (result.subjectFormId !== formId) throw new Error('预览结果与当前形态不匹配,请重新读取。')
return result
},
generate: input => props.submitGeneration(props.form!.id, input)
})
/** 每次打开恢复项目配置,不沿用其它形态的草稿。 */
watch(
() => [open.value, props.form?.id],
() => {
prompt.value = ''
const selected =
props.catalog.images.find(item => item.provider === props.profile.imageProvider && item.enabled) ??
props.catalog.images.find(item => item.enabled)
provider.value = selected?.provider ?? ''
generationOptions.value = {
...selected?.defaults,
...(selected?.provider === props.profile.imageProvider ? props.profile.imageOptions : {})
}
const sizeSchema = selected?.generationOptions.find(item => item.key === 'size')
if (
sizeSchema?.options?.length &&
!sizeSchema.options.some(option => option.value === generationOptions.value.size)
) {
generationOptions.value.size = selected?.defaults.size ?? sizeSchema.options[0]?.value ?? ''
}
acknowledged.value = false
preview.value = null
previewError.value = ''
previewPending.value = false
setPrimary.value = props.form ? !primaryImage(props.form.images) : false
const defaults = imageGenerationDefaults(props.catalog, props.profile)
provider.value = defaults.provider
generationOptions.value = defaults.options
setPrimary.value = false
},
{ immediate: true }
)
/** 预览由后端按当前正式配置编译,不提交图片生成任务。 */
async function loadPreview() {
if (!props.form || previewPending.value) return
previewPending.value = true
previewError.value = ''
const requestKey = previewKey.value
try {
const result = await subjectImagesApi.preview(props.form.id, {
...(prompt.value.trim() ? { prompt: prompt.value.trim() } : {}),
provider: provider.value,
generationOptions: generationOptions.value
})
if (requestKey !== previewKey.value || !open.value) return
if (!result || result.subjectFormId !== props.form.id) throw new Error('预览结果与当前形态不匹配。')
preview.value = result
} catch (cause) {
if (requestKey === previewKey.value && open.value) {
preview.value = null
previewError.value = errorMessage(cause)
}
} finally {
previewPending.value = false
}
}
/** 完成前置确认后只发出一次明确的生图请求,不触发整条生产流程。 */
function submit() {
if (!props.form || props.disabled || !provider.value || !acknowledged.value) return
emit('generate', props.form.id, {
setPrimary: setPrimary.value,
...(prompt.value.trim() ? { prompt: prompt.value.trim() } : {}),
provider: provider.value,
generationOptions: generationOptions.value
})
open.value = false
}
const formModel = computed(() => ({ prompt: prompt.value }))
const rules = {}
</script>
<template>
<!-- 以下是宽版形态图片生成弹窗模块,长提示词与模型参数保留完整空间 -->
<AppDialog
<!-- 以下是生成配置与实际输入核对模块,正文独立滚动,操作固定在底栏 -->
<AppDrawer
v-model:open="open"
title="生成形态图片"
wide
:description="`${form?.subject.name || ''} · ${form?.name || ''}`"
:busy="submitting"
>
<AppForm
ref="formRef"
:model="formModel"
:rules="rules"
:disabled="disabled"
:reset-key="`${open}:${form?.id}`"
validate-on-change
class="dialog-form-stack"
@submit="submit"
>
<ContextNotice type="info" :show-icon="false" class="text-xs"
>使用当前配置的图片模型生成一张新图,可能产生费用。已有图片会保留。</ContextNotice
<AppForm :model="formModel" :disabled="disabled || submitting" class="dialog-form-stack" @submit="submit">
<ContextNotice type="info" :show-icon="false"
>新增图片可能产生费用,已有图片会保留。图片生成完成后仍需质量审核。</ContextNotice
>
<p class="text-xs leading-6 text-muted">
基础形态默认复用已确认并锁定的身份母版,无需重复生成。此处会调用图片模型新增独立候选,用于不同形态或需要调整外观的情况;是否替换主图由下方选项决定。
</p>
<div class="flex flex-wrap items-center gap-3">
<NButton :loading="previewPending" :disabled="!form" @click="loadPreview">预览实际生成输入</NButton>
<span class="text-xs text-muted">只查看本次生成图片会用到的参考图和描述,不生成图片。</span>
</div>
<ContextNotice v-if="previewError" type="error" :show-icon="false">{{ previewError }}</ContextNotice>
<div v-if="preview" class="dialog-result-card text-xs leading-6">
<div class="flex flex-wrap items-center gap-2">
<strong>{{ preview.provider }} / {{ preview.model }}</strong>
<NTag size="small" :bordered="false">{{ preview.references.length }} 张参考图</NTag>
</div>
<ul v-if="preview.references.length" class="mt-3 space-y-1 text-muted">
<li v-for="item in preview.references" :key="`${item.imageNumber}:${item.imageId}`">
图 {{ item.imageNumber }} · {{ item.role }} · <code>{{ item.imageId }}</code>
</li>
</ul>
<p v-else class="mt-3 text-muted">本次没有图片参考。</p>
<NCollapse class="mt-3" :default-expanded-names="['prompt']">
<NCollapseItem name="prompt" title="本次实际使用的画面描述">
<p class="mt-3 whitespace-pre-wrap">{{ preview.providerPrompt }}</p>
</NCollapseItem>
<NCollapseItem name="config" title="生成配置">
<pre class="mt-3 whitespace-pre-wrap">{{
JSON.stringify(preview.generationConfig, null, 2)
}}</pre>
</NCollapseItem>
</NCollapse>
</div>
<NFormItem
class="block"
path="prompt"
label="自定义提示词(可选,仅用于本次)"
:label-props="{ for: 'image-prompt' }"
><NInput
placeholder="可留空使用已保存的画面描述;尚未准备时会先自动补齐。"
<NFormItem label="自定义画面描述(可选,仅用于本次)" :label-props="{ for: 'image-prompt' }">
<NInput
:input-props="{ id: 'image-prompt' }"
class="min-h-28"
v-model:value="prompt"
type="textarea"
:disabled="submitting"
:autosize="{ minRows: 3, maxRows: 12 }"
></NInput>
placeholder="留空使用已保存的画面描述;缺少资料时请先准备,再读取预览。"
/>
</NFormItem>
<NCollapse
v-if="form?.generationPrompt || form?.appearancePrompt"
class="text-xs"
:default-expanded-names="['details']"
><NCollapseItem name="details"
><template #header>{{
form?.generationPrompt ? '查看正式生图提示词' : '查看原始外观素材(不是最终提示词)'
}}</template>
<p class="mt-3 whitespace-pre-wrap leading-6">
<NCollapse v-if="form?.generationPrompt || form?.appearancePrompt">
<NCollapseItem
name="saved"
:title="form?.generationPrompt ? '查看已保存的画面描述' : '查看原始外观说明'"
>
<p class="whitespace-pre-wrap wrap-anywhere text-xs leading-6">
{{ form.generationPrompt ?? form.appearancePrompt }}
</p></NCollapseItem
></NCollapse
>
</p>
</NCollapseItem>
</NCollapse>
<GenerationModelControls
type="image"
:catalog="catalog"
:provider="provider"
:options="generationOptions"
:aspect-ratio="profile.aspectRatio"
:disabled="disabled"
:disabled="disabled || submitting"
@update:provider="provider = $event"
@update:options="generationOptions = $event"
/>
<p v-if="!form?.generationPrompt" class="text-xs leading-6 text-muted">
未填写自定义描述时,会先整理画面描述,再生成图片;这两个步骤都可能产生费用。角色的原始外观说明会先整理后使用。
<!-- 以下是主图切换选择模块,生成完成不等于审核通过 -->
<NCheckbox v-model:checked="setPrimary" :disabled="submitting">生成并通过质量审核后设为主参考图</NCheckbox>
<p v-if="setPrimary" class="text-xs leading-6 text-muted">
会调用视觉审核并可能产生额外费用。{{
form && primaryImage(form.images) ? '审核未通过时保留旧主图。' : '审核未通过时仅保留候选图。'
}}不会自动重试或追加生图。
</p>
<NCheckbox v-model:checked="setPrimary" class="flex gap-2 text-sm">生成成功后设为此形态主参考图</NCheckbox>
<p v-if="setPrimary && form && primaryImage(form.images)" class="text-xs text-muted">
会替换当前主图标记,旧图片保留。已有视频提示词不会自动更新。
</p>
<NCheckbox
id="confirm-image-cost"
v-model:checked="acknowledged"
class="flex items-start gap-2 text-xs leading-6"
>我已确认后台没有同项目的生成任务,了解本次会调用模型并产生费用。</NCheckbox
<!-- 以下是与当前参数绑定的只读预览及费用确认模块 -->
<ImageGenerationPreview
:preview="preview"
:loading="loading"
:disabled="disabled || submitting || !form || !provider"
:error="error"
:stale-notice="staleNotice"
@load="loadPreview"
/>
<NCheckbox id="confirm-image-cost" v-model:checked="acknowledged" :disabled="!preview || submitting"
>我已核对本次预览和主图选项,确认模型费用。</NCheckbox
>
</AppForm>
<template #footer>
<NButton @click="open = false">取消</NButton
><NButton
:disabled="disabled || !form || !provider || !acknowledged"
type="primary"
@click="formRef?.validate(submit)"
>
确认生成图片
</NButton>
<NButton :disabled="submitting" @click="open = false">取消</NButton>
<NButton type="primary" :disabled="!canSubmit" :loading="submitting" @click="submit">确认生成图片</NButton>
</template>
</AppDialog>
</AppDrawer>
</template>
@@ -1,36 +1,59 @@
<script setup lang="ts">
import RawDataDetails from '../../../components/ui/RawDataDetails.vue'
import ImageValidationPanel from './ImageValidationPanel.vue'
import { imageValidationPassed, type ImageValidationResult } from '../validation'
import { errorMessage } from '../../../lib/http'
import { userFacingText } from '../../../lib/user-facing-text'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import { NScrollbar, NButton, NTag } from 'naive-ui'
import { NScrollbar, NButton, NTag, NInputNumber, NCollapse, NCollapseItem } from 'naive-ui'
import { computed, ref, watch } from 'vue'
import { ExternalLink, RefreshCw } from '@lucide/vue'
import { AppDialog, AssetImage, StatusBadge } from '../../../components/ui'
import { ExternalLink, RefreshCw, ShieldCheck, Check, WandSparkles, Eye } from '@lucide/vue'
import { AppDrawer, AssetImage, StatusBadge } from '../../../components/ui'
import { useQuery } from '../../../composables/useQuery'
import { referenceImageUrl } from '../../../lib/assets'
import { formatDate } from '../../../lib/format'
import { getOperation, runOperation } from '../../workflows/operations'
import { subjectImagesApi } from '../api'
import { hasRunningImages, primaryImage, currentIdentityAnchorId, isIdentityAnchorReuse } from '../model'
import type { SubjectFormAsset } from '../types'
import type { SubjectFormAsset, FormImageQualityResult } from '../types'
/** 形态图片历史与主图选择;历史查询只在弹窗打开时进行。 */
const props = defineProps<{ projectId: string; form: SubjectFormAsset | null; disabled: boolean }>()
/** 全屏图库开关。 */
const open = defineModel<boolean>('open', { default: false })
/** 成功保存质量或主图后刷新外部列表。 */
const emit = defineEmits<{ changed: [] }>()
/** 当前查看的图片编号。 */
const selectedId = ref('')
const confirming = ref(false)
/** 当前底栏确认操作,打开图库时不会自动调用审核。 */
const confirming = ref<'primary' | 'validate' | 'quality' | null>(null)
/** 当前请求对应的操作和图片,避免切换时加载状态串到其它图片。 */
const pending = ref<{ kind: 'primary' | 'validate' | 'quality'; imageId: string } | null>(null)
/** 当前选中图片本次审核结果。 */
const validation = ref<ImageValidationResult | null>(null)
/** 当前图库操作失败原因。 */
const actionError = ref('')
/** 修复默认不追加生图,必须由用户明确增加次数。 */
const maxRepairAttempts = ref(0)
/** 有限预算质量流程的真实终态。 */
const qualityResult = ref<FormImageQualityResult | null>(null)
/** 打开周期中的正式形态查询键。 */
const key = computed(() => (open.value ? (props.form?.id ?? '') : ''))
/** 只读图库查询,不补建主图。 */
const query = useQuery(key, async (id, signal) => {
if (!id) return null
const rows = await subjectImagesApi.listImages(id, signal)
if (rows.some(image => image.subjectFormId !== id)) throw new Error('图片记录与当前形态不匹配,请刷新后重试。')
return rows
})
/** 最近读取的正式图片。 */
const images = computed(() => query.data.value ?? [])
/** 当前图片,优先展示主图。 */
const selected = computed(
() => images.value.find(image => image.id === selectedId.value) ?? primaryImage(images.value) ?? images.value[0]
)
/** 项目内的真实活动锁。 */
const operation = computed(() => getOperation(props.projectId))
/** 历史复用图失去当前母版或基础形态条件时只供查看,不能重新设为主图。 */
const reusedImageUnavailable = computed(
@@ -45,58 +68,157 @@ const canSetPrimary = computed(
() =>
!props.disabled &&
!operation.value.pending &&
!pending.value &&
!query.loading.value &&
!query.error.value &&
!hasRunningImages(images.value) &&
selected.value?.status === 'completed' &&
!!selected.value.imageUrl &&
!selected.value.isPrimary &&
selected.value.qualityPassed !== false &&
!selected.value.qualityIssues?.some(issue => issue.severity === 'error') &&
!(validation.value?.imageId === selected.value.id && !imageValidationPassed(validation.value)) &&
!reusedImageUnavailable.value
)
/** 已完成候选允许显式重新审核,即使此前质量未通过。 */
const canValidate = computed(
() =>
!props.disabled &&
!operation.value.pending &&
!pending.value &&
!query.loading.value &&
!query.error.value &&
!hasRunningImages(images.value) &&
selected.value?.status === 'completed' &&
!!selected.value.imageUrl
)
/** 底栏确认只对当前可用操作开放。 */
const canConfirm = computed(() =>
confirming.value === 'primary'
? canSetPrimary.value
: canValidate.value &&
(confirming.value === 'validate' ||
(confirming.value === 'quality' &&
Number.isInteger(maxRepairAttempts.value) &&
maxRepairAttempts.value >= 0 &&
maxRepairAttempts.value <= 3))
)
/** 当前选中图片的公开原图地址。 */
const imageUrl = computed(() => (selected.value?.imageUrl ? referenceImageUrl(selected.value.imageUrl) : null))
watch(key, () => {
selectedId.value = ''
confirming.value = false
confirming.value = null
validation.value = null
actionError.value = ''
maxRepairAttempts.value = 0
qualityResult.value = null
})
watch(
() => selected.value?.id,
() => {
confirming.value = false
confirming.value = null
validation.value = null
actionError.value = ''
maxRepairAttempts.value = 0
qualityResult.value = null
}
)
/** 切换主图只调用 PUT,不调用模型;目标在提交时固定。 */
async function choosePrimary() {
if (!canSetPrimary.value || !confirming.value || !selected.value || !props.form) return
/** 打开有限预算确认,默认不允许追加生图。 */
function requestQuality() {
if (!canValidate.value) return
maxRepairAttempts.value = 0
confirming.value = 'quality'
}
/**
* 仅在用户核对费用后执行审核或主图切换,失败保留原主图。
* @returns 当前请求处理及只读刷新完成
*/
async function confirmAction() {
if (!canConfirm.value || !selected.value || !props.form || !confirming.value) return
const formId = props.form.id
const imageId = selected.value.id
const subjectId = props.form.subjectId
const projectId = props.projectId
confirming.value = false
await runOperation(projectId, `设置 ${props.form.subject.name} · ${props.form.name} 主图`, async () => {
const result = await subjectImagesApi.setPrimary(formId, imageId)
if (
!result ||
result.id !== imageId ||
result.subjectFormId !== formId ||
!result.isPrimary ||
result.status !== 'completed'
)
throw new Error('主图切换结果尚未确认,请先刷新图片列表后核对。')
})
emit('changed')
await query.refresh()
const kind = confirming.value
const provider = selected.value.provider
const budget = maxRepairAttempts.value
const requestKey = key.value
selectedId.value = imageId
pending.value = { kind, imageId }
actionError.value = ''
const ok = await runOperation(
projectId,
`${kind === 'quality' ? '审核与修复' : kind === 'validate' ? '审核' : '设置主图'} · ${props.form.subject.name}`,
async () => {
if (kind === 'quality') {
const result = await subjectImagesApi.generateQuality(formId, {
imageId,
provider,
maxRepairAttempts: budget
})
if (
result.subjectFormId !== formId ||
result.initialImageId !== imageId ||
!result.finalImageId ||
!Array.isArray(result.attempts) ||
result.maxRepairAttempts !== budget
)
throw new Error('质量处理回执不完整,请刷新图库核对。')
if (key.value === requestKey && selected.value?.id === imageId) qualityResult.value = result
return null
}
if (kind === 'validate') {
const result = await subjectImagesApi.validate(formId, imageId)
if (result.imageId !== imageId || result.subjectFormId !== formId || result.subjectId !== subjectId)
throw new Error('审核结果与当前图片不匹配,请刷新后核对。')
if (key.value === requestKey && selected.value?.id === imageId) validation.value = result
return result
}
const result = await subjectImagesApi.setPrimary(formId, imageId)
if (
!result ||
result.id !== imageId ||
result.subjectFormId !== formId ||
!result.isPrimary ||
result.status !== 'completed'
)
throw new Error('主图切换结果尚未确认,请刷新后核对。')
return null
},
result =>
result
? {
type: imageValidationPassed(result) ? 'success' : 'warning',
content: imageValidationPassed(result)
? '本次图片审核通过,尚未切换主图。'
: '本次图片审核未通过或待复核,原主图保留。'
}
: kind === 'quality'
? { type: 'info', content: '质量处理已返回,请核对逐次审核和主图变化。' }
: { type: 'success', content: '主参考图已更新。' }
)
if (key.value === requestKey) {
confirming.value = null
if (!ok) actionError.value = errorMessage(getOperation(projectId).cause)
await query.refresh()
if (ok) emit('changed')
}
pending.value = null
}
</script>
<template>
<AppDialog
<AppDrawer
v-model:open="open"
:title="`${form?.subject.name || ''} · ${form?.name || '形态图片'}`"
description="主参考图会供后续分镜使用。切换主图不会重新生成已有视频提示词。"
wide
:busy="!!pending"
>
<div class="mt-5 flex items-center justify-between">
<div class="flex items-center justify-between gap-3">
<span class="text-xs text-muted">{{ images.length }} 条图片记录</span
><NButton :disabled="query.loading.value" @click="query.refresh" text size="small"
><NButton :disabled="query.loading.value || !!pending" @click="query.refresh" text size="small"
><RefreshCw :size="13" :class="{ 'animate-spin': query.loading.value }" />刷新图片
</NButton>
</div>
@@ -131,6 +253,7 @@ async function choosePrimary() {
:key="image.id"
:aria-label="`查看图片 ${image.id}`"
:aria-pressed="image.id === selected.id"
:disabled="!!pending"
@click="selectedId = image.id"
class="image-history-item"
:class="{ selected: image.id === selected.id }"
@@ -155,8 +278,24 @@ async function choosePrimary() {
>
</NScrollbar>
<div class="mt-4 flex flex-wrap items-center justify-between gap-3">
<div class="flex items-center gap-2">
<StatusBadge :status="selected.status" />
<div class="flex flex-wrap items-center gap-2">
<NTag v-if="selected.status === 'completed'" :bordered="false" size="small">图片已生成</NTag>
<StatusBadge v-else :status="selected.status" />
<NTag
v-if="selected.status === 'completed'"
:bordered="false"
size="small"
:type="selected.qualityPassed === false ? 'error' : 'default'"
>{{
selected.qualityPassed === true
? '最近审核通过'
: selected.qualityPassed === false
? '质量未通过'
: isIdentityAnchorReuse(selected)
? '未单独审核形态'
: '尚未审核'
}}</NTag
>
<!-- 以下是形态图片的真实来源模块 -->
<NTag v-if="isIdentityAnchorReuse(selected)" size="small" :bordered="false">复用身份母版</NTag>
<NTag v-if="selected.isPrimary" size="small" :bordered="false">当前主参考图</NTag
@@ -179,31 +318,146 @@ async function choosePrimary() {
class="mt-3 whitespace-pre-wrap"
>{{ userFacingText(selected.error) }}</ContextNotice
>
<!-- 以下是明确费用的候选审核和主图操作模块 -->
<div class="mt-4 flex flex-wrap items-center gap-3">
<NButton v-if="!selected.isPrimary" :disabled="!canSetPrimary" @click="confirming = true">
设为主参考图</NButton
><span class="text-[11px] text-muted"
<NButton
class="workspace-action-button"
:disabled="!canValidate"
:loading="pending?.kind === 'validate' && pending.imageId === selected.id"
@click="confirming = 'validate'"
><template #icon><ShieldCheck :size="16" /></template>审核此图片</NButton
>
<NButton
v-if="!selected.isPrimary"
class="workspace-action-button"
:disabled="!canSetPrimary"
:loading="pending?.kind === 'primary' && pending.imageId === selected.id"
@click="confirming = 'primary'"
><template #icon><Check :size="16" /></template>设为主参考图</NButton
>
<NButton
class="workspace-action-button"
:disabled="!canValidate"
:loading="pending?.kind === 'quality'"
@click="requestQuality"
><template #icon><WandSparkles :size="16" /></template>审核与修复</NButton
>
<span class="text-[11px] text-muted"
>{{ selected.provider }} · {{ selected.model }} · {{ formatDate(selected.createdAt) }}</span
>
</div>
<ContextNotice v-if="actionError" type="error" :show-icon="false" class="mt-4">{{
actionError
}}</ContextNotice>
<ContextNotice v-if="selected.qualityPassed === false" type="error" :show-icon="false" class="mt-4">
<p>这张图片未通过最近一次质量审核,候选已保留。可明确重新审核或选择其它候选,原主图不会被替换。</p>
<p v-for="(issue, index) in selected.qualityIssues" :key="index" class="mt-2">
{{ userFacingText(issue.description) }}
</p>
</ContextNotice>
<p v-else-if="selected.status === 'completed'" class="mt-3 text-xs leading-6 text-muted">
复用母版与单独审核形态是不同记录。最近审核记录不保证当前来源仍有效;来源或母版变化后需明确重新审核,切换主图时会再次检查。
</p>
<ImageValidationPanel v-if="validation?.imageId === selected.id" class="mt-5" :result="validation" />
<!-- 以下是按明确预算完成的质量处理回执,失败不覆盖原主图 -->
<ContextNotice
v-if="qualityResult"
:type="qualityResult.passed ? 'success' : 'error'"
:show-icon="false"
class="mt-4"
>
<p>
{{ qualityResult.passed ? '最终候选审核通过' : '最终候选未通过审核,候选已保留' }};{{
qualityResult.primaryChanged ? '主图已更新' : '主图未切换'
}}。
</p>
<p class="mt-1">
实际修复 {{ qualityResult.repairAttempts }} 次 / 最多 {{ qualityResult.maxRepairAttempts }} 次。
</p>
<NButton
v-if="
qualityResult.finalImageId !== selected.id &&
images.some(image => image.id === qualityResult?.finalImageId)
"
class="workspace-action-button mt-3"
@click="selectedId = qualityResult.finalImageId"
><template #icon><Eye :size="16" /></template>查看最终候选</NButton
>
<NCollapse class="mt-3"
><NCollapseItem name="attempts" title="查看逐次审核">
<div
v-for="attempt in qualityResult.attempts"
:key="attempt.attempt"
class="mt-3 text-xs leading-6"
>
<strong
>{{ attempt.attempt === 0 ? '初始候选' : `修复 ${attempt.attempt}` }} ·
{{ attempt.passed ? '通过' : '未通过' }}</strong
>
<p v-for="(issue, index) in attempt.issues" :key="index">
{{ userFacingText(issue.description) }}
</p>
</div>
</NCollapseItem></NCollapse
>
</ContextNotice>
<!-- 以下是失效复用历史的说明模块 -->
<p v-if="reusedImageUnavailable" class="mt-3 text-xs text-muted">
此图片复用的身份母版已变更,或当前形态不再满足复用条件,仅保留作历史查看。
</p>
<ContextNotice v-if="confirming" type="info" :show-icon="false" class="mt-3"
><p class="text-xs">确认将这张图用于此形态后续的分镜参考?旧主图仍会保留,此操作不调用模型。</p>
<div class="mt-3 flex gap-3">
<NButton :disabled="!canSetPrimary" @click="choosePrimary" type="primary"> 确认切换主图</NButton
><NButton @click="confirming = false" text size="small">取消</NButton>
</div></ContextNotice
>
<p class="mt-3 break-all font-mono text-[10px] text-muted">图片编号 · {{ selected.id }}</p>
<p v-if="form && currentIdentityAnchorId(form)" class="mt-2 break-all text-[11px] text-muted">
当前已锁定身份母版 ID:{{ currentIdentityAnchorId(form) }}
</p>
<ContextNotice v-if="confirming" type="info" :show-icon="false" class="mt-4">
{{
confirming === 'quality'
? '将审核当前候选,通过后设为主图;未通过时按下方预算最多追加生图。可能产生文字准备、视觉审核和图片生成费用,使用该候选供应方及当前项目配置。失败保留旧主图和所有候选。'
: confirming === 'validate'
? '将调用视觉模型并产生审核费用,只保存质量证据,不切换主图。'
: '将检查当前来源与质量证据;缺少可复用审核时可能调用视觉模型并产生费用。通过后才切换主图,失败保留原主图。'
}}
</ContextNotice>
<div v-if="confirming === 'quality'" class="mt-4 space-y-2">
<label for="quality-repair-budget" class="block text-xs"
>最多额外生成次数(0 表示只审核,不追加生图)</label
>
<NInputNumber
:input-props="{ id: 'quality-repair-budget' }"
v-model:value="maxRepairAttempts"
:min="0"
:max="3"
:precision="0"
:disabled="!!pending"
/>
</div>
<!-- 以下是默认收起的图片来源标识,日常操作不展示内部编号 -->
<RawDataDetails
:value="{
imageId: selected.id,
identityAnchorImageId: selected.identityAnchorImageId,
currentIdentityAnchorImageId: form ? currentIdentityAnchorId(form) : undefined
}"
title="图片来源详情"
/>
</div>
<p v-else class="py-10 text-center text-sm text-muted">
{{ query.loading.value ? '正在读取图片记录…' : '此形态尚无图片记录,可以先生成一张。' }}
</p>
</AppDialog>
<template #footer>
<NButton :disabled="!!pending" @click="confirming ? (confirming = null) : (open = false)">{{
confirming ? '取消' : '关闭'
}}</NButton>
<NButton
v-if="confirming"
type="primary"
:disabled="!canConfirm"
:loading="!!pending"
@click="confirmAction"
>{{
confirming === 'quality'
? '确认费用并执行'
: confirming === 'validate'
? '确认费用并审核'
: '确认费用并设为主图'
}}</NButton
>
</template>
</AppDrawer>
</template>
@@ -0,0 +1,92 @@
<script setup lang="ts">
import { computed } from 'vue'
import { NButton, NCollapse, NCollapseItem, NTag } from 'naive-ui'
import { Eye } from '@lucide/vue'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import RawDataDetails from '../../../components/ui/RawDataDetails.vue'
import WorkspaceSectionHeading from '../../../components/ui/WorkspaceSectionHeading.vue'
import type { ImageGenerationPreview } from '../generation-preview'
/** 三个图片入口共用的最终输入与参考职责展示。 */
const props = defineProps<{
/** 当前有效预览。 */
preview: ImageGenerationPreview | null
/** 预览读取中。 */
loading: boolean
/** 当前不能读取预览。 */
disabled?: boolean
/** 读取或提交错误。 */
error: string
/** 来源变化后的重新确认说明。 */
staleNotice: string
}>()
/** 预览由当前表单按真实参数读取。 */
const emit = defineEmits<{ load: [] }>()
/** 参考职责统一中文展示,不展示内部图片编号。 */
const roles: Record<string, string> = {
'identity-anchor': '主体外观母版',
'layout-master': '空间布局母版',
'style-character': '人物风格',
'style-scene': '场景风格',
'style-prop': '道具风格',
'style-overall': '整体风格',
'form-primary': '形态主图',
'structure-reference': '结构参考'
}
/** 形态按真实顺序展示;身份预览从同源参考计划取得职责。 */
const references = computed(() => {
if (props.preview?.references)
return props.preview.references.map(item => ({
order: item.imageNumber,
label: roles[item.role] ?? '图片参考'
}))
const selected = props.preview?.referencePlan?.selected
return Array.isArray(selected)
? selected.map((item: { role?: string }, index) => ({
order: index + 1,
label: roles[item.role ?? ''] ?? '图片参考'
}))
: []
})
</script>
<template>
<!-- 以下是免费实际输入预览模块,参数调整后必须重新读取 -->
<section class="min-w-0 space-y-4" aria-label="本次生成预览">
<WorkspaceSectionHeading
title="本次生成预览"
description="只检查已有描述、规格和参考图,不生成图片,也不自动补齐资料。"
/>
<NButton
class="workspace-action-button"
:loading="loading"
:disabled="disabled || loading"
@click="emit('load')"
>
<template #icon><Eye :size="16" /></template>预览实际生成输入
</NButton>
<ContextNotice v-if="staleNotice" type="warning" :show-icon="false">{{ staleNotice }}</ContextNotice>
<ContextNotice v-if="error" type="error" :show-icon="false">{{ error }}</ContextNotice>
<div v-if="preview" class="min-w-0 space-y-3 text-xs leading-6">
<div class="flex flex-wrap items-center gap-2">
<strong>{{ preview.provider }} / {{ preview.model }}</strong>
<NTag :bordered="false" size="small"
>{{ preview.actualProviderReferenceCount ?? preview.referenceImages.length }} 张参考图</NTag
>
</div>
<ul v-if="references.length" class="flex flex-wrap gap-x-5 gap-y-1 text-muted">
<li v-for="item in references" :key="item.order">图 {{ item.order }} · {{ item.label }}</li>
</ul>
<p v-else-if="!preview.referenceImages.length" class="text-muted">本次没有图片参考。</p>
<NCollapse :default-expanded-names="['prompt']">
<NCollapseItem name="prompt" title="本次实际使用的画面描述">
<p class="whitespace-pre-wrap wrap-anywhere">{{ preview.providerPrompt }}</p>
</NCollapseItem>
</NCollapse>
<RawDataDetails
:value="{ generationConfig: preview.generationConfig, referencePlan: preview.referencePlan }"
title="生成参数与参考图详情"
/>
</div>
</section>
</template>
@@ -0,0 +1,147 @@
<script setup lang="ts">
import { computed, ref, watch } from 'vue'
import { NButton } from 'naive-ui'
import { RefreshCw } from '@lucide/vue'
import { AppDrawer } from '../../../components/ui'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import { useQuery } from '../../../composables/useQuery'
import { productionApi } from '../../production/api'
import ImagePreparationPlan from '../../production/components/ImagePreparationPlan.vue'
import { userFacingText } from '../../../lib/user-facing-text'
import { getOperation, runOperation } from '../../workflows/operations'
import { subjectImagesApi } from '../api'
/** 在图片阶段核对准备依赖,无需先进入镜头生产。 */
const props = defineProps<{ /** 正式项目编号。 */ projectId: string }>()
/** 全屏只读检查开关。 */
const open = defineModel<boolean>('open', { default: false })
/** 关闭或切项目时取消旧请求。 */
const key = computed(() => (open.value ? props.projectId : ''))
/** 用户选择并待确认费用的文字准备项。 */
const selected = ref<{ formId: string; kind: 'prompt' | 'structure' } | null>(null)
/** 仅当前准备请求阻止关闭。 */
const pending = ref(false)
/** 项目级活动任务阻止并行写入。 */
const operation = computed(() => getOperation(props.projectId))
/** 关闭或切项目后清除待确认项。 */
watch(key, () => {
selected.value = null
})
/** 仅预检主体图片阶段,不调用任何生成模型。 */
const query = useQuery(key, async (id, signal) => {
if (!id) return null
const result = await productionApi.plan(id, signal, { stage: 'subjectImages' })
if (result.projectId !== id) throw new Error('图片准备检查与当前项目不匹配,请刷新重试。')
return result
})
/** 只有完整计划才展示统计,配置阻断不冒充空计划。 */
const plan = computed(() => (query.data.value?.stage !== 'configuration_required' ? query.data.value : null))
/** 费用确认展示真实主体和形态,避免多个准备项混淆。 */
const selectedLabel = computed(() => {
if (!selected.value || !plan.value) return ''
const form = plan.value.details.subjectImages.find(item => item.subjectFormId === selected.value?.formId)
return form ? `${form.subjectName} · ${form.formName}` : '所选形态'
})
/** 明确费用后只准备所选资料,不自动串联下一项或生图。 */
async function prepare() {
if (
!selected.value ||
!plan.value ||
query.error.value ||
query.loading.value ||
operation.value.pending ||
pending.value
)
return
const target = selected.value
const projectId = props.projectId
const item =
plan.value.propStructureSpecs?.items.find(row => row.subjectFormId === target.formId) ??
plan.value.stableIdentityAnchors?.propStructureSpecs?.items.find(row => row.subjectFormId === target.formId)
if (!item || item.status !== 'upstream' || (item.requiresFormPrompt ? 'prompt' : 'structure') !== target.kind)
return
pending.value = true
try {
const ok = await runOperation(
projectId,
target.kind === 'prompt' ? '准备形态画面描述' : '准备道具结构规格',
async () => {
if (target.kind === 'prompt') await subjectImagesApi.generatePrompt(target.formId, false)
else await subjectImagesApi.prepareStructure(target.formId)
},
{ type: 'info', content: '资料准备已返回,请以更新后的检查状态为准。' }
)
if (props.projectId === projectId && open.value) {
if (ok) selected.value = null
await query.refresh()
}
} finally {
pending.value = false
}
}
</script>
<template>
<!-- 以下是只读图片准备检查抽屉,关闭不受加载限制 -->
<AppDrawer
v-model:open="open"
title="图片准备检查"
description="检查免费。需要补充资料时,可逐项确认文字模型费用后准备,不会自动生图。"
:busy="pending"
>
<div class="space-y-6">
<ContextNotice v-if="query.error.value" type="error" :show-icon="false">{{
query.error.value
}}</ContextNotice>
<p v-if="query.loading.value && !query.data.value" class="text-sm text-muted">正在检查当前准备情况…</p>
<template v-else-if="plan">
<p class="text-sm leading-7 text-muted">
主体参考图共 {{ plan.subjectImages.total }} 项,已有可用结果
{{ plan.subjectImages.skipped }} 项,需人工处理
{{ plan.subjectImages.manualBlocked }} 项。准备计划不代表图片已经通过审核。
</p>
<div class="grid items-start gap-6 lg:grid-cols-2">
<ImagePreparationPlan
:plan="plan"
allow-preparation
:disabled="operation.pending || pending || query.loading.value || !!query.error.value"
@navigate="open = false"
@prepare="(formId, kind) => (selected = { formId, kind })"
/>
</div>
<p v-if="!plan.propStructureSpecs && !plan.stableIdentityAnchors" class="text-sm text-muted">
当前服务尚未提供规格与母版依赖明细,请核对服务版本后刷新。
</p>
</template>
<ContextNotice v-else-if="query.data.value" type="warning" :show-icon="false">{{
userFacingText(query.data.value.configuration?.reason) || '项目生成配置尚未就绪,请先完善项目配置。'
}}</ContextNotice>
<ContextNotice v-if="selected" type="info" :show-icon="false"
>本次为「{{ selectedLabel }}」{{
selected.kind === 'prompt' ? '准备该形态的画面描述' : '生成或更新该道具的结构规格'
}},可能调用文字模型并产生费用。不会生成图片,也不会自动继续其它准备项。</ContextNotice
>
</div>
<template #footer>
<NButton :disabled="pending" @click="selected ? (selected = null) : (open = false)">{{
selected ? '取消' : '关闭'
}}</NButton>
<NButton
v-if="selected"
type="primary"
:loading="pending"
:disabled="operation.pending || query.loading.value || !!query.error.value"
@click="prepare"
>确认费用并准备</NButton
>
<NButton
v-else
class="workspace-action-button"
:disabled="pending"
:loading="query.loading.value"
@click="query.refresh"
><template #icon><RefreshCw :size="16" /></template>刷新检查</NButton
>
</template>
</AppDrawer>
</template>
@@ -0,0 +1,86 @@
<script setup lang="ts">
import { computed } from 'vue'
import { NCollapse, NCollapseItem, NTag } from 'naive-ui'
import ContextNotice from '../../../components/ui/ContextNotice.vue'
import { userFacingText } from '../../../lib/user-facing-text'
import { imageValidationPassed, sourceRequirementRows, type ImageValidationResult } from '../validation'
/** 展示指定图片本次审核与原始定义对照,不推断主图或母版已采纳。 */
const props = defineProps<{
/** 明确绑定当前图片的正式审核结果。 */
result: ImageValidationResult
}>()
/** 只有证据完整才使用成功状态。 */
const passed = computed(() => imageValidationPassed(props.result))
/** 原文与观测按标识关联,内部标识不出现在标题中。 */
const requirements = computed(() => sourceRequirementRows(props.result))
</script>
<template>
<!-- 以下是当前图片的审核摘要模块,审核不自动切换主图或母版 -->
<section class="min-w-0 space-y-4" aria-label="图片质量审核结果">
<ContextNotice :type="passed ? 'success' : 'error'" :show-icon="false">
<p class="font-medium">{{ passed ? '本次质量审核通过' : '本次质量审核未通过或仍待复核' }}</p>
<p class="mt-1 whitespace-pre-wrap wrap-anywhere">{{ userFacingText(result.summary) }}</p>
</ContextNotice>
<p class="text-xs leading-6 text-muted">
审核只保存质量证据,不会自动采纳图片。资料或图片变化后需重新核对;最终可用性以当前制作准备检查为准。
</p>
<ul v-if="result.issues.length" class="space-y-2 text-xs leading-6">
<li v-for="(issue, index) in result.issues" :key="index" class="whitespace-pre-wrap wrap-anywhere">
<NTag
:type="issue.severity === 'error' ? 'error' : 'warning'"
:bordered="false"
size="small"
class="mr-2"
>{{ issue.severity === 'error' ? '需处理' : '需核对' }}</NTag
>{{ userFacingText(issue.description) }}
</li>
</ul>
<!-- 以下是原始外观定义及明确数量的逐条审核模块 -->
<NCollapse v-if="requirements.length" :default-expanded-names="['source']">
<NCollapseItem name="source" title="原始外观定义核对">
<div class="space-y-5 text-xs leading-6">
<article v-for="(item, index) in requirements" :key="item.id" class="min-w-0 space-y-2">
<div class="flex flex-wrap items-center gap-2">
<strong>{{ item.subjectName }} · 定义 {{ index + 1 }}</strong
><NTag
:type="item.passed ? 'success' : item.label === '未通过' ? 'error' : 'warning'"
:bordered="false"
size="small"
>{{ item.label }}</NTag
>
</div>
<p class="whitespace-pre-wrap wrap-anywhere">原文:{{ item.sourceQuote }}</p>
<p class="whitespace-pre-wrap wrap-anywhere text-muted">
观察:{{ userFacingText(item.evidence) }}
</p>
<ul v-if="item.quantities.length" class="space-y-1">
<li
v-for="quantity in item.quantities"
:key="quantity.id"
class="flex flex-wrap gap-x-4 gap-y-1"
>
<span>{{ quantity.sourcePhrase }}</span
><span>要求 {{ quantity.expectedCount }}</span
><span :class="quantity.matches ? 'text-muted' : 'text-danger'"
>实际观察 {{ quantity.observed ?? '无法确认' }}</span
>
</li>
</ul>
</article>
</div>
</NCollapseItem>
</NCollapse>
<p v-else-if="result.sourceRequirementsPassed !== true" class="text-xs text-muted">
原始定义审核证据尚未确认,请重新审核后核对。
</p>
<p class="text-xs text-muted">
{{
result.identityAnchorCompared
? '本次审核已提供当前主体母版作为对照。'
: '本次审核未提供母版像素对照,不能据此证明与母版一致。'
}}
</p>
</section>
</template>
@@ -0,0 +1,176 @@
import { computed, onBeforeUnmount, ref, shallowRef, watch, type Ref } from 'vue'
import { ApiError, errorMessage } from '../../lib/http'
/** 三类图片入口共用的实际生成预览。 */
export interface ImageGenerationPreview {
/** 实际供应方。 */
provider: string
/** 实际模型。 */
model: string
/** 最终画面描述。 */
providerPrompt: string
/** 本次预览绑定的来源与配置版本。 */
previewFingerprint: string
/** 实际传入模型的参考图。 */
referenceImages: string[]
/** 已解析的生成配置。 */
generationConfig: Record<string, unknown>
/** 参考图顺序和职责等诊断信息。 */
referencePlan?: Record<string, unknown>
/** 形态接口给出的有序参考图明细。 */
references?: Array<{
/** 传入模型的顺序。 */
imageNumber: number
/** 参考图职责。 */
role: string
/** 正式图片编号。 */
imageId: string
/** 可展示的图片地址。 */
imageUrl: string
}>
/** 含布局母版的真实参考图数量。 */
actualProviderReferenceCount?: number
}
/** 提交结果只说明任务是否创建,不代表图片质量通过。 */
export interface ImageGenerationSubmission {
/** 已确认创建后台任务。 */
accepted: boolean
/** 原始错误用于识别预览过期,不能仅按 409 猜测原因。 */
cause?: unknown
}
/** 预览、确认和提交所需的当前界面上下文。 */
interface PreviewOptions<Input extends object, Preview extends ImageGenerationPreview> {
/** 当前表单可见状态。 */
open: Ref<boolean>
/** 主体、形态及已有来源的稳定标识。 */
target: () => string
/** 当前完整生成参数。 */
input: () => Input
/** 当前是否允许提交。 */
disabled: () => boolean
/** 只读预览,不创建或补齐任何资产。 */
load: (input: Input, signal: AbortSignal) => Promise<Preview>
/** 用户明确确认后仅提交一次。 */
generate: (input: Input & { expectedPreviewFingerprint: string }) => Promise<ImageGenerationSubmission>
}
/**
* 绑定预览与提交参数,处理过期响应、关闭及 409 重新确认。
* @param options 当前表单、正式预览与生成操作
* @returns 预览、确认、加载、错误和显式提交操作
*/
export function useImageGenerationPreview<Input extends object, Preview extends ImageGenerationPreview>(
options: PreviewOptions<Input, Preview>
) {
/** 当前有效的实际输入。 */
const preview = shallowRef<Preview | null>(null)
/** 用户核对当前预览及费用后的确认。 */
const acknowledged = ref(false)
/** 只读查询状态,不阻止关闭。 */
const loading = ref(false)
/** 已提交的请求尚未返回时防重复及误关闭。 */
const submitting = ref(false)
/** 当前读取或提交错误。 */
const error = ref('')
/** 过期说明在新预览返回后仍保留,提醒再次确认。 */
const staleNotice = ref('')
/** 输入快照同时绑定界面目标和显隐周期。 */
const key = computed(() => JSON.stringify([options.open.value, options.target(), options.input()]))
/** 请求序号防止相同参数的旧响应回填。 */
let revision = 0
/** 预览请求取消句柄;生成提交不取消或重试。 */
let controller: AbortController | undefined
/** 当前界面的预览必须完整且费用已确认。 */
const canSubmit = computed(
() =>
options.open.value &&
!options.disabled() &&
!submitting.value &&
!loading.value &&
!!preview.value &&
acknowledged.value
)
/** 参数或目标变化立即废弃预览和确认。 */
function invalidate() {
revision++
controller?.abort()
preview.value = null
acknowledged.value = false
loading.value = false
error.value = ''
staleNotice.value = ''
}
watch(key, invalidate, { flush: 'sync' })
onBeforeUnmount(invalidate)
/** 只读取当前参数;失败保留原因,迟到响应不回填。 */
async function loadPreview() {
if (!options.open.value || submitting.value) return
controller?.abort()
const current = ++revision
const abort = new AbortController()
controller = abort
preview.value = null
acknowledged.value = false
loading.value = true
error.value = ''
const input = JSON.parse(JSON.stringify(options.input())) as Input
try {
const result = await options.load(input, abort.signal)
if (current !== revision || abort.signal.aborted) return
if (
!result ||
!/^[a-f0-9]{64}$/i.test(result.previewFingerprint) ||
!result.providerPrompt?.trim() ||
!result.provider ||
!result.model ||
!Array.isArray(result.referenceImages)
)
throw new Error('生成预览不完整,请刷新预览后再确认。')
preview.value = result
} catch (cause) {
if (current === revision && !abort.signal.aborted) error.value = errorMessage(cause)
} finally {
if (current === revision) loading.value = false
}
}
/** 明确提交一次;预览过期只重读预览,绝不自动重新生成。 */
async function submit() {
if (!canSubmit.value || !preview.value) return
const current = revision
const input = JSON.parse(JSON.stringify(options.input())) as Input
const fingerprint = preview.value.previewFingerprint
submitting.value = true
error.value = ''
let result: ImageGenerationSubmission
try {
result = await options.generate({ ...input, expectedPreviewFingerprint: fingerprint })
} catch (cause) {
result = { accepted: false, cause }
} finally {
submitting.value = false
}
if (current !== revision) return
if (result.accepted) {
options.open.value = false
return
}
acknowledged.value = false
if (
result.cause instanceof ApiError &&
result.cause.status === 409 &&
result.cause.code === 'IMAGE_PREVIEW_STALE'
) {
invalidate()
staleNotice.value = '生成依据或配置已变化,本次未生成图片。请核对更新后的预览并重新确认。'
await loadPreview()
} else {
error.value = result.cause ? errorMessage(result.cause) : '当前暂不能提交,请刷新项目状态后重试。'
}
}
return { preview, acknowledged, loading, submitting, error, staleNotice, canSubmit, loadPreview, submit }
}
+64 -11
View File
@@ -1,8 +1,15 @@
import type { ImageGenerationPreview } from './generation-preview'
import type { ImageQualityIssue } from './validation'
/** 后端图片记录的持久化状态,不以 HTTP 请求完成代替生成成功。 */
export type SubjectImageStatus = 'pending' | 'generating' | 'completed' | 'failed'
/** 图库列表返回的图片元数据;正式图片 ID 与形态 ID 均来自数据库。 */
export interface SubjectImage {
/** 最近一次结构化质量结论;缺失或 null 不代表通过。 */
qualityPassed?: boolean | null
/** 最近一次质量问题;最新可用性仍以制作准备检查为准。 */
qualityIssues?: ImageQualityIssue[]
/** 图片来源;旧后端未提供时按独立生成处理。 */
source?: 'generated' | 'identity-anchor'
/** 生成或复用时记录的身份母版编号。 */
@@ -50,9 +57,21 @@ export interface SubjectFormAsset {
/** 单形态生图配置;实际模型统一由后端 IMAGE 配置决定。 */
export interface GenerateFormImageInput {
/** 用户已核对的实际输入版本。 */
expectedPreviewFingerprint?: string
/** 本次可选图片宽度。 */
width?: number
/** 本次可选图片高度。 */
height?: number
/** 本次负面提示词。 */
negativePrompt?: string
/** 本次完整画面描述。 */
prompt?: string
/** 图片供应方。 */
provider?: string
/** 模型支持的动态参数。 */
generationOptions?: Record<string, string | number | boolean>
/** 生成并通过质量门禁后是否切换主图。 */
setPrimary: boolean
}
@@ -95,18 +114,9 @@ export interface GenerateFormPromptsInput {
export type SubjectModule = 'character' | 'scene' | 'prop'
/** 形态生图前的无费用实际输入预览。 */
export interface SubjectImageGenerationPreview {
export interface SubjectImageGenerationPreview extends ImageGenerationPreview {
/** 正式形态编号,用于核对响应目标。 */
subjectFormId: string
provider: string
model: string
generationConfig: Record<string, unknown>
references: Array<{
imageNumber: number
role: string
imageId: string
imageUrl: string
}>
providerPrompt: string
}
/** 长请求的回执按项目隔离,在会话内切换页面后仍可查看。 */
@@ -115,3 +125,46 @@ export interface ImageSession {
/** 提示词回执独立保存,避免覆盖最近一次生图回执。 */
promptReceipt?: { title: string; result: ImageBatchResult } | null
}
/** 明确选择候选及额外生图预算的质量处理请求。 */
export interface FormImageQualityInput {
/** 初始审核的已有候选。 */
imageId: string
/** 本轮图片供应方,修复继续使用该供应方。 */
provider: string
/** 最多额外生成次数,0 表示不追加生图。 */
maxRepairAttempts: number
}
/** 后端质量闭环回执,与单次视觉审核区分。 */
export interface FormImageQualityResult {
/** 所属形态。 */
subjectFormId: string
/** 初始候选编号。 */
initialImageId: string
/** 最终候选编号。 */
finalImageId: string
/** 原主图编号。 */
originalPrimaryId?: string
/** 最终审核通过。 */
passed: boolean
/** 是否发生修复生图。 */
repaired: boolean
/** 实际修复次数。 */
repairAttempts: number
/** 用户授权的最多修复次数。 */
maxRepairAttempts: number
/** 当前主图是否发生切换。 */
primaryChanged: boolean
/** 每次候选的真实审核记录。 */
attempts: Array<{
/** 从零起算的轮次。 */
attempt: number
/** 本轮候选编号。 */
imageId: string
/** 本轮审核通过。 */
passed: boolean
/** 本轮问题。 */
issues: ImageQualityIssue[]
}>
}
@@ -1,3 +1,4 @@
import type { ImageGenerationSubmission } from './generation-preview'
import { computed, ref } from 'vue'
import { usePolling } from '../../composables/usePolling'
import { ApiError } from '../../lib/http'
@@ -143,21 +144,28 @@ export function useSubjectImages() {
await query.refresh()
}
/** 捕获正式 Form ID,生成后重新读取图片;刷新失败也不自动重发有费用的请求。 */
async function generate(formId: string, input: GenerateFormImageInput) {
if (blocked.value) return
/**
* 按已核对的预览创建单图任务,失败时将原始原因交回表单。
* @param formId 正式形态编号
* @param input 当前参数与预览版本
* @returns 是否创建任务及原始失败原因
*/
async function generate(formId: string, input: GenerateFormImageInput): Promise<ImageGenerationSubmission> {
if (blocked.value) return { accepted: false }
const form = forms.value.find(item => item.id === formId)
if (!form || hasRunningImages(form.images)) return
if (!form || hasRunningImages(form.images)) return { accepted: false }
const projectId = id.value
const ok = await runOperation(projectId, `提交 ${form.subject.name} · ${form.name} 图片生成`, async () => {
const image = await subjectImagesApi.generate(formId, input)
if (!image || image.subjectFormId !== formId || !['pending', 'generating'].includes(image.status))
throw new Error(image?.error || '图片生成任务未成功创建,请刷新后重试。')
})
if (ok) {
const cause = getOperation(projectId).cause
if (ok && id.value === projectId) {
await query.refresh()
operation.value.notice = `${form.subject.name} · ${form.name} 已提交生成,可稍后刷新图库查看结果。`
}
return { accepted: ok, cause }
}
/** 批量始终面向整个项目,不受页面筛选影响;force 仅新增候选图,不替换已有主图。 */
+142
View File
@@ -0,0 +1,142 @@
/** 服务端保留的图片质量问题。 */
export interface ImageQualityIssue {
/** 原始问题分类,不用于中文标题。 */
type: string
/** 问题严重程度。 */
severity: 'warning' | 'error'
/** 业务原因。 */
description: string
}
/** 原始创作中能唯一绑定当前主体的外观定义。 */
export interface SourceVisualRequirement {
/** 原始定义关联标识,仅用于匹配。 */
id: string
/** 正式主体编号。 */
subjectId: string
/** 正式主体名称。 */
subjectName: string
/** 逐字保留的来源原文。 */
sourceQuote: string
/** 可以由原文直接确定的数量。 */
quantities: Array<{
/** 数量证据关联标识。 */
id: string
/** 原始数量短语。 */
sourcePhrase: string
/** 原文明确要求的数量。 */
expectedCount: number
}>
}
/** 视觉审核对一条原始定义的真实观察。 */
export interface SourceVisualRequirementResult {
/** 所属原始定义。 */
requirementId: string
/** 单项审核状态。 */
status: 'passed' | 'failed' | 'unobservable' | 'needs_review'
/** 可观察证据或未能确认的原因。 */
evidence: string
/** 按像素观察到的数量,null 表示无法确认。 */
quantities?: Array<{
/** 所属数量证据。 */
quantityId: string
/** 真实观察数量。 */
observedCount: number | null
}>
}
/** 身份与形态图片共用的正式视觉审核结果。 */
export interface ImageValidationResult {
/** 正式主体编号。 */
subjectId: string
/** 主体引用。 */
subjectRef?: string
/** 正式形态编号;身份审核不得据此推断母版采纳。 */
subjectFormId?: string
/** 本次被审核的图片。 */
imageId: string
/** 图片地址。 */
imageUrl?: string
/** 形态主图标记,不能当作身份母版标记。 */
isPrimary?: boolean
/** 服务端本次总审核结论。 */
passed: boolean
/** 外观是否一致。 */
formConsistent?: boolean
/** 物理结构是否有效。 */
physicalStructureValid?: boolean
/** 空间布局是否有效。 */
spatialLayoutValid?: boolean
/** 本次质量问题。 */
issues: ImageQualityIssue[]
/** 业务摘要。 */
summary: string
/** 实际向审核模型提供了当前母版像素,不代表审核通过。 */
identityAnchorCompared?: boolean
/** 本次对照的母版编号。 */
identityAnchorImageId?: string | null
/** 原始定义是否具备完整审核证据。 */
sourceRequirementsPassed?: boolean
/** 实际提交审核的原始定义。 */
sourceVisualRequirements?: SourceVisualRequirement[]
/** 逐项真实像素观察。 */
sourceVisualRequirementResults?: SourceVisualRequirementResult[]
/** 构图检查的必要审核状态。 */
compositionReview?: {
/** 仍须人工核对。 */ requiresManualReview?: boolean
/** 其它服务端证据。 */ [key: string]: unknown
} | null
/** 原始构图规则证据。 */
compositionRuleResults?: unknown[]
}
/**
* 按唯一证据逐项核对原始定义,缺失、重复或不可见均不显示通过。
* @param result 后端本次审核结果
* @returns 面向用户的原文、数量与观察状态
*/
export function sourceRequirementRows(result: ImageValidationResult) {
return (result.sourceVisualRequirements ?? []).map(requirement => {
const matches = (result.sourceVisualRequirementResults ?? []).filter(
item => item.requirementId === requirement.id
)
const observation = matches.length === 1 ? matches[0] : undefined
const quantities = requirement.quantities.map(quantity => {
const matched = observation?.quantities?.filter(item => item.quantityId === quantity.id) ?? []
const observed = matched.length === 1 ? (matched[0]?.observedCount ?? null) : null
return { ...quantity, observed, matches: observed === quantity.expectedCount }
})
const passed =
observation?.status === 'passed' && !!observation.evidence?.trim() && quantities.every(item => item.matches)
const failed =
observation?.status === 'failed' || quantities.some(item => item.observed !== null && !item.matches)
return {
...requirement,
quantities,
evidence:
observation?.evidence || (matches.length > 1 ? '审核记录重复,需重新核对。' : '尚无完整审核证据。'),
passed,
label: failed ? '未通过' : passed ? '通过' : observation?.status === 'unobservable' ? '无法观察' : '待复核'
}
})
}
/**
* 展示成功必须同时具备服务端通过结论和完整原始定义证据。
* @param result 当前图片审核结果
* @returns 是否可以展示本次审核通过
*/
export function imageValidationPassed(result: ImageValidationResult): boolean {
return (
result.passed === true &&
result.sourceRequirementsPassed === true &&
Array.isArray(result.sourceVisualRequirements) &&
!result.issues.some(issue => issue.severity === 'error') &&
result.formConsistent !== false &&
result.physicalStructureValid !== false &&
result.spatialLayoutValid !== false &&
!result.compositionReview?.requiresManualReview &&
sourceRequirementRows(result).every(item => item.passed)
)
}
@@ -164,7 +164,7 @@ function removeImage(image: VisualStyleImage) {
<h3 class="font-medium">风格生成规则</h3>
<p class="mt-3 text-xs leading-6 text-muted">
AI
生成时,若项目和世界观没有明确其它人物背景,人物风格默认采用中国人物选角基线;人工填写的人物背景和角色事实优先。修改风格只影响之后的生成,旧资产不会自动更新。
生成时遵循剧本与角色已明确的外观和人物背景;未明确时保持地域与族裔中性,不从姓名或视觉媒介推断。修改风格只影响之后的生成,旧资产不会自动更新。
</p>
</section>
<!-- 以下是风格编辑与始终展开的分类补充模块 -->
@@ -106,7 +106,7 @@ function save() {
><NInput
:input-props="{ 'aria-label': '人物风格与选角背景' }"
:disabled="disabled"
placeholder="人物质感、妆造与默认选角背景;留空时 AI 默认采用中国人物基线"
placeholder="人物质感、妆造与已明确的选角背景;未明确时保持地域与族裔中性"
class="min-h-32"
v-model:value="form.characterPrompt"
type="textarea"
@@ -34,6 +34,32 @@ const props = withDefaults(
const emit = defineEmits<{ refresh: []; dismiss: [] }>()
const percentage = computed(() => executionPercentage(props.execution?.current ?? 0, props.execution?.total ?? 0))
const result = computed(() => props.execution?.result ?? {})
/** 导演设计和画面状态的逐集结果独立于任务执行终态。 */
const derivedTask = computed(() =>
['storyboard-direction', 'storyboard-visual-state'].includes(props.execution?.workflowName ?? '')
)
/** 部分失败和人工核对标记不能显示为全部完成。 */
const derivedNeedsReview = computed(
() =>
derivedTask.value &&
(result.value.manualReviewRequired === true ||
Number(result.value.failedEpisodes) > 0 ||
Number(result.value.staleCount) > 0)
)
/** 逐集记录仅保留实际返回的集号、状态与业务原因。 */
const derivedEpisodes = computed(() => {
if (!derivedTask.value || !Array.isArray(result.value.episodes)) return []
return result.value.episodes.flatMap((item: unknown) => {
if (!item || typeof item !== 'object' || !('episodeNo' in item) || typeof item.episodeNo !== 'number') return []
return [
{
episodeNo: item.episodeNo,
status: 'status' in item && typeof item.status === 'string' ? item.status : '',
error: 'error' in item && typeof item.error === 'string' ? item.error : ''
}
]
})
})
/** 只改变旧记录的展示语义,不改写原始任务或审核结果。 */
const historical = computed(
() =>
@@ -95,6 +121,10 @@ const statusLabel = computed(() => {
const labels = { pending: '等待开始', running: '执行中', completed: '已完成', failed: '失败' }
if (!props.execution) return ''
if (historical.value) return '历史执行记录'
if (derivedTask.value && ['completed', 'failed'].includes(props.execution.status))
return props.execution.status === 'failed' || derivedNeedsReview.value
? '执行结束 · 需核对部分结果'
: '执行结束 · 请核对覆盖情况'
if (scriptCreation.value && props.execution.status === 'completed') {
if (result.value.projectStatus === 'need_review') return '执行结束 · 待修订'
if (result.value.projectStatus !== 'completed') return '执行结束 · 结果待确认'
@@ -122,6 +152,8 @@ const staleMotionPlanCount = computed(() => {
/** 业务未通过或结果未知时,不把任务执行结束展示为全成功。 */
const statusType = computed(() => {
if (historical.value) return 'default'
if (derivedTask.value)
return props.execution?.status === 'failed' ? 'error' : derivedNeedsReview.value ? 'warning' : 'default'
if (scriptCreation.value && props.execution?.status === 'completed')
return result.value.projectStatus === 'completed'
? 'success'
@@ -306,7 +338,13 @@ function isInputMode(value: unknown, inputMode: string): boolean {
v-if="execution.total > 0 && ((!breakdownTask && !diagnosisTask) || !finished)"
type="line"
:percentage="percentage"
:color="scriptCreation && result.projectStatus !== 'completed' ? 'var(--app-muted)' : undefined"
:color="
execution.status === 'failed' ||
derivedTask ||
(scriptCreation && result.projectStatus !== 'completed')
? 'var(--app-muted)'
: undefined
"
:height="5"
:show-indicator="false"
class="mt-4"
@@ -345,28 +383,32 @@ function isInputMode(value: unknown, inputMode: string): boolean {
<ContextNotice
v-else-if="execution.status === 'completed' && showStatusHint && !historical"
:type="
scriptCreation
? result.projectStatus === 'completed'
? 'success'
: result.projectStatus === 'need_review'
? 'warning'
: 'info'
: diagnosisTask
? 'info'
: breakdownInvalid
derivedTask
? derivedNeedsReview
? 'warning'
: keyframeEdit
? result.passed === true
? 'success'
: result.validationSkipped === true
? 'info'
: 'warning'
: videoQuality && staleMotionPlanCount > 0
: 'info'
: scriptCreation
? result.projectStatus === 'completed'
? 'success'
: result.projectStatus === 'need_review'
? 'warning'
: keyframeQuality &&
(!keyframeCounts || keyframeCounts.repairFailed + keyframeCounts.failed > 0)
: 'info'
: diagnosisTask
? 'info'
: breakdownInvalid
? 'warning'
: keyframeEdit
? result.passed === true
? 'success'
: result.validationSkipped === true
? 'info'
: 'warning'
: videoQuality && staleMotionPlanCount > 0
? 'warning'
: 'success'
: keyframeQuality &&
(!keyframeCounts || keyframeCounts.repairFailed + keyframeCounts.failed > 0)
? 'warning'
: 'success'
"
:show-icon="embedded"
:emphasized="embedded"
@@ -391,7 +433,9 @@ function isInputMode(value: unknown, inputMode: string): boolean {
? result.projectStatus === 'need_review'
? '剧本创作任务已结束,审核仍需处理,请查看当前审核结果。'
: '剧本创作任务已结束,可查看最新剧本内容。'
: '本轮任务已结束,可查看最新镜头资产状态。'
: derivedTask
? '本轮派生设计已结束,请分别核对成功、失败及过期记录。'
: '本轮任务已结束,可查看最新镜头资产状态。'
}}
</p>
<p v-if="videoQuality" class="mt-2 text-xs">
@@ -426,7 +470,7 @@ function isInputMode(value: unknown, inputMode: string): boolean {
<template v-else>首帧检查结果尚不完整,请刷新任务详情后核对。</template>
</p>
<p v-else-if="diagnosisTask" class="mt-2 text-xs">具体冲突与证据情况以最新诊断列表为准。</p>
<p v-else-if="!videoQuality && !scriptCreation && !breakdownTask" class="mt-2 text-xs">
<p v-else-if="!videoQuality && !scriptCreation && !breakdownTask && !derivedTask" class="mt-2 text-xs">
共 {{ result.total ?? execution.total }} · 生成 {{ result.generated ?? execution.current }} · 跳过
{{ result.skipped ?? 0 }} · 阻塞 {{ result.blocked ?? 0 }} · 失败 {{ result.failed ?? 0 }}
</p>
@@ -450,6 +494,30 @@ function isInputMode(value: unknown, inputMode: string): boolean {
}}
</p>
</ContextNotice>
<!-- 以下是派生任务的部分成功与失败明细,失败终态也保留已有结果 -->
<div v-if="derivedTask && finished" class="mt-4 space-y-3 text-xs leading-6" aria-label="逐集设计结果">
<p>
共 {{ result.episodeCount ?? '待确认' }} 集 · 已保存 {{ result.completedEpisodes ?? '待确认' }} 集 ·
跳过 {{ result.skippedEpisodes ?? '待确认' }} 集 · 失败 {{ result.failedEpisodes ?? '待确认' }} 集
</p>
<p v-if="derivedNeedsReview" class="text-danger">
已成功结果会保留;请先核对失败剧集和仍过期的设计,不会自动重新提交生成。
</p>
<ul v-if="derivedEpisodes.length" class="space-y-2">
<li v-for="item in derivedEpisodes" :key="item.episodeNo" class="wrap-anywhere">
第 {{ item.episodeNo }} 集 ·
{{
item.error || item.status === 'failed'
? '失败'
: item.status === 'skipped'
? '跳过'
: item.status === 'completed'
? '已保存'
: '状态待确认'
}}<span v-if="item.error">:{{ userFacingText(item.error) }}</span>
</li>
</ul>
</div>
<!-- 以下是诊断中断恢复摘要,未知费用与人工核查直接显示 -->
<div v-if="diagnosisTask && finished" class="mt-3 space-y-2 text-xs" aria-label="动作诊断任务统计">
<p v-if="diagnosisRecovery">需要人工核查:中断时的模型请求可能已产生费用,系统不会自动重新诊断。</p>
+4
View File
@@ -59,6 +59,8 @@ export function executionStageLabel(stage: string | null) {
finishProject: '完成剧本创作',
resumeGeneration: '恢复剧本创作',
resumeRewrite: '恢复剧本改写',
resumeReview: '系统核查剧本',
resolveDramaQuality: '复核剧本疑点',
breakdown: '拆解剧本',
subject_ready: '主体已整理完成',
subject_candidate_ready: '主体候选已就绪',
@@ -255,6 +257,8 @@ export function useWorkflowExecution(
}
const storyboardValidation = result.storyboardShotValidation
const failures =
result.manualReviewRequired === true ||
(typeof result.failedEpisodes === 'number' && result.failedEpisodes > 0) ||
(storyboardValidation &&
typeof storyboardValidation === 'object' &&
'valid' in storyboardValidation &&