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

3.6 KiB
Raw Blame History

基础形态复用身份母版 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 为准。