文档
08_归档04_VOZEB任务卡

VOZEB-UI-MIGRATION-02-M09 — 短剧编辑器 Chrome

Task ID: VOZEB-UI-MIGRATION-02-M09-DRAMA-EDITOR
目标用户结果: 用户打开短剧项目后,在统一 Ocean Air / Liquid Glass 编辑器壳层中继续编辑剧本、审核内容、设计分镜和生成镜头
Feature ID / Atomic Requirement IDs: MOD-P0-001;EXEC-P0-001..003(仅承载编辑器视觉与既有交互)
Base SHA: dee4a179316166dfe2d6f9ddbad0ee7907afc8a1
必须阅读: VOZEB-UI-FOUNDATION-01.md;VOZEB-UI-MIGRATION-02.md;VOZEB-UI-MIGRATION-02-M08-DRAMA-LIST.md;Drama project store 与现有编辑器测试
允许修改: 本任务包;web/src/app/(user)/drama/[id]/page.tsx;本目录新增 drama-editor-chrome.module.css;本目录新增 drama-editor-chrome.test.tsx
禁止修改: web/src/app/(user)/drama/[id]/drama-agent-*.tsx;drama-generation-*.tsx;drama-shot-*.tsx;drama-rich-script-editor.tsx;drama-script-workspace.tsx;drama/stores/**;services/api/**;contracts、API routes、Go、migrations;共享 Ocean 组件与 layout/navigation;其它页面
范围: 为现有短剧编辑器增加单层 Ocean Glass 顶栏、剧集栏、生产区、Agent 侧栏与剧本保存栏材质;统一加载/不存在状态、圆角、hairline、阴影、响应式与无障碍视觉状态
非目标: 不改变 stores、API、Agent/生成/审核状态机、脚本编辑器、镜头编辑器、导入导出、路由、回调、持久化、计费、项目数据或页面级背景/WebGL;不重写任何业务子面板
已冻结契约与数据模型: DramaProjectPage、DramaWorkspaceHeader、DramaEpisodeSidebar、DramaAgentPanel、DramaScriptGlobalBar 现有 props、data/aria hooks 与阶段切换语义保持不变
安全与数据限制: 仅本地合成会话和现有 fixture;不读取或输出 Secret,不触发真实上游、账务或生产写入
验收命令: pnpm exec vitest run src/app/(user)/drama/[id]/drama-editor-chrome.test.tsx src/app/(user)/drama/[id]/drama-mobile-layout.test.ts;pnpm exec tsc --noEmit --pretty false;pnpm exec eslint src/app/(user)/drama/[id]/page.tsx src/app/(user)/drama/[id]/drama-editor-chrome.test.tsx --quiet;pnpm exec prettier --check docs/oceanway/VOZEB-UI-MIGRATION-02-M09-DRAMA-EDITOR.md src/app/(user)/drama/[id]/page.tsx src/app/(user)/drama/[id]/drama-editor-chrome.module.css src/app/(user)/drama/[id]/drama-editor-chrome.test.tsx;pnpm run build;git diff --check
人工决策点: LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST;编辑器业务面板与正式 Testing 另建切片
交付物: 单层 Ocean Glass 编辑器 Chrome、加载/不存在状态壳、窄屏无溢出规则、结构契约测试与候选验证记录

验收边界

  • /drama/:id 继续由 fullscreen workspace 路由承载;本切片不新增 OceanAmbientBackground、WebGL renderer 或第二个页面背景。
  • loadProject、updateProject、updateEpisode、updateShot、Agent、版本、图片/视频/音频任务以及所有现有事件回调保持原实现。
  • 顶栏、剧集栏、生产区、Agent 侧栏和脚本保存栏各自只有一层可见材质;正文使用 Ocean Air 中性文字,主题色仅用于焦点/操作图形。
  • 浏览器支持 Liquid Glass 时使用统一 --ocean-glass-* blur/saturation/shadow;不支持透明或 forced-colors 时回退到不透明语义表面。
  • 390px/430px 等窄屏保留现有抽屉与横向阶段导航,不产生页面水平溢出;prefers-reduced-motion 下不新增过渡动画。
  • 所有变化登记为 LOCAL_IMPLEMENTATION_CANDIDATE / CANDIDATE_EVIDENCE / NOT_FORMAL_TEST,不提升正式 Development、Testing 或 Operations 状态。

On this page