Jellyfish / rules

---
description: Jellyfish 页面职责、状态语义与主流程边界
alwaysApply: true
---

# Jellyfish Product Boundary Rules

## 前端页面职责

- 分镜编辑页 = 准备：
  - 负责资产/对白提取、候选确认、基础信息修正。
  - 负责将镜头推进到 `ready`。
- 分镜工作室 = 生成：
  - 负责视频准备度、关键帧、图片、视频参数与视频生成。
  - 不应承担主要的提取确认职责。
- 任务中心 = 通用任务状态面板：
  - 只展示通用、轻量任务信息（状态、进度、成功/失败、取消与回跳入口）。
  - 不承载业务专属上下文摘要，不展示提示词调试上下文、图文映射细节等重信息。
  - 业务细节应留在对应业务面板（提示词弹窗、生成面板、诊断面板）。

## 状态语义约定

- `shot.status` 只表示信息提取确认状态：
  - `pending`：仍有提取确认工作未完成。
  - `ready`：已完成提取确认，可进入后续生成准备。
- `shot.status` 不用于表达运行时生成状态：
  - `generating` 不再作为正式 `shot.status` 使用。
  - 运行中状态统一来自任务系统与 runtime summary。
- `video-readiness` 单独表示“是否具备视频生成条件”，并与 `shot.status` 分离。
- 页面展示必须明确区分三类状态：
  - 信息确认状态
  - 运行时任务状态
  - 视频生成准备度
- 状态语义变更后必须同步：
  - 后端实现
  - OpenAPI
  - 前端 generated types
  - 开发文档 / 说明文档

## 分镜主流程约定

- 标准主流程：
  1. 章节内容提取分镜
  2. 分镜编辑页完成资产/对白等基础信息提取与确认
  3. 分镜工作室完成关键帧、参考图、视频参数与视频准备度检查
  4. 分镜工作室发起视频生成
- 默认职责边界：
  - 分镜编辑页负责“提取、确认、修正”。
  - 分镜工作室负责“生成准备、执行生成、查看结果”。
- 若工作室保留提取相关能力，仅作为快捷入口或诊断入口，不应成为提取确认主入口。
- 涉及页面交互调整时，优先保证流转成立：
  - 编辑页准备完成后，明确引导进入工作室继续生成。
  - 工作室发现镜头未 `ready` 时，明确引导回编辑页确认。

More agent context in Forget-C/Jellyfish

5 other files this repository gives its agents.