Files
short-drama-agent-front/src/features/subject-identity/components/IdentityImageCard.vue
T

352 lines
16 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<script setup lang="ts">
import { computed, ref, watch } from 'vue'
import { NButton, NPopover, NScrollbar, NTag } from 'naive-ui'
import { AppDialog, AssetImage, AssetOpenLink, StatusBadge } from '../../../components/ui'
import { formatDate } from '../../../lib/format'
import ConfirmAction from '../../workflows/ConfirmAction.vue'
import { canBeAnchor, identityViewLabels } from '../model'
import { imageValidationPassed } from '../../subject-images/validation'
import type { IdentityImage, IdentityImageOperation, IdentityValidationResult } from '../types'
/** 母版与候选共用图片卡片,操作始终绑定卡片的正式图片编号。 */
const props = defineProps<{
/** 此卡片对应的正式图片。 */
image: IdentityImage
/** 当前主体名称。 */
subjectName: string
/** 主体类型,决定确认选角或切换普通母版。 */
module: string
/** 身份是否已经锁定。 */
identityLocked: boolean
/** 当前项目或主体是否禁止写入。 */
disabled: boolean
/** 当前固定目标的图片操作。 */
pendingOperation?: IdentityImageOperation | null
/** 当前正在读取历史审核的候选编号。 */
readingSavedReviewId?: string
/** 重新生成暂不可用的具体恢复步骤。 */
retryDisabledReason?: string
/** 当前母版的使用说明,候选卡片不展示。 */
description?: string
/** 候选管理是否可见,关闭管理弹窗时同步收起错误浮层。 */
active?: boolean
/** 只用于同一候选的已知审核证据。 */
validationResult?: IdentityValidationResult | null
}>()
/** 卡片只请求父页面执行操作,不直接调用模型或修改母版。 */
const emit = defineEmits<{
/** 确认指定图片作为母版。 */
anchor: [imageId: string]
/** 校验指定图片。 */
validate: [imageId: string]
/** 只读查看已保存的审核。 */
readReview: [imageId: string]
/** 打开失败图片对应的生成参数弹窗。 */
regenerate: [imageId: string]
}>()
/** 当前卡片的母版确认弹窗开关。 */
const confirming = ref(false)
/** 失败详情按需展示在浮层中,避免长错误文本撑高候选卡片。 */
const failureDetailsOpen = ref(false)
/** 角色使用选角确认事务,场景和道具使用稳定母版事务。 */
const character = computed(() => props.module === 'character')
/** 只为当前图片的确认请求显示加载。 */
const confirmLoading = computed(
() => props.pendingOperation?.imageId === props.image.id && props.pendingOperation.kind === 'confirm'
)
/** 只为当前图片的校验请求显示加载。 */
const validateLoading = computed(
() => props.pendingOperation?.imageId === props.image.id && props.pendingOperation.kind === 'validate'
)
/** 当前图片需要具备刚刚读取的明确审核结果。 */
const quality = computed(() =>
props.validationResult?.imageId === props.image.id
? imageValidationPassed(props.validationResult, props.module)
: null
)
/** 只有完成的 primary 可以确认,已锁定的当前母版不提供重复确认。 */
const canSelect = computed(
() =>
!props.disabled &&
!props.pendingOperation &&
canBeAnchor(props.image) &&
quality.value === true &&
(!props.image.isAnchor || (character.value && !props.identityLocked))
)
/** 卡片标识区分身份母版、母版候选和辅助视角,不重复强调当前状态。 */
const imageLabel = computed(() =>
props.image.isAnchor
? '已确认母版'
: props.image.viewType === 'primary'
? props.image.status === 'completed'
? '母版候选 · 未确认'
: '母版候选'
: identityViewLabels[props.image.viewType]
)
/** 后台重启表示原请求结果未知,不能误导用户直接调整模型参数。 */
const failureNotice = computed(() => {
if (props.image.status !== 'failed') return null
const error = props.image.error?.trim() ?? ''
if (error.includes('服务重启时图片 Provider 请求状态不可恢复'))
return {
title: '图片生成中断,结果未确认',
description:
'后台服务重启,无法确认图片服务是否已完成原请求。系统未自动重试,以免重复生成和计费。请先到图片服务平台核对原任务结果,再决定是否重新生成。'
}
return { title: '本次图片生成失败', description: error || '图片服务未返回具体原因,请核对服务状态与生成参数。' }
})
/** 失败记录按原图片类型提供明确的重新生成入口。 */
const regenerateLabel = computed(() =>
props.image.viewType !== 'primary'
? '重新生成辅助参考图'
: character.value
? '重新生成角色候选图'
: '重新生成母版候选'
)
/** 已有请求、草稿或缺少前置配置时禁止重复生成。 */
const regenerateDisabled = computed(() => props.disabled || !!props.pendingOperation || !!props.retryDisabledReason)
/** 卡片被复用为其它图片或已确认为母版时,关闭旧目标的确认弹窗。 */
watch([() => props.image.id, () => props.image.isAnchor, () => props.identityLocked], () => {
confirming.value = false
})
/** 切换图片、任务状态变化或关闭候选弹窗时清理旧记录的错误浮层。 */
watch([() => props.image.id, () => props.image.status, () => props.active], () => {
failureDetailsOpen.value = false
})
/** 母版影响已由用户明确确认后,提交此卡片固定的图片编号。 */
function chooseAnchor() {
if (!canSelect.value || !confirming.value) return
emit('anchor', props.image.id)
confirming.value = false
}
/** 重新生成仅打开参数设置,失败记录自身不会被覆盖。 */
function regenerate() {
if (regenerateDisabled.value || props.image.status !== 'failed') return
failureDetailsOpen.value = false
emit('regenerate', props.image.id)
}
</script>
<template>
<article class="identity-image-card" :aria-label="`身份图片 ${image.id}`">
<!-- 以下是方形身份图片与原图预览入口模块 -->
<div class="relative">
<AssetImage
:src="image.status === 'completed' ? image.imageUrl : null"
:alt="`${subjectName} · ${imageLabel}`"
object-fit="cover"
preview
:empty-text="
{ pending: '排队中', generating: '生成中', failed: '生成失败', completed: '图片缺失' }[image.status]
"
/>
<AssetOpenLink :src="image.status === 'completed' ? image.imageUrl : null" label="打开身份图片" />
</div>
<!-- 以下是图片标识、尺寸和时间模块,母版锁定状态与身份标识同一行显示 -->
<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-else-if="!image.isAnchor && !failureNotice"
:status="image.status"
:label="image.status === 'pending' ? '排队中' : undefined"
/>
<!-- 以下是失败标签的详情浮层模块,点击或键盘激活标签即可查看原因。 -->
<NPopover
v-if="failureNotice"
v-model:show="failureDetailsOpen"
trigger="click"
placement="top-start"
:to="true"
:flip="true"
:disabled="active === false"
class="identity-failure-popover"
@keydown.esc.stop="failureDetailsOpen = false"
>
<template #trigger>
<button
type="button"
class="identity-failure-trigger"
aria-label="生成失败,查看失败原因"
:aria-expanded="failureDetailsOpen"
:disabled="active === false"
@keydown.esc.stop="failureDetailsOpen = false"
>
<StatusBadge :status="image.status" />
</button>
</template>
<!-- 浮层挂到视口层避免裁剪,详情超出可用高度时由 NScrollbar 滚动。 -->
<NScrollbar class="identity-failure-scroll">
<div class="identity-image-failure text-xs leading-6">
<p class="font-semibold text-danger">{{ failureNotice.title }}</p>
<p class="mt-2">{{ failureNotice.description }}</p>
<p v-if="retryDisabledReason" class="mt-2 text-muted">{{ retryDisabledReason }}</p>
</div>
</NScrollbar>
</NPopover>
<NTag size="small" :bordered="false">{{ imageLabel }}</NTag>
<NTag
v-if="image.status === 'completed' && !image.isAnchor && image.viewType === 'primary'"
size="small"
:bordered="false"
>
{{ quality === null ? '待审核' : quality ? '审核通过' : '审核未通过或待复核' }}
</NTag>
<!-- 以下是母版身份锁定状态模块,紧邻图片下方的身份母版标签。 -->
<NTag
v-if="image.isAnchor"
size="small"
:bordered="false"
:type="identityLocked ? 'success' : 'default'"
>
{{ identityLocked ? '已确认并锁定' : '待锁定' }}
</NTag>
</div>
<!-- 以下是同一行的尺寸与时间模块,尺寸缺失时仍保持时间靠右对齐。 -->
<div class="identity-image-meta">
<span v-if="image.width && image.height">{{ image.width }} × {{ image.height }}</span>
<time :datetime="image.createdAt">{{ formatDate(image.createdAt) }}</time>
</div>
<p v-if="description" class="text-xs leading-6 text-muted">{{ description }}</p>
<p v-if="image.viewType !== 'primary'" class="text-xs leading-6 text-muted">
辅助参考图继承当前母版,不能直接设为身份母版。
</p>
<!-- 以下是失败记录的重试模块,具体原因通过上方失败标签查看。 -->
<div v-if="failureNotice" class="identity-image-actions" role="group" aria-label="失败图片恢复操作">
<NButton size="small" :disabled="regenerateDisabled" type="primary" @click="regenerate">{{
regenerateLabel
}}</NButton>
</div>
<!-- 以下是固定图片目标的母版确认与校验模块,结果沿用 NMessage -->
<div
v-if="image.status === 'completed' && image.imageUrl"
class="identity-image-actions"
role="group"
aria-label="当前身份图片操作"
>
<NButton
v-if="image.viewType === 'primary' && (!image.isAnchor || (character && !identityLocked))"
:disabled="!canSelect"
:loading="confirmLoading"
:aria-label="character ? '确认选角并锁定' : '设为身份母版'"
:aria-busy="confirmLoading"
type="primary"
size="small"
@click="confirming = true"
>
{{ character ? '确认选角并锁定' : '设为身份母版' }}
</NButton>
<!-- 以下是角色候选的只读审核入口。 -->
<NButton
v-if="character && image.viewType === 'primary'"
size="small"
:loading="readingSavedReviewId === image.id"
:disabled="readingSavedReviewId === image.id"
@click="emit('readReview', image.id)"
>查看已保存审核</NButton
>
<ConfirmAction
:key="image.id"
label="校验此身份图片"
description="将核对当前候选,可能调用视觉模型并产生费用。审核后仍需人工确认母版。"
:disabled="disabled || !!pendingOperation || image.viewType !== 'primary'"
:loading="validateLoading"
acknowledgement
@confirm="emit('validate', image.id)"
/>
</div>
</div>
<!-- 以下是明确母版影响的人工确认弹窗模块 -->
<AppDialog
v-model:open="confirming"
:title="character ? '确认选角并锁定' : '确认切换身份母版'"
:description="
character
? `确认将这张图片作为 ${subjectName} 的角色母版并锁定身份?后续图片生成会使用这张母版。`
: `确认切换 ${subjectName} 的身份母版?旧母版会保留在候选记录中,后续形态图片生成会使用新母版。`
"
>
<!-- 以下是身份母版采纳的费用与门禁说明模块 -->
<p class="text-sm leading-7 text-muted">
{{
character
? '将复核已保存的质量证据,通过后锁定并采纳。'
: '将复核已保存的质量证据。若审核记录失效,服务可能再次调用视觉模型并产生费用。'
}}
</p>
<template #footer>
<NButton @click="confirming = false">取消</NButton>
<NButton :disabled="!canSelect" type="primary" @click="chooseAnchor">{{
character ? '确认演员选择' : '确认费用并切换母版'
}}</NButton>
</template>
</AppDialog>
</article>
</template>
<style>
@reference "../../../styles/styles.css";
/* 候选卡片与弹窗底色区分,方形画面保留顶部裁切与完整原图预览。 */
.identity-image-card {
@apply min-w-0 max-w-full overflow-hidden bg-(--app-subtle);
}
.identity-image-card .asset-image {
@apply aspect-square;
}
.identity-image-card-body {
@apply p-3 grid min-w-0 gap-2 wrap-anywhere;
}
.identity-image-meta {
@apply flex min-h-4 min-w-0 items-center justify-between gap-2 text-[10px] text-muted;
}
.identity-image-meta > time {
@apply ml-auto shrink-0 whitespace-nowrap;
}
.identity-failure-trigger {
@apply inline-flex items-center border-0 bg-transparent p-0;
}
.identity-image-actions {
@apply mt-2 grid min-w-0 grid-flow-col auto-cols-fr items-stretch gap-2;
}
.identity-image-actions > .confirm-action {
@apply min-w-0 max-w-full;
}
.identity-image-card .identity-image-actions > .n-button,
.identity-image-card .identity-image-actions > .confirm-action {
@apply w-full;
}
.identity-image-card .identity-image-actions > .confirm-action > .n-button {
@apply w-full;
height: 100%;
}
/* 操作最多两项并等分一行,窄屏长文案自然换行,单项占满整行。 */
.identity-image-card .identity-image-actions .n-button {
height: auto;
min-height: 28px;
font-size: 12px;
padding-inline: 8px;
padding-block: 4px;
}
.identity-image-card .identity-image-actions .n-button__content {
@apply whitespace-normal text-center leading-5;
}
/* 错误浮层独立于卡片布局,保留浮层箭头,滚动交由 NScrollbar。 */
.identity-failure-popover.n-popover {
box-sizing: border-box;
width: min(360px, calc(100vw - 48px));
}
/* 为浮层内边距预留空间,短内容保持自然高度,长内容不撑出视口。 */
.identity-failure-scroll.n-scrollbar {
max-height: min(388px, calc(100dvh - 80px));
}
.identity-failure-scroll > .n-scrollbar-container {
overscroll-behavior: contain;
}
.identity-image-failure {
@apply whitespace-pre-wrap wrap-anywhere;
}
</style>