diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..fa15fc2 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,19 @@ +# 项目协作规范 + +## 默认分支与工作目录 + +- 新增功能、新增文件、修复问题和重构,默认全部在本项目根目录的 `dev` 分支进行。 +- 开始修改前先确认当前分支。若不在 `dev`,应保留现有修改并安全切换到 `dev`,不得丢弃或覆盖用户已有工作。 +- 不创建新的 Git worktree,不在 `worktree`、`worktrees`、`.worktree` 或 `.worktrees` 目录中新增或修改文件。 +- 不因技能、模板或默认隔离流程而创建工作树;本规则覆盖此前“新功能在 worktree 中开发”的项目约定。 +- 已有工作树仅在用户要求迁回改动时作为只读来源;迁回后在项目根目录的 `dev` 分支继续修改和验证。 +- 未经用户明确要求,不提交代码、不推送、不切换或合并到其他发布分支。 + +## 开发与验证 + +- 尽量使用中文沟通,沿用项目现有的 Vue 3、TypeScript、Tailwind CSS 和 pnpm 约定。 +- 新增或修改的函数、类型、响应式状态及页面模块需要中文注释;函数有参数或返回值时补充 `@param`、`@returns`。 +- 超过两个位置使用的相同功能或组件,应抽成公共方法或组件。 +- 页面和交互验证使用本地 Chrome,地址使用 `localhost`,禁止使用 Playwright;已有对应测试标签页时复用它。 +- 以真实接口和后端契约为准,不用占位数据或其他功能代替缺失能力。 +- 提交代码时遵循项目的 Conventional Commits 规范,使用中文描述;提交前先检查实际差异。 diff --git a/docs/superpowers/plans/2026-10-12-identity-anchor-reuse.md b/docs/superpowers/plans/2026-10-12-identity-anchor-reuse.md new file mode 100644 index 0000000..12954aa --- /dev/null +++ b/docs/superpowers/plans/2026-10-12-identity-anchor-reuse.md @@ -0,0 +1,48 @@ +# 基础形态复用身份母版 Implementation Plan + +**Goal:** 默认形态在满足锁定与母版条件时直接使用身份图片,形态 API、就绪检查和分镜参考图共享同一真实数据。 + +**Architecture:** 通过独立 repository 同步复用记录,接入现有形态图库及主图读取入口;用现有 rawJson 记录来源和 anchor 快照,无需数据库迁移。前端展示后端公开的来源字段。 + +**Tech Stack:** TypeScript / Prisma SQLite / Vue 3 / Naive UI。 + +## Global Constraints + +- 按用户最新要求,功能已迁回前后端项目根目录的 `dev` 分支;后续遵循根目录 `AGENTS.md`,不在工作树中开发,不自动提交。 +- 不调用生图模型,不复制图片文件;Chrome + localhost 验证。 +- 新增及修改函数、类型、响应式状态需要中文注释。 + +## Task 1: Repository 数据与回归测试 + +- [x] 创建隔离 SQLite 回归测试,先通过现有 `subjectFormRepository.listAssetsByProjectId` 验证缺少自动复用,看到预期失败。 +- [x] 新建 `src/repositories/identity-anchor-form-image.repository.ts`,提供 `sync({ projectId })` / `sync({ subjectFormId })`,事务内复查身份和主图,使用按 form + anchor 确定的记录 ID,防止重复创建。 +- [x] `subjectFormRepository.listAssetsByProjectId` / `listImageGenerationCandidatesByProjectId`,以及 `subjectImageRepository.listBySubjectFormId` / `findPrimaryBySubjectFormId` 接入同步。 +- [x] 回归覆盖未锁定不复用、其他形态不复用、人工主图优先、同一请求重复读取无新增、身份母版更换或失效。 + +## Task 2: 全流程与 DTO + +- [x] 移除 `subject-image.service.ts` 中批量生成的旧复用分支,普通批量使用统一主图判定跳过;强制生成始终走生成路径。 +- [x] 公开安全来源字段 `source: 'identity-anchor' | 'generated'` 与 `identityAnchorImageId`,图库与单形态图片 API 共用解析。 +- [x] 在独立 SQLite 库中验证真实图库 DTO、readiness 跳过、分镜引用与 anchor 快照一致。 + +## Task 3: 前端与本地验收 + +- [x] `SubjectImage` 增加兼容的可选来源字段;列表和图片详情标注“复用身份母版”。基础形态缺图时说明确认身份母版即可复用。 +- [x] 保留明确的“重新生成”入口及原有人工主图选择,不在 UI 伪造图片记录。 +- [x] 类型、定向 lint 与回归测试通过后,以 SQLite 副本启动隔离后端和前端,Chrome 验证已有主图、复用标记及非默认形态仍缺图。 + +## Review + +确认迁回没有覆盖既有修改;在前后端 `dev` 验证实际接口和页面,不调用模型、不提交代码。 + +## 验证结果 + +- 后端全量:9 个文件、99 项测试通过;包含 20 项真实隔离 SQLite 复用回归。 +- 前端定向:5 个文件、50 项测试通过;类型检查与改动文件静态检查通过。 +- Chrome:localhost:4314 当前项目副本显示 8 个复用主图与 7 个待准备形态;历史详情显示复用来源,重新生成默认不替换当前主图。 +- 前端 dev 原有 diff 未变化,后端 dev 保持干净;无代码提交或模型生成。 +- 验收后端 localhost:3414 只开放 GET,并且不启动任务恢复;使用独立 SQLite 副本。 + +## 迁回 dev + +2026-10-12 按用户要求迁回前后端项目根目录的 `dev` 分支。前端原有 15 个修改文件内容保留,追加 8 个功能及说明文件;后端迁入 8 个功能及测试文件。未复制预览数据库、环境配置或依赖目录。上述 worktree 验收记录保留为历史,今后开发以根目录 `AGENTS.md` 为准。 diff --git a/docs/superpowers/specs/2026-10-12-identity-anchor-reuse.md b/docs/superpowers/specs/2026-10-12-identity-anchor-reuse.md new file mode 100644 index 0000000..910f73c --- /dev/null +++ b/docs/superpowers/specs/2026-10-12-identity-anchor-reuse.md @@ -0,0 +1,21 @@ +# 基础形态复用身份母版 + +用户已确认:基础形态默认复用已确认并锁定的身份母版,其他形态继续独立生成,保留重新生成入口,后端与分镜必须识别有效主图。 + +## 数据与选择规则 + +- 以正式 `SubjectForm.isDefault` 判定基础形态,不根据名称或列表顺序推测。 +- 锁定身份 + 启用、完成、有地址的 primary 身份图才可复用,适用于人物、场景和道具。 +- 复用落地为正式 `DramaSubjectImage`,复用现有图片地址而不调用模型或复制物理文件。元数据保留来源与身份母版快照。 +- 已有独立生成/人工选择的形态主图优先,不自动覆盖。基础形态也可主动生成新候选并选择替换。 +- 自动复用主图跟随身份母版切换;失去锁定、有效母版或基础形态身份后不再作为主图。旧记录保留。 +- 读取图库、主图或生产就绪状态时幂等同步已有项目;直接进入分镜也能取到真实形态主图。 +- `force` 批量生成应真正生成候选,不再被旧的道具复用分支截断。 + +## UI + +主图标注“复用身份母版”,保留“重新生成”与历史记录。缺少身份母版的基础形态说明需要先确认并锁定;其他形态保持原生成流程。 + +## 验证 + +后端使用独立临时 SQLite 库:三类主体、非默认形态、未锁定/候选/失败母版、幂等并发、人工主图保护、换母版、解锁、图库 DTO、就绪与分镜取图。Chrome 在隔离端口查看真实接口返回的副本项目,不提交付费模型任务。初次验收使用隔离数据库副本,不提交代码。按用户最新要求,现已将前后端修改迁回项目根目录的 `dev`,后续不再使用工作树开发。 diff --git a/eslint.config.mjs b/eslint.config.mjs index 1d5e120..1877d73 100644 --- a/eslint.config.mjs +++ b/eslint.config.mjs @@ -3,7 +3,8 @@ import tsParser from '@typescript-eslint/parser' /** Oxlint 检查脚本,ESLint 仅补充 Vue 模板语义检查,格式统一交给 Oxfmt。 */ export default [ - { ignores: ['dist/**', 'coverage/**', 'node_modules/**'] }, + /** 检查仅覆盖当前项目,不递归进入历史隔离工作树。 */ + { ignores: ['dist/**', 'coverage/**', 'node_modules/**', '**/.worktrees/**', '**/.worktree/**'] }, ...pluginVue.configs['flat/essential'], { files: ['**/*.vue'], diff --git a/src/features/breakdown/BreakdownPage.vue b/src/features/breakdown/BreakdownPage.vue index 7d24dea..32a79a4 100644 --- a/src/features/breakdown/BreakdownPage.vue +++ b/src/features/breakdown/BreakdownPage.vue @@ -5,7 +5,8 @@ import { integerRule, fieldRule } from '../../lib/form-rules' import WorkspacePage from '../../components/ui/WorkspacePage.vue' import WorkspaceExportButton from '../../components/ui/WorkspaceExportButton.vue' import { NScrollbar, NAlert, NButton, NCheckbox, NInputNumber, NProgress, NTab, NTable, NTabs } from 'naive-ui' -import { computed, onScopeDispose, ref, watch } from 'vue' +import { computed, h, onScopeDispose, ref, watch } from 'vue' +import { useActionMessage } from '../../components/ui/useActionMessage' import { Layers, LoaderCircle, ArrowRight, Settings2 } from '@lucide/vue' import { EmptyState, StatusBadge, WorkspaceTools } from '../../components/ui' import { useProjectContext } from '../projects/context' @@ -27,7 +28,6 @@ const groupSize = ref(3) const modules = ref(['character', 'scene', 'prop']) const preview = ref(null) const previewBusy = ref(false) -const previewError = ref('') const tab = ref('character') const toolsOpen = ref(false) const moduleOptions: { value: BreakdownModule; label: string; description: string }[] = [ @@ -65,7 +65,54 @@ const configValid = computed( () => Number.isSafeInteger(groupSize.value) && groupSize.value > 0 && modules.value.length > 0 ) const input = computed(() => ({ groupSize: groupSize.value, modules: [...modules.value] })) +/** 后端就绪状态决定是否显示后续制作入口。 */ const stageComplete = computed(() => stageReadiness.value?.breakdown.ready === true) +/** 拆解提示复用全局 NMessage,详细问题留在设置弹窗。 */ +const actionMessage = useActionMessage() +/** 问题内容变化才通知,轮询取得相同快照时不会重复弹出。 */ +const issueSignature = computed(() => + JSON.stringify({ + error: execution.value?.errorMessage || '', + issues: validation.value?.valid === false ? validation.value.issues : [] + }) +) +/** 首次读取或问题变化时只显示一条汇总,保留可操作的详情入口。 */ +watch( + issueSignature, + () => { + const executionError = execution.value?.errorMessage + const invalid = validation.value?.valid === false + if (!executionError && !invalid) return + actionMessage?.warning( + () => + h('div', { class: 'flex flex-wrap items-center gap-3' }, [ + h( + 'span', + invalid + ? `分镜校验未通过,共 ${validation.value?.issues.length ?? 0} 项问题。` + : '拆解任务未完成,请查看错误详情。' + ), + h( + NButton, + { + text: true, + onClick: () => { + toolsOpen.value = true + } + }, + () => '查看详情与恢复操作' + ) + ]), + { duration: 6000, closable: true } + ) + }, + { immediate: true } +) +/** 已加载的就绪状态由未完成变为完成时通知,不重放首次读取的历史结果。 */ +watch([() => stageReadiness.value, stageComplete], ([, ready], [previousReadiness, previous]) => { + if (previousReadiness && ready && !previous) + actionMessage?.success('剧本拆解已准备完成,可以继续视觉风格。', { duration: 4000, closable: true }) +}) const canStart = computed( () => !!project.value?.episodes.length && @@ -86,7 +133,6 @@ function invalidatePreview() { previewController?.abort() preview.value = null previewBusy.value = false - previewError.value = '' } watch( [ @@ -115,7 +161,7 @@ async function loadPreview() { const data = await breakdownApi.preview(project.value.id, input.value, previewController.signal) if (version === previewVersion) preview.value = data } catch (cause) { - if (version === previewVersion) previewError.value = errorMessage(cause) + if (version === previewVersion) actionMessage?.error(errorMessage(cause), { duration: 6000, closable: true }) } finally { if (version === previewVersion) previewBusy.value = false } @@ -132,11 +178,16 @@ async function run(action: BreakdownAction) { 'resume-storyboard': '正在修复分镜绑定' } const id = project.value.id - await runOperation(id, labels[action], async () => { - const started = await breakdownApi.run(id, action, action === 'start' ? input.value : undefined) - await backgroundExecution.track(started.executionId) - return started - }) + await runOperation( + id, + labels[action], + async () => { + const started = await breakdownApi.run(id, action, action === 'start' ? input.value : undefined) + await backgroundExecution.track(started.executionId) + return started + }, + { type: 'info', content: '拆解任务已提交,可在“拆解设置与恢复”中查看进度。' } + ) await refresh() } @@ -159,15 +210,6 @@ const rules = { - + {{ context.error.value }} 当前保留上次成功读取的数据。 重试读取 - {{ operation.label || '后台制作任务执行中' }}。可切换页面查看结果,请勿重复提交。 - -
-
- {{ operationGuide.title }} - {{ operationGuide.description }} -
- {{ - operationGuide.action - }} -
-
- {{ - operation.notice - }}
- { padding: var(--app-content-padding) var(--app-content-padding) 0; gap: var(--app-content-gap); } -.project-workflow-status { - margin: var(--app-content-gap) var(--app-content-padding) 0; -} .operation-guide-content { @apply flex items-center justify-between gap-4; } diff --git a/src/features/subject-identity/SubjectIdentityPage.vue b/src/features/subject-identity/SubjectIdentityPage.vue index 024f645..c67f328 100644 --- a/src/features/subject-identity/SubjectIdentityPage.vue +++ b/src/features/subject-identity/SubjectIdentityPage.vue @@ -90,16 +90,6 @@ const { const stageAccess = useProjectStageAccess(projectId, projectContext.stageReadiness) /** 当前项目是否允许进入形态图片,以及尚未开放的具体原因。 */ const subjectImagesAccess = computed(() => stageAccess.sections.value['subject-images']) -/** 只在两栏上方展示当前生成进度,历史失败在候选弹窗的对应图片卡片内说明。 */ -const generationFeedback = computed(() => { - if (!subject.value) return null - if (activeIdentityGeneration.value) - return { - type: 'info' as const, - message: `${subject.value.name} 的身份图片正在生成,刷新页面不会重复提交,请等待当前任务完成。` - } - return null -}) /** 首次读取目录才替换整页,刷新已有主体时保留选择与阅读位置。 */ const initialLoading = computed(() => catalog.loading.value && !catalog.data.value) /** 切换主体时只替换尚未返回的详情,不遮挡已读取的主体目录。 */ @@ -220,21 +210,42 @@ function exportReceipt() { downloadText('subject-identities-receipt.json', JSON.stringify(session.value.receipt, null, 2), 'application/json') } -/** Character 使用确认选角事务;Scene / Prop 保留普通母版切换。 */ +/** + * 前置校验通过并开始提交时关闭原主体弹窗,后续状态通过消息反馈。 + * @param input 已确认的身份图生成参数 + * @returns 提交与详情刷新完成 + */ async function submitIdentityImage(input: Parameters[0]) { - await generateImage(input) - if (!operation.value.error) imageOpen.value = false + const targetId = selectedId.value + await generateImage(input, () => { + if (selectedId.value === targetId) imageOpen.value = false + }) } +/** + * 前置校验通过并开始提交时关闭原主体选角弹窗,不等待接口返回。 + * @param input 已确认的选角生成参数 + * @returns 提交与列表刷新完成 + */ async function submitCastingCandidate(input: Parameters[0]) { - await generateCastingCandidate(input) - if (!operation.value.error) castingOpen.value = false + const targetId = selectedId.value + await generateCastingCandidate(input, () => { + if (selectedId.value === targetId) castingOpen.value = false + }) } -/** Character 使用确认选角事务;Scene / Prop 保留普通母版切换。 */ +/** + * 按主体类型确认母版,成功后关闭原主体的管理弹窗。 + * @param imageId 用户明确选择的图片编号 + */ function chooseAnchor(imageId: string) { - if (subject.value?.module === 'character') void confirmCasting(imageId) - else void confirmStableAnchor(imageId) + const targetId = selectedId.value + /** 迟到响应不能关闭另一个主体的弹窗。 */ + const closeConfirmedDialog = () => { + if (selectedId.value === targetId) identityGallery.value?.closeCandidates() + } + if (subject.value?.module === 'character') void confirmCasting(imageId, closeConfirmedDialog) + else void confirmStableAnchor(imageId, closeConfirmedDialog) } /** 当前主体生图暂不可用时,在失败记录旁说明具体恢复步骤。 */ const imageRetryDisabledReason = computed(() => { @@ -356,8 +367,9 @@ const nextAction = computed<{ action: IdentityFlowAction; title: string; descrip return { action: 'confirm', title: '第 3 步:确认并锁定', - description: '在“管理候选”弹窗中确认母版;人物会同时锁定,场景和道具还需保存锁定状态。', - label: '管理候选并确认' + description: + '在下方图片卡片中确认母版;其他图片可通过“管理候选”查看。人物会同时锁定,场景和道具还需保存锁定状态。', + label: '查看候选并确认' } return { action: 'forms', @@ -374,7 +386,7 @@ function openProfileSettings() { if (route.query.configure !== 'profile') void router.replace({ query: { ...route.query, configure: 'profile' } }) } -/** 根据当前主体的下一步引导执行操作,形态图片跳转仍遵守项目统一准入规则。 */ +/** 下一步引导定位单张图片或打开多候选管理,形态图片跳转遵守项目准入规则。 */ function runNextAction() { if (nextAction.value.action === 'style') void router.push(`/projects/${projectId.value}/visual-style`) else if (nextAction.value.action === 'profile') openProfileSettings() @@ -382,7 +394,7 @@ function runNextAction() { if (subject.value?.module === 'character') castingOpen.value = true else imageOpen.value = true } else if (nextAction.value.action === 'confirm') { - identityGallery.value?.openCandidates() + document.querySelector('#identity-reference-gallery')?.scrollIntoView({ behavior: 'smooth', block: 'center' }) } else if (nextAction.value.action === 'lock') { document.querySelector('#identity-lock')?.scrollIntoView({ behavior: 'smooth', block: 'center' }) } else if (nextAction.value.action === 'forms' && subjectImagesAccess.value.enabled) { @@ -720,19 +732,6 @@ function runNextAction() {
- - -
-
- {{ generationFeedback.message }} -
-
-
@@ -900,7 +899,7 @@ function runNextAction() { @anchor="chooseAnchor" @regenerate="retryIdentityImage" > - +