1. 先说你在改哪个产品区

例如“镜头拆解 / 元素提取面板”、“元素改造 Storyboard 节点”、“分镜头编排工作台 4 图槽”。不要只说“这里乱”，要指向页面里的功能区。

2. 再说这个区应该承担什么职责

例如“Vision 只给候选元素，用户必须能编辑、删除、重新提取”，这会直接落到 FrameLightbox 和元素接口。

3. 最后说不希望发生什么

例如“点击元素不要跳页面”、“不要直接进入编排打断思路”、“不要把参考视频复刻成一样的东西”。这能约束交互和文案。

前端核心

后端核心

Job

一个视频任务。前端维护多个 jobs[]，当前激活的是 activeJobId。URL 查询参数会持久化多个 job。

Job {
  id, url, status, progress, message,
  video_url, duration, width, height,
  frames: KeyFrame[],
  transcript: TranscriptSegment[],
  storyboard_images?: StoryboardImage[]
}

KeyFrame

关键帧是整个产品的核心单位。index 是稳定 ID，手动加帧后不连续，不能用数组下标代替。

KeyFrame {
  index, timestamp, url,
  description,
  cleaned_url, cleaned_applied,
  elements: KeyElement[],
  storyboard: StoryboardScene,
  generated_images: GeneratedImage[]
}

KeyElement

从关键帧里识别或手动添加的可借鉴元素。Vision 给的是候选，用户可编辑，并可多次生成提取图。

KeyElement {
  id,
  name_zh, name_en, position,
  source: auto | manual | region,
  region,
  cutouts: string[],
  cutout_id
}

StoryboardScene

分镜编排结果，不是复刻说明。它把参考图和 SKG 改造方向绑定到一个分镜上。

StoryboardScene {
  duration,
  subject_image,
  scene_image,
  product_image,
  action_image,
  subject,
  product,
  scene,
  action
}

已通

• TK 链接 / 上传创建 job。
• 视频下载或本地保存，ffmpeg 抽关键帧。
• 手动按时间戳加关键帧。
• 关键帧清洗水印，全图或区域清洗。
• Vision 识别关键帧，输出 scene、objects、style、suggested_prompt。
• 元素增改删、区域元素添加、元素多次提取图。
• 分镜工作台 4 图槽和改造说明自动保存。
• nano-banana-pro image-to-image 生图。

阻塞 / 占位

• ASR：SKG 网关 audio endpoint 404 或渠道不可用。
• Translate：本身 text 通，但产品流里依赖 ASR 段落。
• Rewrite：需要 SKG 产品信息模板和目标脚本结构。
• Video Gen：sora/video endpoint 未通，Seedance/Kling/Veo3 外部 key 未接。
• Compose：还没做本地 ffmpeg 字幕/TTS 合成。