feat: 同步视觉风格与主体身份母版工作区

对齐后端 dev 059e597，新增项目风格编辑锁定、身份文本生成、身份参考图与母版切换。
整理六个工作区入口，接通人物及场景母版继承说明、形态图片来源追溯。
补充草稿保护、正式 ID 校验、费用确认及部分失败回执，67 项测试和静态检查、构建通过。
未修改后端，未调用真实模型；本环境未完成浏览器视觉验收。

README.md

@@ -1,6 +1,6 @@
 # Short Drama Agent Front
 
-短剧 Agent 的前端工作台。支持 `create-drama`、`breakdown` 与 `storyboard` 工作区，使用真实后端 API，不包含演示数据或浏览器端模型调用。
+短剧 Agent 的前端工作台。支持剧本创作、拆解、视觉风格、主体身份、形态图片与分镜设计，使用真实后端 API，不包含演示数据或浏览器端模型调用。
 
 ## 启动
 
@@ -31,6 +31,9 @@ API_PROXY_TARGET=http://localhost:3412
 | 拆解配置 | 每组集数、人物／场景／道具模块选择、后端分组预览 |
 | 拆解结果 | 主体、别名、视觉形态、Episode → Beat → Shot、主体绑定、抽取任务状态、校验问题、JSON 导出 |
 | 拆解恢复 | 失败抽取重试、缺失剧集镜头补齐、分镜引用与 Form 绑定修复 |
+| 视觉风格 | AI 生成、人工编辑、分类 Prompt、JSON 硬约束、锁定；风格参考图地址登记、启停和删除 |
+| 主体身份 | 按正式主体归并形态，单个／批量生成身份文本，人工编辑及锁定，部分失败诊断 |
+| 身份母版 | Seedream 生图、四种参考视角、指定身份参考图、母版候选与切换、实际 Prompt 和来源追溯 |
 | 分镜检查 | 按剧集、Beat、正式 Shot ID 浏览；导演设计、环境与主体即时状态；单集覆盖率与 JSON 导出 |
 | 分镜生成 | Direction / VisualState 单集生成、项目批量补齐、覆盖重生成；并发和自动修复次数；部分失败诊断 |
 | 镜头工具 | 主体参考图与缺失原因、确定性 GenerationSpec 查询与导出、单镜头／批量视频提示词 |
@@ -67,6 +70,8 @@ Oxfmt 不负责代码质量，Oxlint 不负责 Vue 的完整类型推导；Vue S
 | `src/features/breakdown` | 拆解 graph 的 API、类型、配置页面、主体与分镜组件 |
 | `src/features/storyboard` | 分镜 API、类型、生成操作、依赖判断、设计与状态、镜头资源、生成回执 |
 | `src/features/subject-images` | 正式形态图库、图片生成参数、历史图片、主图选择与批量回执 |
+| `src/features/visual-style` | 项目视觉风格 API、类型、编辑器、锁定和风格参考图管理 |
+| `src/features/subject-identity` | 稳定身份 API、正式主体目录、文本编辑、生图配置、身份图库和母版切换 |
 | `src/features/workflows` | checkpoint 选择、执行记录、长请求互斥与操作确认 |
 | `src/components/ui` | 跨业务使用的 Reka UI 封装与公共展示组件 |
 | `src/composables` | 具备取消和竞态保护的轮询 |
@@ -78,7 +83,7 @@ Oxfmt 不负责代码质量，Oxlint 不负责 Vue 的完整类型推导；Vue S
 ## 接口基线
 
 对齐后端 `qianlanse/short-drama-agent` 的 `dev`：
-`eac8dc3b1b2ce1ff2bdfeb01d7281cd838f07285`，包含本次新增的只读 `GET /projects/:projectId/subject-forms` 接口。请同步更新前后端 `dev` 后重启后端。
+`059e59709359dccd08b08cb35c6aff95c5e03f2b`（2026-08-28），包含 VisualStyle、SubjectIdentity、身份母版、人物／场景形态自动引用母版及道具稳定特征提取。本轮只修改前端，请确保后端依照其开发流程同步了新 Prisma 结构并重启服务。
 
 | HTTP | 路径（以 /api 为前缀） | 用途 |
 | --- | --- | --- |
@@ -102,11 +107,21 @@ Oxfmt 不负责代码质量，Oxlint 不负责 Vue 的完整类型推导；Vue S
 | GET | `/storyboard-shots/:shotId/generation-spec` | 后端确定性编译结果，不调用模型 |
 | POST | `/storyboard-shots/:shotId/video-prompt` | 复用已有 Prompt 或调用模型生成；`force` 控制覆盖 |
 | POST | `/projects/:id/video-prompts/generate` | 项目批量 Prompt；`concurrency`、`force` |
