feat: 新增项目资产库与形态参考素材

docs/api-contract-sync.md

@@ -44,3 +44,11 @@
 - 浅色主画布统一白色，输入框使用浅灰，Tab 导航、辅助区和图库使用统一主题变量，首屏 theme-color 与应用一致。深色视频播放背景保留。
 
 验证使用模拟 API，不调用真实生成模型。浏览器无法访问当前本地预览地址，尚未完成浏览器截图验收或真实后端联调。
+
+## 2026-09-21 项目资产接口
+
+- `POST /projects/:projectId/assets` 使用 multipart 的 `file`、`name`、`category`，浏览器负责生成 boundary，前端不手工设置 `Content-Type`。
+- GET／PUT／DELETE 项目资产接口全部使用正式项目 ID 与资产 ID；编辑只修改名称和分类，不替换物理文件。
+- 素材公开字段包含 `publicUrl`、类型、MIME、扩展名、大小、分类、元数据和时间；页面只读取 `metadata.originalName` 作为辅助搜索，不依赖内部存储路径。
+- 视觉风格新增参考图可发送 `projectAssetId`，后端从所属项目素材解析 `imageUrl`；外部 `imageUrl` 入口继续兼容。资产关联关系不在公开风格图 DTO 中推断。
+- 删除仍由后端执行引用保护；前端不先删风格记录，也不将失败响应显示为已删除。

docs/backend-coverage.md

@@ -13,6 +13,7 @@
 | 拆解与恢复 | 拆解设置与恢复 | `breakdown-preview`、`breakdown/start`、`retry`、`resume-shots`、`resume-storyboard` | 保留正式剧集分组、模块选择、预览、失败恢复与 JSON 导出 |
 | 运行诊断 | 创作／拆解的执行记录 → 查看完整运行诊断 | GET `metrics`、`timeline/grouped`、共享 `checkpoints` | 新增全量时间线、阶段分组、工作流与节点筛选、独立失败提示、JSON 导出 |
 | 视觉风格 | 视觉风格 | GET／PUT／POST `visual-style` 及图片登记、启停、删除 | 保留锁定、分类提示词、硬约束、AI 生成与图片记录 |
+| 项目资产库 | 资产库／视觉风格参考图选择器 | `/projects/:id/assets` 上传、列表、详情、编辑、删除 | 新增 JPEG／PNG／WebP 上传、名称与分类管理、筛选预览；被视觉风格引用时由后端阻止删除 |
 | 稳定身份 | 主体身份 | `subjects/:id/identity`、单个／项目／角色文本生成 | 保留人工修改、锁定及批量文本生成 |
 | 角色选角 | 主体身份角色模块 | `character-casting/readiness`、批量／单个 candidates、图片 `casting` | 保留候选、检查、确认母版并原子锁定 |
 | 身份参考图 | 主体身份图库 | `identity/images`、图片 `anchor` | 保留完整预览、历史、辅助视角与母版切换；修正道具继承说明 |
@@ -77,3 +78,8 @@
 - 已通过 lint、格式、TypeScript、Vitest（含质量链路及菜单／折叠交互回归）和生产构建；定位回归见 `src/features/subject-images/asset-impact.test.ts`。测试不触发真实模型或生产任务。
 - 当前环境无法打开应用预览，未进行浏览器视觉验收；需在可访问的开发环境检查浅／暗主题和窄屏布局，并由用户明确批准后进行真实小批量模型联调。
 
+## 2026-09-21 项目资产与形态参考同步
+
+核对后端 dev `d9ca93ef54a4c5fbe3917c504531a45f31cb9966`。新增独立项目资产库页面，接入图片上传、列表筛选、详情预览、名称／分类编辑和删除；上传使用 multipart，前端与后端同时限制 JPEG、PNG、WebP 及单张 20MB。视觉风格页可按需读取资产库并以正式 `projectAssetId` 登记参考图，仍保留外部 URL 兼容入口。后端负责校验资产归属、图片类型和删除引用保护。
+
+启用的视觉风格参考图会由后端编译为形态生图的分类参考职责，身份母版继续承担主体一致性。前端不拼接 Provider Prompt，也不把资产库图片自动设为形态主图；已有形态图不会因资产或风格参考变化被客户端静默替换。