Files
short-drama-agent-front/docs/superpowers/plans/2026-10-12-identity-anchor-reuse.md
T

49 lines
3.6 KiB
Markdown
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.
# 基础形态复用身份母版 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` 为准。