-| GET | `/projects/:id/subject-forms` | 正式 SubjectForm ID、主体名称／引用、主图与图片元数据；本次新增只读接口 |
+| GET | `/projects/:id/subject-forms` | 正式 SubjectForm ID、主体名称／引用、主图与图片元数据；只读查询 |
 | GET | `/subject-forms/:formId/images` | 此形态的全部图片历史及实际 Prompt |
 | POST | `/subject-forms/:formId/images` | 单图生成；显式 `provider: seedream`，可选 Prompt 和成对尺寸，`setPrimary` |
 | PUT | `/subject-forms/:formId/images/:imageId/primary` | 选择已完成图片作为主参考图，不调用模型 |
 | POST | `/projects/:id/subject-images/generate` | 全项目批量生图；`provider`、`concurrency`、`force` |
+| GET / PUT | `/projects/:id/visual-style` | 查询／人工保存视觉风格，包含分类 Prompt、硬约束和锁定 |
+| POST | `/projects/:id/visual-style/generate` | AI 生成风格；已有风格重生成显式 `force: true`，锁定时禁止 |
+| POST | `/projects/:id/visual-style/images` | 登记已有风格图片地址，不上传文件 |
+| PUT | `/projects/:id/visual-style/images/:imageId/enabled` | 风格图片启停 |
+| DELETE | `/projects/:id/visual-style/images/:imageId` | 删除风格图片记录，不删除远程文件 |
+| GET / PUT | `/subjects/:subjectId/identity` | 查询／人工编辑稳定身份；使用正式 Subject ID |
+| POST | `/subjects/:subjectId/identity/generate` | AI 生成身份文本，需要项目视觉风格 |
+| POST | `/projects/:id/subject-identities/generate` | 项目批量身份文本；`force`、`concurrency`，已锁定始终跳过 |
+| GET / POST | `/subjects/:subjectId/identity/images` | 查询带 `isAnchor` 的身份图片／Seedream 生图 |
+| PUT | `/subjects/:subjectId/identity/images/:imageId/anchor` | 将成功的 primary 候选设为身份母版 |
 
 API 层也提供 `state` 与 `breakdown/latest` 方法。页面通过共享 checkpoint 查询取得阶段状态，避免重复拉取同样内容。
 
@@ -146,6 +161,28 @@ API 层也提供 `state` 与 `breakdown/latest` 方法。页面通过共享 chec
 8. 图片使用持久化后的 `/storage/...` 地址，开发代理已配置。生产环境也必须代理 `/storage/`，不能让 SPA 回退返回 index.html。无效 URL、加载失败、无图和后端生成失败有各自提示；不会自动使用可能过期的 Provider 临时地址。
 9. 设为主图后，回到分镜点击“刷新参考图”读取最新绑定。已有视频提示词不会自动重生成，需要按需覆盖。本页面不会调用 `/production/start` 或实际视频生成。
 
