Skip to content
V2 工作台迁移与旧页面退役清单

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/{scenepropcostume}` + 资产详情
分镜列表 /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、刷新持久化和历史种子数据兼容。