feat(short-drama-agent-front): 支持母版复用并优化生成交互

This commit is contained in:
GJ committed 2026-10-12 15:22:03 +08:00
1 parent 49fb9c7a27
commit ee5e49957a
28 files changed
+634 -326

No files matched your search

@@ -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` 为准。
@@ -0,0 +1,21 @@
# 基础形态复用身份母版
用户已确认:基础形态默认复用已确认并锁定的身份母版,其他形态继续独立生成,保留重新生成入口,后端与分镜必须识别有效主图。
## 数据与选择规则
- 以正式 `SubjectForm.isDefault` 判定基础形态,不根据名称或列表顺序推测。
- 锁定身份 + 启用、完成、有地址的 primary 身份图才可复用,适用于人物、场景和道具。
- 复用落地为正式 `DramaSubjectImage`,复用现有图片地址而不调用模型或复制物理文件。元数据保留来源与身份母版快照。
- 已有独立生成/人工选择的形态主图优先,不自动覆盖。基础形态也可主动生成新候选并选择替换。
- 自动复用主图跟随身份母版切换;失去锁定、有效母版或基础形态身份后不再作为主图。旧记录保留。
- 读取图库、主图或生产就绪状态时幂等同步已有项目;直接进入分镜也能取到真实形态主图。
- `force` 批量生成应真正生成候选,不再被旧的道具复用分支截断。
## UI
主图标注“复用身份母版”,保留“重新生成”与历史记录。缺少身份母版的基础形态说明需要先确认并锁定;其他形态保持原生成流程。
## 验证
后端使用独立临时 SQLite 库:三类主体、非默认形态、未锁定/候选/失败母版、幂等并发、人工主图保护、换母版、解锁、图库 DTO、就绪与分镜取图。Chrome 在隔离端口查看真实接口返回的副本项目,不提交付费模型任务。初次验收使用隔离数据库副本,不提交代码。按用户最新要求,现已将前后端修改迁回项目根目录的 `dev`,后续不再使用工作树开发。