+### 视觉风格、身份与形态的衔接
+
+建议操作顺序：**剧本创作 → 剧本拆解 → 视觉风格 → 主体身份 → 形态图片 → 分镜设计**。视觉风格也可以在拆解前准备；这不是前端强制启动的整条生产流程。
+
+| 层级 | 职责 | 本次可操作内容 |
+| --- | --- | --- |
+| VisualStyle | 项目整体美术与视觉语言 | 整体／人物／场景／道具 Prompt、JSON 字符串数组硬约束、锁定、风格图片记录 |
+| SubjectIdentity | 同一主体跨形态不变的特征 | 稳定身份描述、身份 Prompt、锁定、单个及批量 AI 文本生成 |
+| Identity Image | 固定主体身份，人物主要固定脸部与体型 | primary、front、three-quarter、full-body 四类生图、身份锚定来源、母版选择 |
+| SubjectForm Image | 某个具体造型或状态的图片 | 原有单图／批量生图与主图选择；人物／场景图自动引用当前身份母版 |
+
+1. 风格与身份的 `isLocked` 只禁止 AI 自动覆盖文本。已锁定记录仍可人工编辑并保存；身份生图和母版切换也不受文字锁定限制。需要 AI 重生成时，先取消锁定并保存。
+2. 身份 AI 生成需要已创建 VisualStyle；身份图生成还需要已保存的非空 `generationPrompt`。不存在身份时不调用会报错的图片 GET。404 或网络失败不会被当作“尚未创建”。
+3. 后端暂无全项目主体／身份的 GET。前端从正式 `subject-forms` 目录按 `subjectId` 去重，选中主体后按需读取身份和专用图库；无形态主体暂不在目录展示。批量仍由后端处理项目全部主体，可能多于目录可见数，不受当前筛选影响。未使用 checkpoint 或 `DramaCharacter.id` 拼造 Subject ID。
+4. 身份文本批量回执显示 `total`、`targetCount`、`generated`、`skipped`、`skippedLocked`、`failed` 和逐主体失败原因。它不代表图片已生成，也不是实时任务进度。后端没有批量身份生图接口，前端不自行循环触发有费用的图片请求。
+5. 身份图片的 `isAnchor` 来自专用 GET。`enabled: true` 的正面、侧面或全身图不是母版；只有成功且有地址的 `primary` 图可经 PUT 设为母版。第一张 primary 图自动启用；已有母版后，新 primary 图作为停用候选保留，不静默替换。辅助视图不能直接选为母版，但可以作为新 primary 图的参考来源。
+6. 身份生图不传 `referenceImageId` 时，由后端自动选择当前母版；无母版时按文本生成。指定时只能选择当前身份已完成的图片；候选图即使停用也可作为显式参考。后端没有“有母版但忽略它”的参数。尺寸成对留空或提供正整数。自定义 Prompt 会替换后端编译的完整文本，建议保留默认。
+7. 目前**人物与场景形态生图**会自动注入当前身份母版，分别固定人物身份和空间骨架；道具暂不自动引用。没有身份或母版时，原形态生图流程仍可使用。已有母版但缺少 Provider 可访问远程地址时，后端会报错；本地 `/storage/` 能显示并不证明原始 Provider URL 仍可访问。前端显示后端错误，不自动重试消耗额度。
+8. 修改风格、身份文本或母版，不会自动使旧图失效或重生成。已有形态主图仍会被分镜使用；需要保持新身份时，主动生成候选图并设为形态主图，再刷新分镜参考图，按需覆盖视频提示词。图库详情展示当次 `identityAnchorImageId` 或 `referenceImageId`；旧记录没有该字段时明确显示未知，不推断它使用了当前母版。
+9. 风格参考图支持登记已有 HTTP(S)／`/storage/` 地址、分类、排序、启停和删除记录；**没有文件上传接口，也没有风格图 AI 生成接口**。当前身份图／形态图 Provider 调用不会自动消费风格参考图片，页面不暗示登记后已生效。
+10. 编辑草稿与轮询分离。保存成功才清空草稿，失败保留；主体切换会提示放弃未保存修改。离开页面不会自动保存。所有新写操作沿用项目级会话互斥，生成前需要费用与后台任务确认，无法替代后端跨浏览器锁。
+
 ### 后端限制
 
 目前 `checkpoints` 接口返回完整历史与 state，没有分页或轻量状态接口。长篇剧本会增加轮询流量。下一步建议后端增加：
@@ -203,5 +240,11 @@ server {
 8. 给主体形态准备参考图，读取镜头参考图和 GenerationSpec；确认 Prompt 无正文时经确认生成、有正文且不覆盖时复用。不提交实际视频任务。
 9. 打开“形态图片”，检查已有主图自动显示；单个形态新增候选图，查看历史、失败原因和实际 Prompt，再设为主图。
 10. 在小型测试项目中验证批量补齐与“已有主图也新增候选图”；回到分镜刷新参考图，确认使用新选择的主图。
+11. 进入“视觉风格”，保存或生成风格，检查分类 Prompt 和硬约束；锁定后 AI 入口禁用，人工编辑仍可保存。登记一张已有风格图，检查启停和移除确认。
+12. 进入“主体身份”，检查同一主体的多形态归并。生成／保存身份文本并锁定，再生成第一张 primary 图；生成第二张后，确认旧母版未被替换。
+13. 为同一主体选择参考来源并生成 front / three-quarter / full-body 图；确认辅助图不能直接设为母版。将第二张 primary 候选设为母版后，检查旧母版停用且保留。
+14. 对人物和场景形态分别新增图片，在图片详情检查当次母版 ID；旧主图应保持不变，手动切换后再刷新分镜参考图。道具不应显示自动继承母版已生效。
+
+本轮新增测试覆盖风格 JSON／锁定／图片 DELETE、身份归并／前置条件／尺寸／显式参考图／母版切换、部分失败、旧响应、草稿保护与费用确认。模型调用均使用模拟 API。当前执行环境未能通过浏览器访问本地开发服务，**未完成浏览器视觉验收及真实模型联调**，请按上述步骤在本地验收。
 
 自动测试使用模拟 API，覆盖既有流程、分镜接口与竞态，以及形态图片自动读取、正式 ID 生图、主图 PUT、费用确认、尺寸校验、候选图选择、批量部分失败和图片加载错误。不等同于真实模型、MySQL 或浏览器视觉联调。请勿用正式项目随意制造失败以测试恢复。