VTU-3 · Product Requirement Document
视频处理与角色管理拆分
将耗时的视频生产从角色面板完整拆出，以“视频组”为独立资产，建立先处理素材、再绑定角色的清晰工作流。
01 · Decisions
核心决策
02 · Context
背景与目标
当前版本以角色为唯一管理对象，创建角色时必须上传长视频，上传、拆解、首帧确认、AI 生成、失败重试和下载全部内嵌在角色详情。视频资产无法预先准备，角色资料也被迫依赖耗时的生产任务。
本期把视频生产变成独立的资产工作台，让管理员先形成可复用、可追踪的视频组，再完成角色创建与绑定；两个对象具有独立生命周期，同时保持明确的一对一占用关系。
03 · Scope
产品范围
本期包含
- 视频组列表、搜索、状态筛选、添加与删除
- 单条长视频上传、自动拆解和失败重试
- 从拆解视频确认唯一首帧
- 全量 AI 润滑、进度、预览、下载与失败重试
- 角色创建与编辑时选择或更换视频组
- 绑定锁定、占用冲突和存量迁移
本期不包含
- 一组多角色或一角色多组
- 批量上传、拆解规则配置
- 上传图片或任意时间点截图作为首帧
- 多套首帧、结果版本管理
- 独立任务中心、人工审核、回收站
- 已绑定视频组的重新处理
04 · Architecture
信息架构
| 一级面板 | 页面 | 核心职责 |
|---|---|---|
| 视频处理 默认入口 | 视频组列表 | 查看处理、绑定状态，搜索、筛选和添加。 |
| 添加视频组 | 填写名称并上传一条原始长视频。 | |
| 视频组详情 | 按顺序完成拆解、首帧确认、AI 润滑、重试与下载。 | |
| 角色管理 | 角色列表 | 查看角色资料与绑定视频组，不展示处理进度。 |
| 创建角色 | 填写资料并选择一个可用视频组。 | |
| 角色详情 | 编辑资料、更换绑定，查看视频组摘要并跳转。 |
05 · Flows
核心流程
准备视频组
- 进入“视频处理”，添加名称并上传一条长视频。
- 上传成功后自动拆解；任务在离开页面后继续。
- 预览拆解片段，从其中一条短视频的首帧确认唯一当前首帧。
- 发起“AI 润滑全部视频”，失败项可重试，成功项不重复处理。
- 全部片段成功后，视频组成为“已完成 / 未绑定”。
创建与更换角色绑定
- 创建角色时填写名称、备注，并从可用视频组中选择一项；没有可用组时可直接去处理视频。
- 提交瞬间若视频组已被占用，保留表单并刷新选择列表。
- 更换绑定前展示当前组与目标组；确认后原组释放、目标组占用，所有视频内容保留。
- 删除角色只释放视频组，不删除视频；删除视频组仅允许未绑定且非处理中的组。
06 · Pages
页面方案
视频组列表与添加
列表展示封面、名称、原始文件名、片段数量、处理状态、成功结果数、绑定角色和更新时间；支持关键字、处理状态、绑定状态筛选，默认按最近更新倒序。添加表单只包含视频组名称和一条原始长视频，按钮为“添加并上传”。
视频组详情
顶部汇总名称、处理状态、绑定状态、文件名和时间，主体固定为原始视频、确认首帧、AI 润滑、绑定信息四段。拆解网格逐项预览；润滑结果与来源逐条对应；部分失败时成功结果仍可预览和下载，并提供单条及全部失败项重试。
角色列表、创建与详情
角色列表只展示角色资料、绑定视频组和视频数量。创建页的视频组选择器仅返回“已完成 / 未绑定”的选项。角色详情只展示视频组摘要、“查看视频组”和“更换视频组”，不出现上传、拆解、选帧、润滑或重试能力。
07 · States
状态模型
| 处理状态 | 触发条件 | 下一步 / 限制 |
|---|---|---|
| 上传中 | 原始长视频正在上传 | 等待；失败后重新选择文件。 |
| 拆解中 | 上传成功，系统自动拆解 | 等待，可离开页面。 |
| 待确认首帧 | 拆解完成，尚未确认 | 从本组某条短视频的首帧中选择。 |
| 待 AI 润滑 | 首帧已确认 | 润滑全部拆解成功视频。 |
| AI 润滑中 | 一个或多个片段处理中 | 展示整体、成功、失败、处理中数量。 |
| 已完成 | 全部片段已有成功结果 | 未绑定时可被角色选择。 |
| 部分失败 | 存在成功与失败结果 | 重试失败项；整体不可绑定。 |
| 处理失败 | 上传、拆解失败或润滑全部失败 | 查看原因并重试对应步骤。 |
绑定状态与处理状态独立：未绑定组可在满足条件时选择或删除；已绑定组仅可查看、预览、下载和跳转角色，不可删除、换首帧或重新处理。
08 · Rules
关键规则与异常
- 首帧必须来自本视频组拆解视频的首帧，不能上传图片或跨组选择。
- 一次 AI 润滑覆盖全部拆解成功视频；部分失败不丢弃成功结果。
- 处理期间禁用会改变输入或造成重复任务的操作；刷新后恢复服务端真实状态。
- 视频组名称允许重复，选择与确认场景同时展示原始文件名和完成时间。
- 删除视频组会删除源视频、拆解视频、首帧和润滑结果，必须二次确认且无回收站。
- 更换首帧会清空现有润滑结果并回到待润滑；已绑定组禁止执行。
- 删除角色释放绑定；更换绑定失败时原关系保持不变。
- 所有删除、换首帧和换绑定确认按钮必须描述最终动作。
09 · Migration
存量承接
上线时，当前每个角色内嵌的视频资料形成一个独立视频组并继续绑定原角色。默认名称为“角色名称 + 视频组”；原始视频、拆解片段、当前首帧、润滑结果及真实处理进度全部保持。管理员无需重新上传、确认首帧或创建角色。
已完成资料进入“已完成 / 已绑定”；未完成资料映射到对应步骤并从视频组详情继续。迁移完成后，角色页面仅保留视频组摘要和跳转入口。
10 · Acceptance
验收标准
- 登录后显示“视频处理”和“角色管理”，默认进入视频处理。
- 上传、拆解、首帧、润滑、重试和下载只存在于视频处理。
- 添加视频组必须填写名称并上传一条视频，上传后自动拆解。
- 首帧只能选自当前组拆解视频首帧。
- 未确认首帧时不可润滑并说明原因。
- AI 润滑覆盖全部成功拆解片段，结果逐条对应来源。
- 部分失败时成功项可预览下载、失败项可重试，但组不可绑定。
- 全部成功后组进入已完成，未绑定时可选择。
- 创建角色只选择已完成且未绑定的视频组，不上传处理视频。
- 视频组绑定后不再出现在其他角色的选择器中。
- 角色详情只有视频组摘要与跳转，不含处理能力。
- 已绑定视频组不可删除、换首帧或重新处理，并显示绑定角色。
- 更换绑定后新组占用、旧组释放，两个组内容均保留。
- 删除角色后视频组释放，视频内容不删除。
- 删除未绑定且非处理中的组前明确提示全部影响并二次确认。
- 已有角色及视频升级后保持关系、内容和进度，无需人工重建。