feat: add flexible character uploads and video asset library

README.md

@@ -2,9 +2,10 @@
 
 用于验证“数字人形象先进入快快网络素材库审核，再通过特别版 Seedance 2 生成短剧视频”的完整链路。
 
-页面拆分为两个一级模块：
+页面拆分为三个一级模块：
 
 - **人物素材库**：负责素材入库、审核、历史素材查看与人物组合，是长期资产管理区。
+- **视频素材库**：上传并审核 MP4/MOV 公网视频，保留历史视频素材，并可直接引用到当前片段。
 - **短剧生产**：以一个短剧项目管理多个片段；每段独立配置出场人物、提示词、图片、视频、连续性和生成参数。
 
 在人物素材库点击“用于短剧生产”，会把该人物绑定到当前场景角色并自动进入生产模块。
@@ -13,13 +14,15 @@
 
 ## 已串联的流程
 
-1. 输入数字人正面、侧面、背面三张公网图片 URL。
-2. 逐张调用 `POST /v1/assets/upload`，以客户输入的统一令牌提交三张素材审核。
-3. 对仍在审核的 `mat_*` 素材调用 `GET /v1/assets/{asset_id}`，直至三张全部 `ready` 或出现 `failed`。
+1. 输入数字人正面、侧面、背面中任意 1～3 张公网图片 URL。
+2. 逐张调用 `POST /v1/assets/upload`，以客户输入的统一令牌提交人物素材审核；无需凑齐三张。
+3. 对仍在审核的 `mat_*` 素材调用 `GET /v1/assets/{asset_id}`，直至本次图片全部 `ready` 或出现 `failed`。
 4. 从全部历史素材中选择多张图片，绑定成可复用的人物/形象；三视图只是常见组合，不再是固定的数据结构。
 5. 为本场角色选择人物素材，并补充场景、道具等非人物图片及参考视频，组织成官方 `content` 数组后调用 `POST /sd/api/v3/contents/generations/tasks`。
 6. 用返回的 `id` 调用 `GET /sd/api/v3/contents/generations/tasks/{task_id}`，直至 `succeeded` 或 `failed`。
 
+视频素材库同样调用 `POST /v1/assets/upload`，但传入 `type: "video"`；审核完成后的 `asset://mat_*` 引用可作为当前片段的 `reference_video` 使用。
+
 视频提交后页面每 2.5 秒自动查询一次，最长持续 30 分钟。只有上游明确返回 `failed` 才显示生成失败；30 分钟仍为 `running` 时会保留“仍在生成”状态，不把等待超时误判为失败。任务 ID 会保存在浏览器本地，刷新或重新打开页面后会自动恢复查询。
 
 已完成的候选视频支持“下载视频”和“复制视频链接”。下载直接使用服务商返回的临时签名地址，不占用本 Demo 服务器的视频下载带宽；如果服务商没有返回附件响应头，浏览器可能先打开播放页，用户仍可保存。复制的是本 Demo 域名下以 `.mp4` 结尾的代理链接，可直接作为后续片段的公网参考视频；服务端会根据任务 ID 重新获取服务商的有效地址。
@@ -39,7 +42,7 @@
 
 单实例 Node 服务可用于 10–20 人低频试用，但上线必须配置 HTTPS、限流、进程守护和持久日志目录。每位客户首次访问时输入自己的统一令牌，素材与视频请求均使用该令牌，视频生成费用也归属该令牌。`assetReviewTasks` 与视频任务令牌映射当前仍在单进程内存中，因此暂时应保持单实例部署；如果要多实例扩容，需先将任务状态迁入 Redis/数据库。
 
-页面会分别展示正面、侧面、背面的审核状态与失败原因。异步审核任务 ID 会保存在浏览器本地，刷新或重新打开页面后会继续查询；本场角色尚未选齐人物素材时不会解锁视频生成。
+页面会分别展示正面、侧面、背面的审核状态与失败原因；未上传的视角保持“未上传”，不会被误判为失败。异步审核任务 ID 会保存在浏览器本地，刷新或重新打开页面后会继续查询；本场角色尚未选择人物素材时不会解锁视频生成。
 
 人物库会读取全部历史素材，并把名称形如“人物名 · 正面/侧面/背面”的素材自动组合成人物；也可以手动选择 1–9 张历史素材创建人物组合。场景支持 1–3 个角色，每个角色可绑定一组人物素材，并在刷新后恢复本场角色。
 
@@ -89,7 +92,7 @@ npm start
 ## 当前还缺的真实联调材料
 
 - **客户统一令牌**：形如 `sk-...`，由客户首次打开页面时输入，同时用于素材上传/查询与视频提交/查询。
-- **数字人三视图的公网 URL**：正面、侧面、背面各一张；接口不支持直接上传本地文件或 Base64，URL 需带 `.png`、`.jpg` 等扩展名。
+- **数字人人物图片的公网 URL**：正面、侧面、背面任选 1～3 张；接口不支持直接上传本地文件或 Base64，URL 需带 `.png`、`.jpg` 等扩展名。
 - **客户希望验证的第一段分镜**：人物动作、台词、场景、时长、横竖屏及是否需要同步声音。Demo 已提供一段可替换示例。
 - **视频任务成功响应**：新版接口在 `content.video_url` 返回临时签名视频地址。