3.6 KiB
3.6 KiB
基础形态复用身份母版 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 数据与回归测试
- 创建隔离 SQLite 回归测试,先通过现有
subjectFormRepository.listAssetsByProjectId验证缺少自动复用,看到预期失败。 - 新建
src/repositories/identity-anchor-form-image.repository.ts,提供sync({ projectId })/sync({ subjectFormId }),事务内复查身份和主图,使用按 form + anchor 确定的记录 ID,防止重复创建。 subjectFormRepository.listAssetsByProjectId/listImageGenerationCandidatesByProjectId,以及subjectImageRepository.listBySubjectFormId/findPrimaryBySubjectFormId接入同步。- 回归覆盖未锁定不复用、其他形态不复用、人工主图优先、同一请求重复读取无新增、身份母版更换或失效。
Task 2: 全流程与 DTO
- 移除
subject-image.service.ts中批量生成的旧复用分支,普通批量使用统一主图判定跳过;强制生成始终走生成路径。 - 公开安全来源字段
source: 'identity-anchor' | 'generated'与identityAnchorImageId,图库与单形态图片 API 共用解析。 - 在独立 SQLite 库中验证真实图库 DTO、readiness 跳过、分镜引用与 anchor 快照一致。
Task 3: 前端与本地验收
SubjectImage增加兼容的可选来源字段;列表和图片详情标注“复用身份母版”。基础形态缺图时说明确认身份母版即可复用。- 保留明确的“重新生成”入口及原有人工主图选择,不在 UI 伪造图片记录。
- 类型、定向 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 为准。