V2 工作台迁移与旧页面退役清单
本文记录当前真实生效的迁移状态。旧版项目制作页面已不再渲染业务组件。
1. 默认入口
- 项目列表 →
/projects/:projectId/workbench。 /projects/:projectId与带?tab=...的旧项目深链接统一进入 V2 映射,不再打开旧项目页。- 旧地址通过
front/src/features/workbench/LegacyRedirects.tsx安全跳转,不返回 404。 - 工作台顶部不再保留「旧版项目页」入口。
2. 功能对照
| 旧功能/路由 | V2 位置 | 处理方式 | 状态 |
|---|---|---|---|
项目列表 /projects | /projects 创作工作台 | 已替换默认入口 | 完成 |
项目 dashboard /projects/:id?tab=dashboard | /workbench 总览 | 重定向 | 完成 |
项目设置 /projects/:id?tab=settings | /workbench/config | 重定向;生成配置在 V2 编辑 | 完成 |
章节/剧本 /projects/:id?tab=chapters | /workbench/script | 重定向;新增/改名/删除/原文编辑/上传/解析/审核在 V2 | 完成 |
角色管理 /projects/:id?tab=roles | /workbench/assets/character + 资产详情 | 重定向;新增、查看、编辑、删除、候选、版本、锁定、音色在 V2 | 完成 |
| 场景/道具/服装管理 | `/workbench/assets/{scene | prop | costume}` + 资产详情 |
分镜列表 /chapters/:cid/shots | /workbench/episodes/:cid | 重定向;场次、镜头、规划、批量生成在 V2 | 完成 |
分镜编辑 /chapters/:cid/shots/:sid/edit | /workbench/.../shots/:sid | 重定向;核心信息、提取确认、参考素材、生成预览、视频审核在 V2 | 完成 |
分镜工作室 /chapters/:cid/studio | /workbench/episodes/:cid + 镜头面板 | 重定向;H3 参考、批量生成、抽卡审核在 V2 | 完成 |
统一审核 /chapters/:cid/review | /workbench/script/:cid | 重定向;剧本解析统一审核在 V2 | 完成 |
镜头看板 /chapters/:cid/board | /workbench/episodes/:cid | 重定向;状态与待确认项在剧集/镜头面板展示 | 完成 |
视频版本 /editor | /workbench/export + 镜头视频候选 | 重定向;候选审核/采纳在镜头面板,选择式导出在 V2 | 完成 |
角色编辑 /projects/:id/roles/:rid/edit | /workbench/assets/character/:rid | 重定向 | 完成 |
| 任务中心 | 工作台底部任务中心 | 通用任务信息保留 | 完成 |
3. 保留的独立支持页面
以下页面不承担旧版项目制作主链路,仍保留独立价值:
/assets:工作区全局素材库与全局资产编辑;/files:文件库;/styles:全局风格目录管理;/models:供应商与模型管理;/voices:音色管理;/settings:账号与全局设置。
项目内制作不再要求用户访问这些页面;V2 资产面板可直接新增项目关联资产并进入档案编辑。
4. 已删除的旧页面代码
- old project workbench tabs(dashboard/chapters/roles/scenes/props/costumes/files/edit/settings);
- old chapter studio / chapter prep;
- old chapter shots list / shot edit / shot board;
- old chapter review page;
- old project role detail page;
- old project video editor route(重定向到导出)。
后端业务 API、数据库表、历史项目/章节/分镜/资产/任务/审核与导出能力均未删除。
5. 兼容与验证
- 旧
?tab=、/chapters/.../shots、/studio、/board、/review、/editor深链接映射有 E2E 回归; - 章节 CRUD、剧本原文草稿恢复、项目时长偏好、参考素材分类与生成预览有 E2E 回归;
- 历史镜头如果没有
ShotAssetVersion,自动参考匹配回退到真实ShotCharacterLink/ShotDetail.scene_id,不按文件名猜测; - 删除章节会级联删除本集镜头与关联数据,但不会删除项目本身;确认弹窗明确说明。
- 删除资产会清理版本、候选图、提示词审核稿和镜头资产版本,并停用参考绑定;历史快照、视频和审核记录保留。
backend/tests/test_asset_delete_cleanup.py覆盖资产删除后的孤儿数据清理。front/e2e-real/v2-crud.spec.ts使用真实 FastAPI + MySQL 验证剧集与四类资产 CRUD、刷新持久化和历史种子数据兼容。