import { computed, provide } from 'vue'
import { useRoute } from 'vue-router'
-import { ArrowLeft, RefreshCw, FileText, Layers, Camera, Images, LoaderCircle } from '@lucide/vue'
+import { ArrowLeft, RefreshCw, FileText, Layers, Camera, Images, Palette, Fingerprint, LoaderCircle } from '@lucide/vue'
import { StatusBadge } from '../../components/ui'
import { projectContextKey, useProjectData } from './context'
import { getOperation } from '../workflows/operations'
@@ -39,18 +39,12 @@ const operation = computed(() => getOperation(id.value))
{{ context.error.value }} 当前保留上次成功读取的数据。
diff --git a/src/features/subject-identity/SubjectIdentityPage.vue b/src/features/subject-identity/SubjectIdentityPage.vue
new file mode 100644
index 0000000..b4aa239
--- /dev/null
+++ b/src/features/subject-identity/SubjectIdentityPage.vue
@@ -0,0 +1,317 @@
+
+
+
+
+
+
+
主体身份
+
为同一个人物、场景或道具固定稳定特征，再生成不同造型。
+
+
下一步：形态图片 →
+
+ 人物与场景形态图在有身份母版时自动引用，分别保持人物身份与空间结构；没有母版仍可按原逻辑生图。道具暂不自动引用。旧图不会因母版切换而自动更新。
+
+
+ {{ catalog.error.value || styleQuery.error.value }} 当前操作已暂停，请刷新核对后端。
+
+
+ 先创建项目视觉风格，才能 AI 生成身份或身份图片。设置视觉风格 →
+
+
+ 项目批量生成身份文本
+
+
+
+
+
+ 并发必须是正整数。
+
+ 后端没有全项目身份查询接口；左侧从正式形态目录归并主体，点击后读取其身份。无形态主体暂不在目录展示，但后端批量会处理项目全部主体。
+
+
+
+
+
身份文本批量回执
+
+
+
+ 共 {{ session.receipt.total }} 个主体 · 目标 {{ session.receipt.targetCount }} · 生成
+ {{ session.receipt.generated }} · 跳过 {{ session.receipt.skipped }}（含锁定
+ {{ session.receipt.skippedLocked }}）· 失败 {{ session.receipt.failed }}
+
+
+ 部分主体生成失败，已成功结果保留。请检查失败原因，再补齐或单独生成。
+
+
+ -
+ {{ failure.subjectRef }} · {{ failure.subjectId }}：{{ failure.error }}
+
+
+ 回执仅保留于当前浏览器会话，不代表图片已生成。
+
+
+
+
+
+
当前主体有未保存修改，切换会丢弃草稿。
+
+
+
+
+
+
+
+
+ {{ subject.name }} {{ subject.ref }}
+
+
+ {{
+ identity
+ ? identity.isLocked
+ ? '身份文本已锁定'
+ : '身份文本未锁定'
+ : '尚未创建身份'
+ }}
+
+
+
+
+ {{ detail.error.value }} 查询失败时不允许生成或覆盖。
+
+
+ 正在读取主体身份…
+
+
+
+
+
+ 请先保存身份修改，再使用 AI 或生成图片。
+
+
+
+
+
当前身份母版
+
+ {{
+ subject.module === 'prop'
+ ? '道具形态生图暂不自动引用此母版。'
+ : '后续人物／场景形态图会继承此图的身份或空间结构。'
+ }}
+
+
+
+
此主体的形态
+
+ {{ form.name }}{{ form.isDefault ? ' · 默认' : '' }}
+
+
查看此主体形态图片 →
+
+
+
正在读取正式主体目录…
+ 前往剧本拆解
+
+
+
diff --git a/src/features/subject-identity/api.ts b/src/features/subject-identity/api.ts
new file mode 100644
index 0000000..0da3a18
--- /dev/null
+++ b/src/features/subject-identity/api.ts
@@ -0,0 +1,41 @@
+import { request } from '../../lib/http'
+import type {
+ GenerateIdentityImageInput,
+ IdentityBatchResult,
+ IdentityImage,
+ SaveIdentityInput,
+ SubjectIdentity
+} from './types'
+
+/** 身份接口使用正式 Subject ID，与形态 ID、角色表 ID 分开。 */
+function identityPath(subjectId: string) {
+ return `/subjects/${encodeURIComponent(subjectId)}/identity`
+}
+
+/** 身份文本和参考图分开操作；有费用的请求均不自动重试。 */
+export const subjectIdentityApi = {
+ get: (subjectId: string, signal?: AbortSignal) =>
+ request(identityPath(subjectId), { signal }),
+ save: (subjectId: string, input: SaveIdentityInput) =>
+ request(identityPath(subjectId), { method: 'PUT', body: input }),
+ generate: (subjectId: string, force: boolean) =>
+ request(`${identityPath(subjectId)}/generate`, {
+ method: 'POST',
+ body: { force },
+ timeoutMs: 0
+ }),
+ generateProject: (projectId: string, input: { force: boolean; concurrency: number }) =>
+ request(`/projects/${encodeURIComponent(projectId)}/subject-identities/generate`, {
+ method: 'POST',
+ body: input,
+ timeoutMs: 0
+ }),
+ listImages: (subjectId: string, signal?: AbortSignal) =>
+ request(`${identityPath(subjectId)}/images`, { signal }),
+ generateImage: (subjectId: string, input: GenerateIdentityImageInput) =>
+ request(`${identityPath(subjectId)}/images`, { method: 'POST', body: input, timeoutMs: 0 }),
+ setAnchor: (subjectId: string, imageId: string) =>
+ request(`${identityPath(subjectId)}/images/${encodeURIComponent(imageId)}/anchor`, {
+ method: 'PUT'
+ })
+}
diff --git a/src/features/subject-identity/components/IdentityEditor.vue b/src/features/subject-identity/components/IdentityEditor.vue
new file mode 100644
index 0000000..0716863
--- /dev/null
+++ b/src/features/subject-identity/components/IdentityEditor.vue
@@ -0,0 +1,79 @@
+
+
+
+
+
diff --git a/src/features/subject-identity/components/IdentityGallery.vue b/src/features/subject-identity/components/IdentityGallery.vue
new file mode 100644
index 0000000..0bf980f
--- /dev/null
+++ b/src/features/subject-identity/components/IdentityGallery.vue
@@ -0,0 +1,141 @@
+
+
+
+
+
+
身份参考图 · {{ images.length }}
+ {{ anchor ? '已选母版' : '尚无母版' }}
+
+
+ 身份母版确定“是谁”；形态主图确定“该造型长什么样”。切换母版仅影响之后的生成，不会替换已有形态图、分镜参考图或提示词。
+
+
+
+
+
+ {{
+ selected.isAnchor
+ ? '当前身份母版'
+ : selected.viewType === 'primary'
+ ? '母版候选'
+ : identityViewLabels[selected.viewType]
+ }}{{ selected.enabled ? '启用' : '停用' }} · {{ selected.width || '—' }} ×
+ {{ selected.height || '—' }}
+
+
打开原图
+
{{ selected.error }}
+
+ {{ selected.provider }} · {{ selected.model }} · {{ formatDate(selected.createdAt) }}
+
+
+ 辅助视图不能直接设为母版；可以选它作为参考，另生成一张 primary 候选。
+
+
+
+ 确认切换身份母版？旧 primary
+ 母版将停用并保留。后续人物／场景形态生图会引用新母版，道具暂不自动引用。此操作不调用模型。
+
+
+
+
+
+ 本次实际提示词
+ {{ selected.prompt }}
+
+
+ 本次锚定图片 ID：{{ readImageProvenance(selected.rawJson).referenceImageId }}
+
+ Identity image ID · {{ selected.id }}
+
+
+
尚无身份参考图。先保存身份提示词，再生成第一张母版。
+
+
diff --git a/src/features/subject-identity/components/IdentityImageDialog.vue b/src/features/subject-identity/components/IdentityImageDialog.vue
new file mode 100644
index 0000000..63968b6
--- /dev/null
+++ b/src/features/subject-identity/components/IdentityImageDialog.vue
@@ -0,0 +1,132 @@
+
+
+
+
+
+
+
diff --git a/src/features/subject-identity/identity.test.ts b/src/features/subject-identity/identity.test.ts
new file mode 100644
index 0000000..9468d7e
--- /dev/null
+++ b/src/features/subject-identity/identity.test.ts
@@ -0,0 +1,124 @@
+import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
+import { afterEach, describe, expect, it } from 'vitest'
+import IdentityImageDialog from './components/IdentityImageDialog.vue'
+import IdentityGallery from './components/IdentityGallery.vue'
+import { canBeAnchor, currentAnchor, groupIdentitySubjects, readImageProvenance } from './model'
+import { identityImageFixture } from './testing/fixtures'
+import { formFixture } from '../subject-images/testing/fixtures'
+
+let wrapper: VueWrapper | undefined
+afterEach(() => {
+ wrapper?.unmount()
+ wrapper = undefined
+ document.body.innerHTML = ''
+})
+
+/** 从真实 Reka Portal 内获取确认按钮。 */
+function button(label: string) {
+ const item = [...document.querySelectorAll('button')].find(element => element.textContent?.trim() === label)
+ if (!item) throw new Error(`缺少按钮 ${label}`)
+ return item
+}
+
+/** 修改 Portal 表单控件并触发 Vue 绑定。 */
+function input(selector: string, value: string) {
+ const item = document.querySelector(selector)!
+ item.value = value
+ item.dispatchEvent(new Event(item.tagName === 'SELECT' ? 'change' : 'input', { bubbles: true }))
+}
+
+describe('身份图与母版契约', () => {
+ it('启用的辅助视角不是母版，primary 候选停用时仍可选为母版', () => {
+ const front = identityImageFixture({ id: 'front', viewType: 'front', isAnchor: false })
+ const candidate = identityImageFixture({ id: 'candidate', enabled: false, isAnchor: false })
+ expect(canBeAnchor(front)).toBe(false)
+ expect(canBeAnchor(candidate)).toBe(true)
+ expect(currentAnchor([front, candidate])).toBeUndefined()
+ expect(canBeAnchor(identityImageFixture({ status: 'failed' }))).toBe(false)
+ expect(canBeAnchor(identityImageFixture({ imageUrl: null }))).toBe(false)
+ })
+
+ it('正式主体关联校验不接受不同主体的 form，追溯 JSON 兼容旧数据', () => {
+ expect(() => groupIdentitySubjects([{ ...formFixture(), subjectId: 'wrong' }])).toThrow('不匹配')
+ expect(readImageProvenance('{bad')).toEqual({})
+ expect(readImageProvenance(null)).toEqual({})
+ expect(readImageProvenance('{"identityAnchorImageId":"anchor","referenceImageId":7}')).toMatchObject({
+ identityAnchorImageId: 'anchor',
+ referenceImageId: undefined
+ })
+ })
+
+ it('辅助视角传递明确参考图、成对尺寸和本次 Prompt，不传形态生图字段', async () => {
+ wrapper = mount(IdentityImageDialog, {
+ attachTo: document.body,
+ props: {
+ open: true,
+ subjectId: 's1',
+ subjectName: '林夏',
+ images: [identityImageFixture()],
+ disabled: false
+ }
+ })
+ await flushPromises()
+ input('#identity-view', 'three-quarter')
+ input('#identity-reference', 'identity-image-1')
+ input('#identity-width', '2048')
+ document.querySelector('#identity-image-cost')!.click()
+ await flushPromises()
+ expect(button('确认生成身份图').disabled).toBe(true)
+ input('#identity-height', '2048')
+ input('#identity-image-prompt', ' 自定义身份提示词 ')
+ await flushPromises()
+ button('确认生成身份图').click()
+ await flushPromises()
+ expect(wrapper.emitted('generate')).toEqual([
+ [
+ {
+ provider: 'seedream',
+ viewType: 'three-quarter',
+ referenceImageId: 'identity-image-1',
+ width: 2048,
+ height: 2048,
+ prompt: '自定义身份提示词'
+ }
+ ]
+ ])
+ })
+
+ it('切换主体清空生图配置和费用确认，失效参考图不能提交', async () => {
+ wrapper = mount(IdentityImageDialog, {
+ attachTo: document.body,
+ props: {
+ open: true,
+ subjectId: 's1',
+ subjectName: '林夏',
+ images: [identityImageFixture()],
+ disabled: false
+ }
+ })
+ await flushPromises()
+ input('#identity-reference', 'identity-image-1')
+ document.querySelector('#identity-image-cost')!.click()
+ await flushPromises()
+ await wrapper.setProps({ images: [] })
+ expect(button('确认生成身份图').disabled).toBe(true)
+ await wrapper.setProps({ subjectId: 's2', subjectName: '陆川' })
+ expect(document.querySelector('#identity-reference')!.value).toBe('')
+ expect(document.querySelector('#identity-image-cost')!.checked).toBe(false)
+ })
+
+ it('辅助图不能切换母版，提示词按纯文本展示', async () => {
+ wrapper = mount(IdentityGallery, {
+ attachTo: document.body,
+ props: {
+ subjectName: '林夏',
+ disabled: false,
+ images: [identityImageFixture({ viewType: 'front', isAnchor: false })]
+ }
+ })
+ expect(button('设为身份母版').disabled).toBe(true)
+ expect(wrapper.text()).toContain('')
+ expect(wrapper.find('script').exists()).toBe(false)
+ expect(wrapper.emitted('anchor')).toBeUndefined()
+ })
+})
diff --git a/src/features/subject-identity/index.ts b/src/features/subject-identity/index.ts
new file mode 100644
index 0000000..c5e39b4
--- /dev/null
+++ b/src/features/subject-identity/index.ts
@@ -0,0 +1,4 @@
+/** 主体身份模块公共入口。 */
+export { subjectIdentityApi } from './api'
+export { currentAnchor, readImageProvenance } from './model'
+export type { SubjectIdentity, IdentityImage, GenerateIdentityImageInput } from './types'
diff --git a/src/features/subject-identity/model.ts b/src/features/subject-identity/model.ts
new file mode 100644
index 0000000..f39eb6b
--- /dev/null
+++ b/src/features/subject-identity/model.ts
@@ -0,0 +1,60 @@
+import { reactive } from 'vue'
+import type { SubjectFormAsset } from '../subject-images/types'
+import type { IdentityBatchResult, IdentityImage, IdentitySubject } from './types'
+
+/** 视角名称保持与后端四种固定值对应。 */
+export const identityViewLabels = {
+ primary: '身份母版',
+ front: '正面',
+ 'three-quarter': '三分之四侧面',
+ 'full-body': '全身'
+} as const
+
+/** 将同一主体的多个形态归并成一条，避免为每个形态重复创建 Identity。 */
+export function groupIdentitySubjects(forms: SubjectFormAsset[]): IdentitySubject[] {
+ const subjects = new Map()
+ for (const form of forms) {
+ if (form.subjectId !== form.subject.id) throw new Error('形态与主体 ID 不匹配，请刷新后重试。')
+ const subject = subjects.get(form.subjectId) ?? { ...form.subject, forms: [] }
+ subject.forms.push(form)
+ subjects.set(form.subjectId, subject)
+ }
+ return [...subjects.values()]
+}
+
+/** 只有成功且有图片的 primary 候选可成为母版；停用候选也允许重新启用。 */
+export function canBeAnchor(image: IdentityImage): boolean {
+ return image.viewType === 'primary' && image.status === 'completed' && !!image.imageUrl
+}
+
+/** 使用后端 isAnchor，不把 front/full-body 的 enabled 错当成母版。 */
+export function currentAnchor(images: IdentityImage[]): IdentityImage | undefined {
+ return images.find(image => image.isAnchor && image.enabled && canBeAnchor(image))
+}
+
+/** 仅读取追溯所需 ID，不把原始 Provider 数据渲染为 HTML。 */
+export function readImageProvenance(rawJson?: string | null): {
+ referenceImageId?: string
+ identityAnchorImageId?: string
+} {
+ try {
+ const parsed: unknown = JSON.parse(rawJson || '{}')
+ if (!parsed || typeof parsed !== 'object') return {}
+ const value = parsed as Record
+ return {
+ referenceImageId: typeof value.referenceImageId === 'string' ? value.referenceImageId : undefined,
+ identityAnchorImageId:
+ typeof value.identityAnchorImageId === 'string' ? value.identityAnchorImageId : undefined
+ }
+ } catch {
+ return {}
+ }
+}
+
+/** 批量回执按项目保存在当前会话，切页不丢失，刷新浏览器后不伪造恢复。 */
+const sessions = reactive>({})
+
+/** 取得指定项目的身份文本批量回执。 */
+export function getIdentitySession(projectId: string) {
+ return (sessions[projectId] ??= { receipt: null })
+}
diff --git a/src/features/subject-identity/testing/fixtures.ts b/src/features/subject-identity/testing/fixtures.ts
new file mode 100644
index 0000000..0821ab1
--- /dev/null
+++ b/src/features/subject-identity/testing/fixtures.ts
@@ -0,0 +1,39 @@
+import type { IdentityImage, SubjectIdentity } from '../types'
+
+/** 身份文本测试数据；subjectId 使用正式数据库主体 ID。 */
+export function identityFixture(overrides: Partial = {}): SubjectIdentity {
+ return {
+ id: 'identity-db-1',
+ subjectId: 'subject-db-1',
+ description: '稳定面部特征',
+ generationPrompt: '保持相同五官与骨相',
+ isLocked: false,
+ images: [],
+ createdAt: '2026-08-28T00:00:00Z',
+ updatedAt: '2026-08-28T00:00:00Z',
+ ...overrides
+ }
+}
+
+/** 专用身份图库查询包含 isAnchor，辅助视角即使启用也不是母版。 */
+export function identityImageFixture(overrides: Partial = {}): IdentityImage {
+ return {
+ id: 'identity-image-1',
+ identityId: 'identity-db-1',
+ source: 'generated',
+ viewType: 'primary',
+ provider: 'seedream',
+ model: 'configured-model',
+ prompt: '',
+ imageUrl: '/storage/identity.png',
+ width: 2048,
+ height: 2048,
+ status: 'completed',
+ enabled: true,
+ isAnchor: true,
+ error: null,
+ createdAt: '2026-08-28T00:00:00Z',
+ updatedAt: '2026-08-28T00:00:00Z',
+ ...overrides
+ }
+}
diff --git a/src/features/subject-identity/types.ts b/src/features/subject-identity/types.ts
new file mode 100644
index 0000000..3b2a7ce
--- /dev/null
+++ b/src/features/subject-identity/types.ts
@@ -0,0 +1,66 @@
+import type { SubjectImageStatus, SubjectFormAsset } from '../subject-images/types'
+
+/** 只有 primary 视图可以选为身份母版，其余视图是辅助参考。 */
+export type IdentityViewType = 'primary' | 'front' | 'three-quarter' | 'full-body'
+
+/** 身份参考图；isAnchor 仅由专用图片查询接口返回，不能用 enabled 代替。 */
+export interface IdentityImage {
+ id: string
+ identityId: string
+ source: 'upload' | 'generated'
+ viewType: IdentityViewType
+ provider: string | null
+ model: string | null
+ prompt: string | null
+ imageUrl: string | null
+ width: number | null
+ height: number | null
+ status: SubjectImageStatus
+ enabled: boolean
+ isAnchor?: boolean
+ error: string | null
+ rawJson?: string | null
+ createdAt: string
+ updatedAt: string
+}
+
+/** 稳定身份描述及生图提示词，不混入具体形态的临时状态。 */
+export interface SubjectIdentity {
+ id: string
+ subjectId: string
+ description: string | null
+ generationPrompt: string | null
+ isLocked: boolean
+ images: IdentityImage[]
+ createdAt: string
+ updatedAt: string
+}
+
+/** 从正式形态目录归并主体，不使用 checkpoint 的候选 ID。 */
+export type IdentitySubject = SubjectFormAsset['subject'] & {
+ forms: SubjectFormAsset[]
+}
+
+/** 人工保存身份；锁定只保护 AI 文本重生成，不限制人工保存或生图。 */
+export type SaveIdentityInput = Partial>
+
+/** 单张身份生图；空 referenceImageId 应省略，由后端自动引用当前母版。 */
+export interface GenerateIdentityImageInput {
+ provider: 'seedream'
+ viewType: IdentityViewType
+ referenceImageId?: string
+ prompt?: string
+ width?: number
+ height?: number
+}
+
+/** 身份文本批量生成回执，不代表已生成参考图。 */
+export interface IdentityBatchResult {
+ total: number
+ targetCount: number
+ generated: number
+ skipped: number
+ skippedLocked: number
+ failed: number
+ failures: { subjectId: string; subjectRef: string; error: string }[]
+}
diff --git a/src/features/subject-identity/useSubjectIdentity.ts b/src/features/subject-identity/useSubjectIdentity.ts
new file mode 100644
index 0000000..7b67ac9
--- /dev/null
+++ b/src/features/subject-identity/useSubjectIdentity.ts
@@ -0,0 +1,201 @@
+import { computed, ref, watch } from 'vue'
+import { usePolling } from '../../composables/usePolling'
+import { visualStyleApi } from '../visual-style'
+import { subjectImagesApi } from '../subject-images/api'
+import { hasRunningImages } from '../subject-images/model'
+import { runOperation } from '../workflows/operations'
+import { useProjectMutationGuard } from '../workflows/useProjectMutationGuard'
+import { subjectIdentityApi } from './api'
+import { canBeAnchor, getIdentitySession, groupIdentitySubjects } from './model'
+import type { GenerateIdentityImageInput, IdentityImage, SaveIdentityInput, SubjectIdentity } from './types'
+
+/** 单主体保存响应必须与提交时固定的正式 ID 一致。 */
+function assertIdentity(value: SubjectIdentity, id: string) {
+ if (!value || value.subjectId !== id || value.images.some(image => image.identityId !== value.id))
+ throw new Error('后端未返回匹配的主体身份，请刷新核对。')
+}
+
+/** 主体目录、项目风格和当前身份分开查询，未创建 Identity 不误报为空图库错误。 */
+export function useSubjectIdentity() {
+ const { projectId, operation, blocked: projectBlocked } = useProjectMutationGuard()
+ const selectedId = ref('')
+ const editorRevision = ref(0)
+ const dirty = ref(false)
+ const concurrency = ref(3)
+ const force = ref(false)
+ const catalog = usePolling(projectId, async (id, signal) => {
+ const forms = await subjectImagesApi.listForms(id, signal)
+ if (
+ forms.some(
+ form => form.subject.projectId !== id || form.images.some(image => image.subjectFormId !== form.id)
+ )
+ )
+ throw new Error('主体目录与当前项目不匹配，请刷新后重试。')
+ return { subjects: groupIdentitySubjects(forms), running: forms.some(form => hasRunningImages(form.images)) }
+ })
+ const styleQuery = usePolling(projectId, async (id, signal) => {
+ const style = await visualStyleApi.get(id, signal)
+ if (style && style.projectId !== id) throw new Error('视觉风格与当前项目不匹配。')
+ return { style }
+ })
+ const subjects = computed(() => catalog.data.value?.subjects ?? [])
+ const subject = computed(() => subjects.value.find(item => item.id === selectedId.value))
+ const selectionKey = computed(() => subject.value?.id ?? '')
+ const detail = usePolling(selectionKey, async (id, signal) => {
+ if (!id) return null
+ const identity = await subjectIdentityApi.get(id, signal)
+ if (!identity) return { identity: null, images: [] as IdentityImage[] }
+ assertIdentity(identity, id)
+ const images = await subjectIdentityApi.listImages(id, signal)
+ if (images.some(image => image.identityId !== identity.id)) throw new Error('身份图片与当前主体不匹配。')
+ return { identity, images }
+ })
+ const identity = computed(() => detail.data.value?.identity ?? null)
+ const images = computed(() => detail.data.value?.images ?? [])
+ const session = computed(() => getIdentitySession(projectId.value))
+ const blocked = computed(
+ () =>
+ projectBlocked.value ||
+ !!catalog.error.value ||
+ !catalog.data.value ||
+ !!catalog.data.value.running ||
+ !!styleQuery.error.value ||
+ !styleQuery.data.value
+ )
+ const detailBlocked = computed(
+ () =>
+ blocked.value ||
+ !subject.value ||
+ !detail.data.value ||
+ !!detail.error.value ||
+ hasRunningImages(images.value)
+ )
+ const hasStyle = computed(() => !!styleQuery.data.value?.style)
+ const canGenerateText = computed(
+ () => !detailBlocked.value && hasStyle.value && !identity.value?.isLocked && !dirty.value
+ )
+ const canGenerateImage = computed(
+ () => !detailBlocked.value && hasStyle.value && !!identity.value?.generationPrompt?.trim() && !dirty.value
+ )
+ const batchValid = computed(() => Number.isSafeInteger(concurrency.value) && concurrency.value > 0)
+
+ watch(subjects, rows => {
+ if (!rows.some(item => item.id === selectedId.value)) selectedId.value = rows[0]?.id ?? ''
+ })
+ watch(selectionKey, () => {
+ dirty.value = false
+ editorRevision.value++
+ })
+
+ /** 长请求跨主体切换后只更新原项目的操作回执，不用旧响应覆盖新主体。 */
+ async function writeIdentity(label: string, action: (id: string) => Promise) {
+ if (detailBlocked.value || !subject.value) return
+ const id = subject.value.id
+ const project = projectId.value
+ const ok = await runOperation(project, label, async () => {
+ const result = await action(id)
+ assertIdentity(result, id)
+ if (selectionKey.value === id && projectId.value === project) {
+ // 图片的 isAnchor 只能从专用查询获取，保存文本时暂时保留已有图片列表。
+ detail.data.value = { identity: result, images: images.value }
+ editorRevision.value++
+ dirty.value = false
+ }
+ })
+ if (ok) await detail.refresh()
+ }
+
+ /** 人工保存可修改已锁定身份；锁定只阻止自动重生成。 */
+ function save(input: SaveIdentityInput) {
+ return writeIdentity('保存主体身份', id => subjectIdentityApi.save(id, input))
+ }
+
+ /** 单主体 AI 生成与已存在文本的覆盖均需要页面确认。 */
+ function generate() {
+ if (!canGenerateText.value) return
+ const overwrite = !!identity.value
+ return writeIdentity('AI 生成主体身份', id => subjectIdentityApi.generate(id, overwrite))
+ }
+
+ /** 批量仅生成身份文本，已锁定项由后端跳过，回执保留部分失败。 */
+ async function generateProject() {
+ if (blocked.value || !hasStyle.value || !batchValid.value || dirty.value || !subjects.value.length) return
+ const id = projectId.value
+ const target = getIdentitySession(id)
+ const input = { concurrency: concurrency.value, force: force.value }
+ target.receipt = null
+ await runOperation(id, '批量生成主体身份文本', async () => {
+ target.receipt = await subjectIdentityApi.generateProject(id, input)
+ })
+ await detail.refresh()
+ }
+
+ /** 生图不修改文字锁定；即使有自定义 Prompt，也需已有身份 Prompt 与项目风格。 */
+ async function generateImage(input: GenerateIdentityImageInput) {
+ if (!canGenerateImage.value || !subject.value || !identity.value) return
+ if (
+ input.referenceImageId &&
+ !images.value.some(
+ image => image.id === input.referenceImageId && image.status === 'completed' && image.imageUrl
+ )
+ )
+ return
+ const id = subject.value.id
+ const identityId = identity.value.id
+ await runOperation(projectId.value, `生成 ${subject.value.name} 身份参考图`, async () => {
+ const image = await subjectIdentityApi.generateImage(id, input)
+ if (!image || image.identityId !== identityId || image.status !== 'completed' || !image.imageUrl)
+ throw new Error(image?.error || '后端未返回已完成的身份图片，请先刷新核对，不要立即重复生图。')
+ })
+ await detail.refresh()
+ }
+
+ /** 候选切换母版只允许成功的 primary 图，不能将辅助视角直接升级为母版。 */
+ async function setAnchor(imageId: string) {
+ const image = images.value.find(item => item.id === imageId)
+ if (detailBlocked.value || !subject.value || !image || !canBeAnchor(image) || image.isAnchor) return
+ const id = subject.value.id
+ const identityId = image.identityId
+ await runOperation(projectId.value, '切换主体身份母版', async () => {
+ const result = await subjectIdentityApi.setAnchor(id, imageId)
+ if (
+ !result ||
+ result.id !== imageId ||
+ result.identityId !== identityId ||
+ !result.enabled ||
+ !canBeAnchor(result)
+ )
+ throw new Error('接口未确认身份母版切换，请刷新核对。')
+ })
+ await detail.refresh()
+ }
+
+ return {
+ projectId,
+ operation,
+ selectedId,
+ subject,
+ subjects,
+ catalog,
+ styleQuery,
+ detail,
+ identity,
+ images,
+ session,
+ concurrency,
+ force,
+ editorRevision,
+ dirty,
+ blocked,
+ detailBlocked,
+ hasStyle,
+ canGenerateText,
+ canGenerateImage,
+ batchValid,
+ save,
+ generate,
+ generateProject,
+ generateImage,
+ setAnchor
+ }
+}
diff --git a/src/features/subject-images/SubjectImagesPage.vue b/src/features/subject-images/SubjectImagesPage.vue
index 4bd3c15..2619bf7 100644
--- a/src/features/subject-images/SubjectImagesPage.vue
+++ b/src/features/subject-images/SubjectImagesPage.vue
@@ -86,12 +86,17 @@ function resetFilters() {
形态图片
-
为人物、场景和道具准备参考图。已有图片直接从数据库读取。
+
为人物、场景和道具准备造型参考图。已有图片直接从数据库读取。
去检查分镜参考图
+
+ 人物与场景形态在有身份母版时自动引用，以保持人物身份或空间结构一致；无母版仍可独立生成。道具暂不自动引用。
+ 管理主体身份 →
+ 更换母版后，已有形态主图仍保留，需主动生图并选择新主图。
+
@@ -208,6 +213,11 @@ function resetFilters() {
{{ form.description }}
+
查看主体身份与母版 →