Skip to content

yzsp-studio/mediakit-shared-suite / creative-drama

creative-drama

Verified

完整制作短剧、微电影、剧情短片、动画短片、动态漫、剧情视频和长篇剧本。用户明确需要角色驱动、冲突因果、剧情弧线、角色与道具资产、分段视频、抽帧连续性和成片交付时调用。当用户提出短剧、动画短片、微电影、短片、电影、剧情视频、AI视频、影视化短片、动态漫、宣传片、预告片等影视剧制作需求,或包含"做个短剧"、"拍个微电影"、"弄个动画短片"、"做个长视频"、"宣传片"等表达时调用。只有宣传片、预告片或广告片被明确要求做成完整剧情链、角色行动链或影视剧式叙事时才调用本 skill;普通品牌宣传、企业宣传、产品广告、UGC、活动预告、信息流广告和通用创意视频使用 creative-video。

references/manifests.md

View on GitHub
# 项目、分集与素材 Manifest Ref

当项目初始化、接收用户素材、进入任一生产阶段、恢复中断任务或交付分集时读取本文件。本文件是目录、命名、JSON 字段、枚举、基数和引用关系的唯一权威;创作正文仍以 Markdown 为准,不在 JSON 中复制整篇正文。

## 权威引用

- 规划字段及确认事务:`planning.md`。
- 剧本、分镜、资产、视频和成片的内容规则:对应阶段 Reference。
- 本文件只定义目录、命名、JSON schema、引用关系、状态和基数;不重新定义生成算法、创作阈值或人工审美标准。
- 本文件定义的 schema、基数和引用关系,以及对应阶段权威 Reference 定义的准出条件,是产物合同;`scripts/drama_lint.py` 只负责实现其中可客观检查的部分。文档示例与校验器发生遗漏或冲突时,先按本文件和对应阶段 Reference 判断正确合同,再修正过时的一方;不得扭曲真实产物来迁就校验器。

## 设计原则

- 完整模式必须在根目录 `01_剧本/` 先保存项目级完整故事包;多集项目覆盖全局故事圣经、全部分集推进总纲、人物弧、伏笔账本和最终结局。逐集可执行剧本进入 `episodes/ep_N/`,只在该集开始制作时生成,完整写出场次、动作和全部人声文本。轻量模式不要求建立独立剧本文件。
- 项目级 JSON 管理跨集事实、来源、项目数据卡、共享资产、跨集接缝与索引;分集 JSON 管理本集状态、引用和阶段产物。
- 项目级故事包确认后把 `current_episode` 设为 `ep_1`,从该集详细剧本开始逐集生产。共享资产可以在首次实际需要的分集创建并进入 `asset_registry.json`;后续集先从共享登记和已完成分集资产中复用 approved 版本,只把新增或状态变化项写入本集资产。
- 跨集稳定的角色基准图、主要场景参考图、核心道具、音色和全局风格 moodboard 只保存于 `shared/`,不复制到每集目录。
- 完整模式中,`00_制作控制/project_data_card.json` 是角色、场景、道具和音色“不可变身份 + 可变状态时间线”的单一事实源。下游只填写片段增量,不得手工复述另一套基础设定;轻量模式不创建该文件。
- 当集新增或变化的服装、伤痕、年龄、伪装和道具状态保存在对应 `episodes/ep_N/03_资产/`;分镜确认后生成的剧情关键帧仍集中保存在该目录下的 `关键帧/`,但阶段状态独立记录为 `keyframes`。
- 生成前关键帧使用 `KFxxx`,直接绑定已确认的 SEG、SHOT 和职责;视频生成后的实际抽帧使用 `FRMxxx`,用于记录模型真实输出。KF 与 FRM 不得混用或互相覆盖。
- Markdown 面向用户和人工审阅;JSON 面向工具执行、依赖追踪、版本恢复和结构校验。JSON 只引用 Markdown 路径与哈希,不复制完整剧本、分镜说明或质检长文。
- 文件中的 `episode_id` 固定使用 `ep_1`、`ep_2`……;文件名最后一个业务后缀也使用 `_ep_N`,版本号放在它之前,例如 `角色_CHR001_林远_战损_v02_ep_2.png`。
- 稳定 ID 在项目内唯一。集号表示使用范围,不重新编号同一个角色、场景、道具、音色、风格、镜头、片段或帧。
- 路径全部相对项目根目录保存;每项记录包含 schema 版本和 revision。已确认版本不得原地覆盖。

## 统一目录

```text
<工作区>/artifacts/<项目名>/
├── 00_制作控制/
│   ├── drama_plan.json
│   ├── project_manifest.json
│   ├── project_data_card.json       # 仅完整模式
│   ├── source_manifest.json
│   ├── 制作状态.json
│   ├── 用户确认记录.jsonl
│   ├── episode_seams.json           # 仅完整模式
│   ├── 合规证明/                  # 仅在宿主要求审计证明时创建
│   │   ├── 合规证明_planning.json
│   │   ├── 合规证明_script.json
│   │   ├── 合规证明_assets.json
│   │   ├── 合规证明_storyboard.json
│   │   ├── 合规证明_keyframes.json
│   │   ├── 合规证明_video.json
│   │   └── 合规证明_final.json
│   ├── 输入素材/                    # 需要持久化的用户上传或外部下载文件
│   ├── 操作日志.jsonl
│   ├── 批次/
│   │   └── batch-NNN_ep_N.json
│   └── 校验报告/                 # 仅保存自动媒体检查结果
├── 01_剧本/                         # 完整模式必有;轻量模式不创建独立剧本层
│   ├── project_script_manifest.json
│   ├── 项目_事实与假设.md
│   ├── 项目设定卡.md
│   ├── 剧本_全局设定与分集总纲.md
│   └── 剧本_全剧完整剧本.md
├── shared/
│   └── 03_资产/
│       ├── 角色/
│       │   ├── 角色_CHRxxx_[名称]_[基准状态]_vNN.[ext]
│       │   └── 角色_资产说明.md
│       ├── 场景/
│       │   ├── 场景_SCNxxx_[名称]_布局参考_vNN.[ext]
│       │   └── 场景_资产说明.md
│       ├── 道具/
│       │   ├── 道具_PROPxxx_[名称]_[状态]_[multiview|main|detail]_vNN.[ext]
│       │   └── 道具_资产说明.md
│       ├── 音色/
│       │   ├── 音色_VOICExxx_[主体]_提示词_vNN.md
│       │   ├── 音色_VOICExxx_[主体]_vNN.[ext]
│       │   └── 音色_资产说明.md
│       ├── 风格/
│       │   ├── 风格_STYLE001_全局moodboard_vNN.[ext]
│       │   └── 风格_资产说明.md
│       └── asset_registry.json
└── episodes/
    ├── ep_1/
    │   ├── episode_manifest_ep_1.json
    │   ├── 01_剧本/
    │   │   ├── script_contract_ep_1.json
    │   │   ├── 剧本_分集梗概_ep_1.md
    │   │   ├── 剧本_分集人物状态_ep_1.md
    │   │   ├── 剧本_人物关系张力矩阵_ep_1.md
    │   │   ├── 剧本_分集主要场景_ep_1.md
    │   │   └── 剧本_完整剧本_ep_1.md
    │   ├── 02_分镜/
    │   │   ├── storyboard_ep_1.json           # 仅完整模式
    │   │   ├── 分镜_阅读稿_ep_1.md            # 仅完整模式
    │   │   ├── 导演总控卡_ep_1.md             # 仅完整模式
    │   │   ├── 分镜_完整分镜表_ep_1.md
    │   │   ├── 分镜_视频片段执行表_ep_1.md    # 仅完整模式
    │   │   ├── 分镜_连续性账本_ep_1.md        # 仅完整模式
    │   │   └── 分镜_资产需求清单_ep_1.md      # 仅完整模式
    │   ├── 03_资产/
    │   │   ├── 角色状态/
    │   │   │   └── 角色_CHRxxx_[名称]_[状态]_vNN_ep_1.[ext]
    │   │   ├── 道具状态/
    │   │   │   └── 道具_PROPxxx_[名称]_[状态]_[multiview|main|detail]_vNN_ep_1.[ext]
    │   │   ├── 关键帧/
    │   │   │   ├── 关键帧_KFxxx_SEGxxx_highlight-N_vNN_ep_1.[ext]
    │   │   │   └── 关键帧_资产说明_ep_1.md
    │   │   ├── asset_usage_ep_1.json
    │   │   └── keyframe_manifest_ep_1.json
    │   ├── 04_视频片段/
    │   │   ├── video_manifest_ep_1.json
    │   │   ├── continuity_ep_1.json
    │   │   ├── 视频_资产清单_ep_1.md
    │   │   ├── 提示词_SEGxxx_vNN_ep_1.md
    │   │   ├── 片段_SEGxxx_E01S01_vNN_ep_1.[ext]
    │   │   ├── 抽帧/
    │   │   │   ├── 抽帧_FRMxxx_SEGxxx_[start|scene|tail]_[HH-MM-SS-ms]_vNN_ep_1.[ext]
    │   │   │   └── 抽帧_连续性清单_ep_1.md
    │   │   └── 质检/
    │   │       ├── 质检_SEGxxx_vNN_ep_1.md
    │   │       └── 质检_接缝_SEAMxxx_SEGxxx_SEGyyy_vNN_ep_1.md
    │   └── 05_成片/
    │       ├── delivery_manifest_ep_1.json
    │       ├── 成片清单_ep_1.md
    │       ├── 质检_媒体探测_无字幕_vNN_ep_1.json
    │       ├── 质检_媒体探测_字幕版_vNN_ep_1.json
    │       ├── 质检_基础_无字幕_vNN_ep_1.json
    │       ├── 质检_基础_字幕版_vNN_ep_1.json
    │       ├── 质检_ASR对齐_vNN_ep_1.json
    │       ├── 字幕_ASR原始_vNN_ep_1.json
    │       ├── 字幕_时间轴_vNN_ep_1.srt
    │       ├── 字幕_最终版_vNN_ep_1.json
    │       ├── 字幕_烧录参数_vNN_ep_1.json
    │       ├── [项目名]_成片_[比例]_无字幕_vNN_ep_1.[ext]
    │       └── [项目名]_成片_[比例]_字幕烧录_vNN_ep_1.[ext]
    └── ep_2/
        └── ...
```

`00_制作控制/校验报告/` 中需要逐集定位的报告也追加 `_ep_N`;项目级汇总报告不追加集号。
`scripts/drama_lint.py` 在完整模式分镜阶段检查 `storyboard_ep_N.json`、`分镜_阅读稿_ep_N.md`、`导演总控卡_ep_N.md` 和 `分镜_完整分镜表_ep_N.md`,并客观确认完整分镜表存在十五列。视频片段执行表、连续性账本和资产需求清单仍按 `storyboard.md` 生成,并由主 Agent 人工复核;不能因为校验器尚未逐项检查而省略。轻量模式只检查 `分镜_完整分镜表_ep_1.md` 及其十五列结构,不创建或检查其余分镜配套文件。不得同时创建导演阐述、导演控制包或强风格系统卡形成第二套决策中心。
剧情关键帧在分镜确认后命名为 `关键帧_KFxxx_SEGxxx_highlight-N_vNN_ep_N.[ext]`;`highlight-N` 是同一 SEG 内从 `1` 开始的高光序号。目录中的 `ep_1` 仅为实例。
主要场景必须生成共享布局参考图,用于锁定空间拓扑、门窗朝向、固定陈设和基础光位;它不是逐镜剧情画面,不替代分镜场景合同。剧情关键帧在分镜确认后按 SEG 生成并进入 `关键帧/`,视频完成后另从真实画面提取 FRM,两者分别承担“生成前目标”和“生成后事实”。

## 全局 JSON

### project_manifest.json

只做项目总索引,不复制 `drama_plan.json` 的创意与模型字段:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "revision": 1,
  "format_mode": "single_short|multi_episode|micro_film|long_form_video",
  "episode_count": 1,
  "episode_ids": ["ep_1"],
  "plan_path": "00_制作控制/drama_plan.json",
  "state_path": "00_制作控制/制作状态.json",
  "source_manifest_path": "00_制作控制/source_manifest.json",
  "project_data_card_path": "00_制作控制/project_data_card.json",
  "shared_asset_registry_path": "shared/03_资产/asset_registry.json",
  "episode_seams_path": "00_制作控制/episode_seams.json",
  "project_script_manifest_path": "01_剧本/project_script_manifest.json",
  "episode_manifests": {
    "ep_1": "episodes/ep_1/episode_manifest_ep_1.json"
  }
}
```

`episode_ids`、`episode_manifests` 和 `drama_plan.json.scale_plan.episode_count` 必须一致,不允许缺集、重复或指向不存在的文件。
完整模式从剧本阶段开始必须创建 `project_script_manifest_path` 指向的项目级剧本索引,并创建 `project_data_card_path` 指向项目数据卡;`episode_seams_path` 指向实际跨集接缝文件。轻量模式不进入独立剧本、资产或分段接缝流程,将 `project_script_manifest_path`、`project_data_card_path`、`shared_asset_registry_path` 和 `episode_seams_path` 留空,不得为满足路径字段伪造这些文件。

### 制作状态.json

这是项目级与逐集阶段状态的唯一数据源。`drama_plan.json` 和 `episode_manifest_ep_N.json` 不再重复保存状态;旧项目已有的镜像字段允许保留,但不参与阶段判断,新项目不要创建:

```json
{
  "project_id": "",
  "revision": 1,
  "current_stage": "planning",
  "current_episode": null,
  "phases": {
    "planning": "in_progress",
    "script": "pending",
    "assets": "pending",
    "storyboard": "pending",
    "keyframes": "pending",
    "video": "pending",
    "final": "pending"
  },
  "episodes": {
    "ep_1": {
      "manifest": "episodes/ep_1/episode_manifest_ep_1.json",
      "stage_status": {
        "script": "pending",
        "assets": "pending",
        "storyboard": "pending",
        "keyframes": "pending",
        "video": "pending",
        "final": "pending"
      }
    }
  },
  "artifacts": [],
  "open_issues": [],
  "last_successful_operation": ""
}
```

状态只允许 `pending|in_progress|awaiting_confirmation|confirmed|merged|invalidated|blocked`。`merged` 只允许轻量模式中的 `script|assets|storyboard|keyframes|video`,表示这些阶段不建立独立产物包、用户交付和确认门;轻量模式仍必须保存十五列详细分镜并据此编译 Prompt,但不生成完整模式的其他创作配套文件。完整模式项目级故事包阶段使用 `current_stage: script` 与 `current_episode: null`;项目级确认后使用 `current_stage: script` 与 `current_episode: ep_1` 开始第 1 集详细剧本。轻量模式规划页取得 `generate` 后,立即把五个中间阶段写为 `merged`、把 `current_episode` 设为 `ep_1` 并进入 `final`。媒体或文档验证通过后才能递增 revision 并更新状态;文件存在、接口成功或聊天中声称完成都不能单独证明阶段完成。

### 用户确认记录.jsonl

每次收到用户对当前阶段的明确确认后追加一行,禁止代理预写、补写或把无回复视为确认:

```json
{"stage":"planning","episode_id":"","revision":1,"decision":"confirmed","confirmation_mode":"full","changed_artifacts":[],"impact_scope":[],"confirmation_purpose":"project_execution","interaction_ask_call_id":"实际确认调用 ID","interaction_ask_result":"proceed_project","user_message":"用户通过确认工具确认项目方案的原文","confirmed_at":"2026-09-08T12:00:00+08:00"}
{"stage":"script","episode_id":"ep_1","revision":2,"decision":"confirmed","confirmation_mode":"full","changed_artifacts":[],"impact_scope":[],"confirmation_purpose":"","interaction_ask_call_id":"","interaction_ask_result":"","user_message":"用户确认第 1 集详细剧本的原文","confirmed_at":"2026-09-08T12:05:00+08:00"}
{"stage":"assets","episode_id":"ep_1","revision":2,"decision":"confirmed","confirmation_mode":"full|incremental","base_revision":1,"changed_artifacts":[],"impact_scope":[],"confirmation_purpose":"","interaction_ask_call_id":"","interaction_ask_result":"","user_message":"用户本轮明确回复原文","confirmed_at":"2026-09-08T12:10:00+08:00"}
```

- `planning` 始终是项目级确认。`script` 有两种作用域:项目级故事包确认的 `episode_id` 留空;分集详细剧本确认必须填写当前 `episode_id`。`assets|storyboard|keyframes|video|final` 始终填写当前 `episode_id`。同名阶段在不同作用域或不同集的确认记录不能互相替代。
- 完整模式且 `target_stage=video|final` 时,planning 写 `project_execution/proceed_project`。轻量模式直接执行标准视频生成确认,planning 写 `video_generation/generate`;同一次调用还登记为当前唯一视频的 `generation_confirmations`。所有视频确认结构只读取 `interaction-ask-video-clarification-ref.md`。
- 当目标继续到成片时,进入拼接的同一次 `interaction.ask` 还必须原子写入 `stage=video` 的确认记录:`confirmation_purpose: video_acceptance_and_final_assembly`、与 `assembly_confirmation` 相同的 `interaction_ask_call_id`、`interaction_ask_result: proceed_assembly`。当 `objective.target_stage=video` 时,video 阶段只做普通产物确认并停止,不创建虚假的拼接授权。
- `user_message` 保存触发继续的用户原文;空值、系统生成文字或仅有内部检查结果无效。
- `confirmed_at` 必须是带时区的 ISO-8601 时间。
- 首次确认或重大修改使用 `confirmation_mode: full`;此时 `base_revision` 可省略,`changed_artifacts` 与 `impact_scope` 可为空。已有真实全量确认基础上的局部微调可使用 `incremental`,必须记录上一全量确认 revision、实际变化文件和影响范围;禁止第一次确认就写 `incremental`。
- 用户提出修改时不写 `confirmed`;完成修改、重新展示并再次收到明确确认后才追加新记录。
- 阶段状态写为 `confirmed` 时必须存在同阶段有效确认记录;后续阶段校验会据此阻断跳步。

### 合规证明_阶段名.json

只有宿主或用户明确要求额外审计证明时,才在 `00_制作控制/合规证明/` 保存对应证明;它不是常规阶段准出硬门。完整委派规则读取 `delegation.md`,建议结构为:

```json
{
  "stage": "planning|script|assets|storyboard|keyframes|video|final",
  "executor": "main_agent|main_agent_director",
  "delegated": false,
  "skill_read": ["SKILL.md"],
  "upstream_artifacts": [
    {
      "path": "项目根目录内相对路径",
      "sha256": "64位小写十六进制",
      "revision": 1
    }
  ],
  "tool_calls": [
    {
      "operation_id": "与操作日志一致的唯一 ID",
      "tool": "实际工具名",
      "status": "completed",
      "evidence_path": "/absolute/path/to/evidence",
      "evidence_sha256": "64位小写十六进制",
      "observed_metadata": {"width": 1080, "height": 1920}
    }
  ],
  "delegations": [],
  "forbidden_tools_used": [],
  "declaration": "本阶段严格遵循skill要求,未使用禁止的替代工具;本阶段委派情况与 delegation.md 一致"
}
```

`planning|script|storyboard` 的 `delegated` 必须为 `false` 且 `delegations` 为空。`assets|keyframes` 只有在图片工具执行被外包时才记录委派;`video` 只要发生实际视频生成/编辑工具调用,`delegated` 必须为 `true` 并记录 `video_execution` 交接包;`final` 只要发生拼接、裁剪、混音、mux、字幕烧录等媒体变更工具调用,`delegated` 必须为 `true` 并记录 `final_media_execution` 交接包。每个交接包使用 Skill 内或项目内相对路径,保存逐文件输出白名单、实际输出、硬约束、验收标准、检查命令和禁止再委派声明;画布写入、用户交付、确认工具调用和阶段状态收口不得出现在 subagent 委派范围内。
当前 `drama_lint.py` 的输出就是本次结构检查结果,不回填到被检查的合规证明中,避免证明文件预先声明自身已通过。`declaration` 必须以 `本阶段严格遵循skill要求,未使用禁止的替代工具` 开头,后面允许追加本阶段真实说明。
规划、剧本和分镜属于纯文件创作阶段,没有外部生成调用时 `tool_calls` 直接写空数组,不得虚构 `file_creation`。除规划外,`upstream_artifacts` 必须完整覆盖上一阶段当前确认产物,每项记录项目内绝对路径、确认 revision 和确认记录中的 SHA-256。资产、关键帧、视频和成片属于生成或媒体处理阶段,必须保存实际调用;每项引用 `操作日志.jsonl` 中同名、同阶段且状态为 `succeeded` 的 `operation_id`,工具名必须一致,证据文件必须列在该操作的 `outputs` 中、实际存在且 SHA-256 匹配。图片和视频输出还必须保存真实文件探测得到的 `observed_metadata`,并与日志 `output_metadata` 一致。

### 操作日志.jsonl

每次外部生成、媒体处理或重要阶段状态变更追加一行;普通 Markdown/JSON 写入不需要伪装成工具调用。尚未发生操作时允许文件为空:

```json
{"operation_id":"","idempotency_key":"","input_revision":1,"stage":"","target_ids":[],"tool":"","params_summary":{},"attempt":1,"status":"started|succeeded|partial|failed","outputs":[],"output_metadata":{},"recovery_action":"","timestamp":"2026-09-08T12:00:00+08:00","prev_hash":"上一条 record_hash;首条为 64 个 0","record_hash":"当前对象移除 record_hash 后按键排序紧凑 JSON 的 SHA-256"}
```

操作日志按时间顺序追加,不修改历史行。`prev_hash` 与 `record_hash` 仅在宿主提供可信签名或哈希能力时启用,不作为当前 `drama_lint.py` 的阶段硬门。恢复任务时先读取 `制作状态.json`、`last_successful_operation`、操作日志和实际文件。外部调用部分成功时保留成功输出,只补失败项,不重复执行已成功调用。

### 校验器效率模式

- `--stage planning|script|assets|storyboard|keyframes|video|final|all` 选择阶段检查范围;`--stage all` 用于最终发布或专项审计。
- `--changed-file <项目内文件>` 可重复传入,仅为旧调用兼容;当前实现仍执行所选 `--stage` 的完整检查,不做依赖图裁剪。
- `--fix` 仅为旧调用兼容,当前不自动创建、补写或修改任何项目文件。
- 项目初始化、新版本复制、引用更新和剧本合同同步当前均由主 Agent 按本文件规则完成,不得调用校验器未提供的参数。

### project_script_manifest.json

完整模式必须创建;轻量模式不创建本文件或独立 Markdown 剧本。完整模式的 Markdown `剧本_全剧完整剧本.md` 必须完整覆盖开端、发展、高潮、结局、人物弧、主要伏笔及每集/单部局势变化,但不替代逐集执行剧本:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "revision": 1,
  "global_story_and_episode_outline": "01_剧本/剧本_全局设定与分集总纲.md",
  "source_markdown": "01_剧本/剧本_全剧完整剧本.md",
  "source_sha256": "",
  "episode_count": 2,
  "total_duration_s": 240,
  "episodes": [
    {
      "episode_id": "ep_1",
      "duration_s": 120,
      "opening_state": "",
      "main_conflict": "",
      "major_turns": [],
      "climax_or_payoff": "",
      "ending_state": "",
      "next_hook": "",
      "detailed_script": "",
      "script_contract": ""
    }
  ],
  "character_arcs": [],
  "plot_threads": [],
  "final_resolution": ""
}
```

- 项目级故事包检查要求 `项目设定卡.md`、`剧本_全局设定与分集总纲.md` 和项目级完整剧本正文存在;未来集的 `detailed_script` 与 `script_contract` 允许为空。当前集详细剧本完成后再填写对应路径,且路径必须真实存在。
- `global_story_and_episode_outline` 固定指向合并文件。该文件必须同时包含“全局故事圣经”和“分集推进总纲”两个一级章节,不再保存两个独立同名文件。
- `episodes` 数量、顺序和时长必须与 `drama_plan.json` 一致,并覆盖每个 `ep_N` 的开场状态、冲突、主要变化、高潮/兑现、结尾状态及下一钩子。
- `character_arcs`、`plot_threads` 和 `final_resolution` 保证人物弧、伏笔与结局跨集闭合。
- 每集详细完整剧本在该集开始制作时保存到 `episodes/ep_N/01_剧本/`;它必须细化项目级完整故事,不得改变其中的核心因果、结局或集间承接。需要改变时先更新项目级故事包并使受影响分集失效。

### source_manifest.json

用户上传和外部引用的图片、视频、音频、文档必须登记;没有素材时写空 `sources`,不得省略文件:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "revision": 1,
  "sources": [
    {
      "source_id": "SRC001",
      "media_type": "image|video|audio|document",
      "source_uri": "",
      "stored_path": "",
      "sha256": "",
      "source_origin": "user_upload|external_reference|generated"
    }
  ]
}
```

- 每个用户提供的 URL、附件 ID 或输入实例都必须先作为独立来源登记,即使系统提示给出相同 `local path`、相同 `image.png` 或相同 basename。`source_uri` 保存原始 URL 或可追溯附件标识;`stored_path` 使用 `SRCxxx` 唯一命名,禁止多个不同 URL 写入同一路径或互相覆盖。只有逐 URL 读取、保存并计算 `sha256` 之后,才允许把内容哈希完全相同的文件标记为重复内容;重复内容仍保留各自 `source_id` 与原始 URL 记录,不能删除来源。
- 本地文件必须记录实际 `stored_path` 和 `sha256`;纯 URL 保存规范化 `source_uri`。需要作为视觉参考、文字来源或后续工具输入的 URL 必须下载或转存到项目内并记录 `stored_path`,不能只保留 URL 文本。
- `stored_path` 必须是项目根目录内的相对路径;结构检查会重新计算文件 SHA-256,声明值与当前文件不一致时立即阻断。
- 需要复制或下载到项目内的输入统一保存为 `00_制作控制/输入素材/来源_SRCxxx_[原始名称]_vNN.[ext]`;仅服务单集时追加 `_ep_N`。
- 用途、采用范围和授权说明可按项目需要补充,但不作为自动检查字段。

### project_data_card.json

本文件只用于完整模式,在项目级完整剧本确定后立即创建。它是“一次定义、全局引用”的机器权威。身份字段不可被分集覆盖;服装、发型、妆容、伤痕、场景布置、灯光和道具完整性等变化只能通过带时间范围与原因的状态记录生效:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "revision": 1,
  "global_settings": {
    "project_name": "",
    "style_asset_id": "STYLE001",
    "ratio": "9:16",
    "episode_count": 2,
    "episode_durations_s": [120, 120],
    "subtitle_style": {}
  },
  "shared_baseline": {
    "registry_revision": 1,
    "status": "planned|approved|not_created",
    "approved_asset_ids": []
  },
  "characters": [
    {
      "character_id": "CHR001",
      "identity_locked": {
        "representation_type": "live_action_human",
        "age_or_life_stage": "",
        "face_features": {},
        "skin_fur_feather_scale": "",
        "identity_marks": [],
        "height_and_body": "",
        "voice_id": "VOICE001"
      },
      "state_timeline": [
        {
          "state_id": "STATE001",
          "effective_from": "ep_1:E01S01",
          "effective_to": "",
          "reason": "初始状态",
          "changed_fields": ["initial_state"],
          "affected_shot_ids": [],
          "affected_segment_ids": [],
          "asset_version_ids": [],
          "clothing": {},
          "hairstyle": {},
          "makeup": {},
          "injury_or_surface_state": {}
        }
      ],
      "asset_refs": {
        "turnaround": "CHR001",
        "face_anchor": "CHR001",
        "state_assets": []
      }
    }
  ],
  "scenes": [
    {
      "scene_id": "SCN001",
      "layout_locked": {
        "space_boundary": "长方形办公室",
        "doors_windows": "入口在前墙左侧 百叶窗在左墙",
        "fixed_furniture": "办公桌居中 文件柜靠入口右侧",
        "main_routes": "入口至办公桌之间保留直线通道"
      },
      "consistency_anchors": [
        "门口右侧的绿色铁皮文件柜",
        "后墙中央停在 10:17 的圆形挂钟",
        "左侧百叶窗缺失第三片叶片",
        "桌面右角的红色旋转电话",
        "从门口延伸到办公桌的黑白方砖"
      ],
      "base_lighting_locked": {
        "source": "阴天上午的窗外自然光",
        "direction": "从画面左侧射入",
        "temperature": "偏冷中性色温"
      },
      "state_timeline": [
        {
          "state_id": "STATE001",
          "effective_from": "ep_1:E01S01",
          "effective_to": "",
          "reason": "剧情初始发生在阴天上午",
          "changed_fields": ["initial_state"],
          "observable_state": "阴天上午 冷光从左侧进入 固定陈设保持基准布局",
          "affected_shot_ids": [],
          "affected_segment_ids": [],
          "asset_version_ids": []
        }
      ],
      "asset_ref": "SCN001"
    }
  ],
  "props": [
    {
      "prop_id": "PROP001",
      "scale_class": "handheld",
      "scale_reference": "成人单手可握 约 9 厘米长",
      "appearance_locked": {
        "shape": "长方形旧皮盒",
        "material": "深棕色磨损皮革",
        "identity_marks": ["右下角三道斜向划痕"]
      },
      "narrative_functions": [
        {"episode_id": "ep_1", "scene_id": "E01S01", "function": "制造父亲遗物的悬念"},
        {"episode_id": "ep_2", "scene_id": "E02S03", "function": "通过调包改变证据归属"}
      ],
      "state_timeline": [
        {
          "state_id": "STATE001",
          "effective_from": "ep_1:E01S01",
          "effective_to": "ep_2:E02S02",
          "reason": "初始状态",
          "changed_fields": ["initial_state"],
          "observable_state": "闭合 完整 内有文件 女主持有",
          "affected_shot_ids": [],
          "affected_segment_ids": [],
          "asset_version_ids": []
        }
      ],
      "asset_ref": "PROP001"
    }
  ],
  "voices": [
    {
      "voice_id": "VOICE001",
      "owner_id": "CHR001",
      "voice_locked": {
        "age_and_gender_expression": "",
        "pitch_and_timbre": "",
        "accent_and_language": "",
        "pace": "",
        "rhythm_and_pauses": "",
        "baseline_emotion": "",
        "sentence_ending": "",
        "forbidden_drift": []
      },
      "voice_anchor": "25岁年轻女性 声音清亮 普通话标准 略带紧张感 语速偏快",
      "asset_ref": "VOICE001"
    }
  ]
}
```

完整模式在剧本阶段首次创建数据卡时写 `shared_baseline.status: planned`,资产阶段完成后更新为 `approved` 并填入真实批准资产 ID。轻量模式不创建本文件;用户已有素材和文字约束直接由已确认规划、来源登记与内部十五列分镜承接。

- 当前 `drama_lint.py` 对 `project_data_card.json` 只检查文件是否存在,不解析或评价其中的身份、关系、状态、声音和视觉合同内容;这些内容由主 Agent 按已确认剧本和阶段 Reference 人工复核。不得把 lint 通过解释为数据卡内容正确。
- 面部/头面结构、肤色或物种表面、身份标志、身高体型和 `voice_id` 属于身份锁定项,除非项目级剧本明确发生永久性身份变化,否则不得修改。
- 完整模式中,`shared_baseline.status` 在 CHR/SCN/PROP/VOICE/STYLE 实际生成并通过集中验收前不得写 `approved`;分镜只能在该状态为 `approved` 且资产阶段经用户确认后开始。轻量模式不适用本数据卡及批准门。
- 服装、发型、妆容、伤痕和表面状态可变,但每次变化必须有 `state_id/effective_from/effective_to/reason/changed_fields`,且 `changed_fields` 不得为空;同一 SEG 内无换装/造型镜头时不得切换状态。
- 已进入分镜或生成阶段的状态变化还要填写 `affected_shot_ids`、`affected_segment_ids` 和 `asset_version_ids`;基础初始状态可以使用空数组。
- 场景 `layout_locked` 固定户型、门窗朝向、固定家具与主要通道;`consistency_anchors` 必须选择 `3-5` 个包含对象、外观和固定位置的唯一可见锚点;`base_lighting_locked` 只锁定剧本实际使用的基础光照,`state_timeline` 只记录有剧情原因的布置或灯光变化。
- 道具 `appearance_locked` 固定颜色、形状、材质和标志性磨损;`scale_class/scale_reference` 锁定尺度,`narrative_functions` 逐场记录剧情功能,位置、归属、开合、内容物、破损和完整性变化进入带原因与可观察结果的 `state_timeline`。
- 下游 Prompt 必须记录采用的数据卡 revision、角色/场景/道具 ID 与当前 `state_id`,不得复制后再自行改写基础设定。

### asset_registry.json

共享资产的唯一权威登记:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "revision": 1,
  "assets": [
    {
      "asset_id": "CHR001|SCN001|PROP001|VOICE001|STYLE001",
      "category": "character|scene|prop|voice|style",
      "name": "",
      "version": "v01",
      "status": "draft|reviewed|approved|rejected|superseded",
      "files": [],
      "source_ids": [],
      "reference_asset_ids": [],
      "locked_features": [],
      "variable_states": [],
      "used_by_episodes": ["ep_1"],
      "used_by_shots": [],
      "generation": {
        "tool": "",
        "model": "",
        "task_id": "",
        "prompt_path": ""
      },
      "last_reviewed": ""
    }
  ]
}
```

同一 `asset_id + version` 只允许一条权威记录。分集不得复制共享文件,只能通过 `asset_usage_ep_N.json` 引用。
图片资产的 `generation.tool` 只按当前目标实际采用的视觉输入填写:`generation.reference_inputs|input_files|input_images`、`reference_asset_ids` 和 `style_anchor_reference_ids` 均为空时才可使用 `image_gen`;其中任一项登记了真实图片时使用 `image_edit`。`source_ids` 只表示来源追溯,不单独决定工具路由;文本、脚本、知识来源或只含文字的截图不得因存在 `source_id` 被误判为视觉参考图。

### episode_seams.json

只登记跨集边界;集内片段接缝由 `continuity_ep_N.json` 管理:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "revision": 1,
  "seams": [
    {
      "seam_id": "EPSEAM001",
      "from_episode": "ep_1",
      "to_episode": "ep_2",
      "from_segment": "",
      "to_segment": "",
      "actual_tail_frame": "episodes/ep_1/04_视频片段/抽帧/FRMxxx_tail_vNN_ep_1.png",
      "actual_tail_sha256": "",
      "visual_state": {},
      "audio_state": {},
      "unresolved_hooks": [],
      "cut_strategy": "",
      "seam_mode": "continuous|elliptical",
      "required_invariants": ["identity", "screen_direction"],
      "permitted_deltas": [],
      "status": "planned|verified|blocked"
    }
  ]
}
```

完整模式的单集作品保留该文件并写空 `seams`。`continuous` 表示叙事状态连续,`permitted_deltas` 必须为空;`elliptical` 表示明确的时间、空间或认知跳跃,必须列出至少一个允许变化维度。跨集接缝在分镜阶段可先写 `planned`;上一集视频完成后复核画面、声音、未决钩子、接缝模式和切换策略,再改为 `verified`。`continuous` 必须把真实尾帧路径和 SHA-256 写入 `actual_tail_frame/actual_tail_sha256`;`elliptical` 可记录尾帧供追溯,但下一集不必把它作为视觉输入。下一集首段只能消费完整复制的 verified 记录。轻量模式只有一个视频,不创建本文件。
## 每集 JSON

### episode_manifest_ep_N.json

每集总入口只保存身份和各阶段文件指针:

```json
{
  "schema_version": "1.0",
  "project_id": "",
  "episode_id": "ep_1",
  "episode_number": 1,
  "revision": 1,
  "duration_s": 120,
  "duration_display": "2分钟",
  "stage_manifests": {
    "script": "episodes/ep_1/01_剧本/script_contract_ep_1.json",
    "storyboard": "episodes/ep_1/02_分镜/storyboard_ep_1.json",
    "assets": "episodes/ep_1/03_资产/asset_usage_ep_1.json",
    "keyframes": "episodes/ep_1/03_资产/keyframe_manifest_ep_1.json",
    "video": "episodes/ep_1/04_视频片段/video_manifest_ep_1.json",
    "continuity": "episodes/ep_1/04_视频片段/continuity_ep_1.json",
    "delivery": "episodes/ep_1/05_成片/delivery_manifest_ep_1.json"
  }
}
```

轻量模式仍保留同一 `stage_manifests` 键集,但 `script|assets|keyframes|continuity` 写空字符串,`storyboard` 直接指向 `episodes/ep_1/02_分镜/分镜_完整分镜表_ep_1.md`,`video|delivery` 指向实际 manifest。不得为填充这些路径创建无用途的完整模式文件。

### script_contract_ep_N.json

保存剧本的机器执行合同,不复制剧情梗概:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "source_markdown": "episodes/ep_1/01_剧本/剧本_完整剧本_ep_1.md",
  "source_sha256": "",
  "duration_s": 120,
  "story_engine": {
    "dramatic_question": "",
    "protagonist_desire": "",
    "opposition": "",
    "stakes": "",
    "irreversible_choice": "",
    "episode_payoff": ""
  },
  "opening_contract": {
    "plan_opening_id": "OPEN001",
    "inheritance_mode": "direct|episode_variation",
    "variation_reason": "",
    "primary_type": "mystery_question|world_spectacle|character_portrait|visual_spectacle|conflict_driven|custom",
    "supporting_types": [],
    "scene_id": "E01S01",
    "opening_window": "",
    "first_observable_promise": "",
    "escalation_trigger": "",
    "payoff_or_rollover": ""
  },
  "relationship_tension": [
    {
      "relationship_id": "REL001",
      "characters": ["CHR001", "CHR002"],
      "initial": {"power_gap": "", "information_gap": "", "emotional_gap": ""},
      "change_nodes": [{"scene_id": "E01S01", "cause": "", "after": {"power_gap": "", "information_gap": "", "emotional_gap": ""}, "blocking_implication": ""}]
    }
  ],
  "reveal_ledger": [
    {"reveal_id": "REV001", "fact": "", "plant_scene": "E01S01", "development_scene": "E01S02", "reveal_scene": "E01S03", "consequence": ""}
  ],
  "shareable_line": {
    "mode": "dialogue|visual|sound|exception",
    "line_id": "LINE001",
    "text_or_motif": "",
    "placement": "climax|reversal|ending",
    "dramatic_support": ""
  },
  "highlight_ledger": [
    {
      "highlight_id": "HL001",
      "role": "primary|supporting",
      "episode_id": "ep_1",
      "scene_id": "E01S03",
      "dimension": "关系攻防|信息重释|专业能力|标志性场面|视觉母题|声音母题|表演瞬间|情绪余震|结构形式|传播台词|custom",
      "setup_evidence": "",
      "payoff_action": "",
      "state_change": "",
      "subject_function": "",
      "format_expression": "",
      "aftereffect": ""
    }
  ],
  "scenes": [
    {
      "scene_id": "E01S01",
      "location_id": "SCN001",
      "characters": ["CHR001"],
      "character_states": ["CHR001:STATE001"],
      "prop_states": ["PROP001:STATE001"],
      "data_card_deltas": [],
      "goal": "",
      "obstacle": "",
      "strategy_shift": "",
      "state_change": "",
      "entry_goal": "",
      "tactic": "",
      "countermove": "",
      "turn": "",
      "exit_value": "",
      "speech_lines": [
        {
          "line_id": "LINE001",
          "speaker": "CHR001",
          "voice_id": "VOICE001",
          "voice_anchor": "25岁年轻女性 声音清亮 普通话标准 略带紧张感 语速偏快",
          "type": "on_screen_dialogue|narration|voiceover|inner_monologue",
          "source_text": "",
          "display_text": "",
          "spoken_text": "",
          "delivery_intent": "",
          "pause_plan": "",
          "emotion": "",
          "emphasis_words": []
        }
      ]
    }
  ]
}
```

剧本索引自动检查正文引用、场次编号、音色资产引用及主要亮点 ID;剧情质量、关系、表演与表达仍由创作者和用户判断。`role=primary` 的亮点必须在分镜 `highlight_bindings` 中逐项兑现。

### storyboard_ep_N.json

本 JSON 只用于完整模式,保存与十五列详细分镜逐镜对应的机器字段、片段规划和运镜合同。轻量模式只生成 `分镜_完整分镜表_ep_1.md`,不创建本 JSON:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "source_markdown": "episodes/ep_1/02_分镜/分镜_完整分镜表_ep_1.md",
  "director_control_card": "episodes/ep_1/02_分镜/导演总控卡_ep_1.md",
  "source_sha256": "",
  "duration_s": 120,
  "audience_execution": {
    "source_plan_revision": 1,
    "viewing_focus": {
      "source_field": "audience_plan.viewing_focus",
      "contract": "继承已确认受众的首要观看焦点",
      "scene_or_shot_ids": ["E01S01-SHOT001"]
    },
    "emotional_payoff": {
      "source_field": "audience_plan.emotional_payoff",
      "contract": "本集承担的情绪回报",
      "scene_or_shot_ids": ["E01S03-SHOT004"]
    },
    "platform_viewing_context": {
      "source_field": "audience_plan.platform_viewing_context",
      "contract": "已确认平台观看场景下的可读性执行",
      "scene_or_shot_ids": ["E01S01"]
    },
    "expression_boundaries": {
      "source_field": "audience_plan.expression_boundaries",
      "contract": "继承已确认表达禁区及规避方式",
      "scene_or_shot_ids": ["E01S02-SHOT003"]
    }
  },
  "highlight_bindings": [
    {
      "highlight_id": "HL001",
      "segment_id": "SEG003",
      "causal_chain": {
        "trigger": {"description": "", "shot_ids": ["E01S03-SHOT002"]},
        "change": {"description": "", "shot_ids": ["E01S03-SHOT003"]},
        "feedback": {"description": "", "shot_ids": ["E01S03-SHOT004"]},
        "result": {"description": "", "shot_ids": ["E01S04-SHOT001"]}
      },
      "payoff_shot_ids": ["E01S03-SHOT003"],
      "reaction_shot_ids": ["E01S03-SHOT004"],
      "visual_execution": "",
      "performance_execution": "",
      "audio_execution": "",
      "aftereffect_shot_ids": ["E01S04-SHOT001"],
      "deferred_aftereffect_ref": null,
      "compile_notes": ""
    }
  ],
  "inherited_aftereffect_bindings": [],
  "shots": [],
  "segments": [
    {
      "segment_id": "SEG001",
      "shot_mode": "edited|true_one_take",
      "density_profile": "high_density_short|dialogue_emotional|suspense_build|micro_film|custom",
      "density_rationale": "",
      "indivisible_action_units": [
        {
          "action_unit_id": "ACTU001",
          "state_before": "",
          "action_and_path": "",
          "feedback": "",
          "state_after": "",
          "shot_ids": ["E01S01-SHOT001"]
        }
      ],
      "opening_event_chain": [],
      "tail_mode": "continuous_motion|cuttable_completion|stable_hold|loop_continuation",
      "tail_hold_reason": "",
      "tail_selection_reason": "",
      "one_take_route": null,
      "shot_ids": ["E01S01-SHOT001"]
    }
  ],
  "seams": [
    {
      "seam_id": "SEAM001",
      "from_segment": "SEG001",
      "to_segment": "SEG002"
    }
  ]
}
```

分镜索引自动检查正文引用、镜头编号、片段对镜头的完整覆盖、相邻片段引用、主要亮点绑定和受众执行落点。`shot_mode` 只能为 `edited|true_one_take`;`true_one_take` 必须且只能引用一个 SHOT,并由导演总控卡证明没有硬切、隐藏切、遮挡伪切、匹配剪辑或时间跳跃,`one_take_route` 记录连续摄影机路线与至少三个可观察节点。`density_profile` 用于区分高密度平台短片、对白/情感、悬疑蓄力、微电影/生活流和自定义节奏;`density_rationale` 记录主导内容负载和排除理由,`indivisible_action_units` 记录动作单元到 SHOT 的映射。只有 `high_density_short + edited + 15秒` 执行最低 8 镜,并在 `opening_event_chain` 记录黄金三秒的异常/承诺、主体行动/目标和反馈/观看关系变化;其他类型该数组可为空。`tail_mode` 必须按片段职责选择,`tail_selection_reason` 记录选择依据;中间 SEG 默认 `continuous_motion|cuttable_completion`,使用 `stable_hold` 时填写 `tail_hold_reason`,最终 SEG 默认 `stable_hold`,Loop 使用 `loop_continuation`。`highlight_bindings[].causal_chain` 按触发、变化、反馈、结果记录可观察事实和镜头;变化/兑现映射到 `payoff_shot_ids`,反馈映射到 `reaction_shot_ids`,结果映射到本集 `aftereffect_shot_ids` 或跨集引用。`highlight_bindings` 必须覆盖 `script_contract.highlight_ledger` 中全部 `role=primary` 项;`segment_id` 是亮点兑现所在 SEG,`payoff_shot_ids` 必须属于该 SEG,`reaction_shot_ids` 可落在本集后续 SEG且不得早于兑现镜头。余震在本集发生时填写真实 `aftereffect_shot_ids`,这些镜头不得早于兑现/反应镜头;计划在后续集回收时留空该数组,并把 `deferred_aftereffect_ref` 写成 `{"episode_id":"ep_2","highlight_id":"HL001","binding_id":"HL001-aftereffect"}`。目标集对应绑定必须用相同 `binding_id` 写入 `inherited_aftereffect_bindings[]`,每项结构为 `{"binding_id":"","source_episode_id":"ep_1","source_highlight_id":"HL001","shot_ids":[]}`,形成反向承接。每项还必须填写视觉、表演、声音和视频编译说明。`audience_execution.source_plan_revision` 必须等于当前已确认 `drama_plan.revision`;四项执行合同必须各自填写固定 `source_field` 并逐字继承当前 `audience_plan` 对应值,再绑定到真实场次或镜头,不得在分镜阶段重新画像或更换受众。上述推导字段由主 Agent 按 `storyboard.md` 人工复核;lint 不对其创意质量打分。

### asset_usage_ep_N.json

保存本集资产快照和本集状态资产:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "shared_assets": [
    {
      "asset_id": "CHR001",
      "version": "v01",
      "registry_path": "shared/03_资产/asset_registry.json",
      "used_by_shots": []
    }
  ],
  "episode_assets": [
    {
      "asset_id": "CHR001",
      "state_id": "STATE002",
      "version": "v02",
      "files": ["episodes/ep_1/03_资产/角色状态/角色_CHR001_林远_战损_v02_ep_1.png"],
      "effective_shots": [],
      "status": "draft|reviewed|approved|rejected|superseded"
    }
  ]
}
```

### keyframe_manifest_ep_N.json

保存分镜确认后生成的剧情关键帧职责、文件与验收状态:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "script_contract": "episodes/ep_1/01_剧本/script_contract_ep_1.json",
  "storyboard_manifest": "episodes/ep_1/02_分镜/storyboard_ep_1.json",
  "project_data_card": "00_制作控制/project_data_card.json",
  "keyframes": [
    {
      "keyframe_id": "KF001",
      "segment_id": "SEG001",
      "shot_id": "E01S01-SHOT001",
      "role": "highlight",
      "highlight_index": 1,
      "data_card_revision": 1,
      "asset_refs": ["CHR001_v01", "SCN001_v01", "PROP001_v01"],
      "state_refs": ["CHR001:STATE001"],
      "information_triggers": ["space_anchor"],
      "narrative_state": "",
      "character_state": {},
      "prop_state": {},
      "scene_and_light": {},
      "camera_and_composition": {},
      "continuity_from": "",
      "prompt_path": "episodes/ep_1/03_资产/提示词/提示词_KF001_SEG001_highlight-1_v01_ep_1.md",
      "prompt_sha256": "",
      "file": "episodes/ep_1/03_资产/关键帧/关键帧_KF001_SEG001_highlight-1_v01_ep_1.png",
      "tool": "image_edit",
      "model": "",
      "version": "v01",
      "status": "draft|reviewed|approved|rejected|superseded",
      "used_by_segments": ["SEG001"]
    }
  ]
}
```

- `storyboard_manifest` 必须引用当前已确认分镜;`segment_id`、`shot_id` 和 `used_by_segments` 必须与分镜中的真实片段和镜头一致。
- `role` 固定为 `highlight`,`highlight_index` 是同一 SEG 内从 `1` 开始的高光序号。关键帧只锁定剧情峰值,不承担生成式首帧或尾帧职责。
- 同一视频片段采用的高光关键帧必须与 `storyboard_ep_N.json` 的高光需求一致;片段首尾连续性由真实 FRM、连续性账本和 `SEAMxxx` 负责。
- `tool/model/version/status` 记录 `keyframes.md` 的实际生成结果;视频输入关系记录 `video.md` 的实际调用结果。
- 视频生成后的 `FRMxxx` 抽帧不能回写覆盖 `KFxxx`;偏差通过内部记录保存,只有用户主动要求修改并重新确认后才返修分镜、关键帧或视频。

### video_manifest_ep_N.json

作为本集视频生成结果的权威索引;`00_制作控制/批次/*.json` 继续保存单次请求快照:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "storyboard_manifest": "episodes/ep_1/02_分镜/storyboard_ep_1.json",
  "duration_s": 12,
  "generation_confirmations": [
    {
      "confirmation_id": "VC001",
      "attempt": 1,
      "supersedes_confirmation_ids": [],
      "batch_start_segment_index": 1,
      "batch_end_segment_index": 1,
      "model": "seedance 2.0 fast",
      "aspect_ratio": "9:16",
      "duration_s": 12,
      "planned_video_count": 1,
      "segment_durations": [
        {"segment_id": "SEG001", "duration_s": 12}
      ],
      "displayed_parameter_table": {
        "task_type": "图片生成视频",
        "delivery_format": "MP4 视频片段",
        "quantity": 1,
        "segment_durations": ["SEG001:12秒"],
        "total_duration": "12秒",
        "aspect_ratio_and_resolution": "9:16,按当前模型实际分辨率",
        "model": "seedance 2.0 fast",
        "visual_and_continuity": "按已确认角色、场景与上一段承接关系生成",
        "audio_and_subtitles": "保留本段完整对白,不生成画面字幕",
        "reference_materials": "当前角色、场景与高光关键帧",
        "tool_limits_and_cost": "本批 1 个视频;视频生成为高消耗生成"
      },
      "displayed_storyboard_rows": [
        {
          "segment_id": "SEG001",
          "duration_s": 12,
          "visual_content": "本段从起点到结果的可见剧情内容",
          "subject_action": "主体动作、反馈与尾态",
          "audio": "声音类型与完整台词",
          "camera_and_materials": "主要运镜、承接方式与真实输入素材"
        }
      ],
      "creative_direction": "按已确认分镜生成本段剧情",
      "cost_notice": "视频生成会消耗更多积分或额度",
      "membership_notice": "",
      "final_parameters_text": "| 参数 | 本批次确认值 |\\n|---|---|\\n| 任务类型 | 图片生成视频 |\\n| 交付格式 | MP4 视频片段 |\\n| 数量 | 1 |\\n| 分段时长 | SEG001:12秒 |\\n| 总时长 | 12秒 |\\n| 画幅与分辨率 | 9:16,按当前模型实际分辨率 |\\n| 视频模型 | seedance 2.0 fast |\\n| 视觉与连续性 | 按已确认角色、场景与上一段承接关系生成 |\\n| 声音与字幕 | 保留本段完整对白,不生成画面字幕 |\\n| 参考素材 | 当前角色、场景与高光关键帧 |\\n| 工具限制与消耗 | 本批 1 个视频;视频生成为高消耗生成 |\\n\\n| 片段与时长 | 画面内容 | 主体动作 | 声音与完整台词 | 运镜与素材 |\\n|---|---|---|---|---|\\n| SEG001|12秒 | 本段从起点到结果的可见剧情内容 | 主体动作、反馈与尾态 | 声音类型与完整台词 | 主要运镜、承接方式与真实输入素材 |",
      "interaction_ask_call_id": "实际确认调用 ID",
      "interaction_ask_result": "generate",
      "user_message": "用户通过确认工具选择生成的原文",
      "confirmed_at": "2026-09-08T12:00:00+08:00"
    }
  ],
  "segments": [
    {
      "segment_id": "SEG001",
      "episode_segment_index": 1,
      "shot_ids": ["E01S01-SHOT001"],
      "batch_id": "",
      "tool_mode": "image_to_video",
      "model": "seedance 2.0 fast",
      "source_video_file": "",
      "edit_verification": null,
      "duration_s": 12,
      "observable_state_changes": ["发现门锁异常", "抬头确认门后有人"],
      "compiled_prompt_file": "episodes/ep_1/04_视频片段/提示词_SEG001_v01_ep_1.md",
      "prompt_sha256": "",
      "prompt_preflight": {
        "review_count": 1,
        "revision_count": 0,
        "final_validation_count": 1,
        "five_sections_in_order": true,
        "shot_ids_compiled_once": ["E01S01-SHOT001"],
        "result": "passed"
      },
      "reference_inputs": [
        {
          "order": 1,
          "source_type": "asset",
          "source_id": "CHR001_v01",
          "file": "shared/03_资产/角色/角色_CHR001_林远_基准状态_v01.png",
          "role": "identity_reference"
        }
      ],
      "required_reference_roles": ["identity_reference"],
      "audio_input_supported": false,
      "audio_inputs": [],
      "video_inputs": [],
      "voice_inputs": [],
      "native_audio_supported": true,
      "speech_mode": "native_required",
      "speech_lines": [
        {
          "speaker": "林远",
          "voice_id": "VOICE001",
          "voice_anchor": "28岁男性 声音低沉偏冷 平静克制 语速缓慢 字句间有停顿",
          "type": "on_screen_dialogue",
          "source_text": "你终于来了。",
          "display_text": "你终于来了。",
          "spoken_text": "你终于来了",
          "delivery_intent": "压低声音确认身份",
          "pause_plan": "",
          "emotion": "克制警觉",
          "emphasis_words": ["终于"]
        }
      ],
      "generation_confirmation_id": "VC001",
      "tool_call_id": "实际视频工具调用 ID",
      "tool_called_at": "2026-09-08T12:01:00+08:00",
      "output_file": "episodes/ep_1/04_视频片段/片段_SEG001_E01S01_v01_ep_1.mp4",
      "version": "v01",
      "status": "candidate|accepted|rejected|blocked",
      "qc_report": "",
      "incoming_episode_seam": null
    }
  ]
}
```

完整模式填写 `project_data_card_revision` 和 `storyboard_manifest`。轻量模式不创建这两个上游文件,因此在视频 manifest 中将对应字段留空;它改为通过请求快照记录 `episodes/ep_1/02_分镜/分镜_完整分镜表_ep_1.md` 和实际使用的 Prompt 路径,以维持生成追溯。

`segments[].status` 的状态语义固定为:

- `candidate`:片段已生成、保存、具备可渲染输出并完成即时交付,但尚未完成视频阶段用户确认;`drama_lint.py --stage video` 在发起确认前允许该状态。
- `accepted`:用户已明确接受该片段。目标继续到成片时,只能在 `proceed_assembly` 确认成功后,与视频阶段确认记录和 `assembly_confirmation` 原子写入;`objective.target_stage=video` 时,在普通视频阶段确认成功后写入。
- `rejected|blocked`:不得进入拼接或成片。`drama_lint.py --stage final|all` 要求本次采用的全部 SEG 均为 `accepted`。

`segments[].prompt_preflight` 记录每份五段式 Prompt 唯一的一轮集中预检与最终客观校验。`review_count` 和 `final_validation_count` 固定为 `1`,`revision_count` 只能为 `0|1`;`five_sections_in_order` 必须为 `true`,`shot_ids_compiled_once` 必须按分镜顺序恰好列出当前 SEG 的全部镜头且不重复,`result` 必须为 `passed` 后才能调用视频生成工具。SHOT ID 只保存在该映射中,不要求出现在最终自然语言 Prompt。该结构只证明客观合同完成,不代替导演对节奏、表演和审美的判断。

`generation_confirmations[]` 每项对应一次真实批次确认,必须满足:

- `confirmation_id` 全局唯一,`attempt` 为从 `1` 递增的正整数。首次确认的 `supersedes_confirmation_ids` 为空;重生或返修覆盖既有 SEG 时,新增确认记录并在该数组中列出所有范围重叠的旧确认 ID,禁止删除历史确认。替代关系只对新旧确认范围的交集生效:例如旧确认覆盖 SEG001-SEG002、新确认只覆盖 SEG001,则旧确认对 SEG002 继续有效。替代确认时间必须晚于被替代确认,每个 SEG 的 `generation_confirmation_id` 必须指向覆盖该 SEG 的最新有效确认。
- `planned_video_count` 只能为 `1|2`,并等于确认范围内 SEG 数、`segment_durations` 项数、`displayed_parameter_table.quantity` 和 `displayed_storyboard_rows` 行数。
- `segment_durations` 按 `episode_segment_index` 排序,每项 `segment_id` 与 `duration_s` 必须和同一 `video_manifest` 中对应 SEG 完全一致;`duration_s` 是本批次总时长,必须等于各项之和。
- `displayed_parameter_table` 表示实际展示的一张两列表格,字段不得拆成逐 SEG 参数表;其中“数量”和“分段时长”必须按当前批次真实值渲染。
- `displayed_storyboard_rows` 表示实际展示的一张五列表格;机器结构将第一列拆为 `segment_id + duration_s`,其余四列依次为 `visual_content`、`subject_action`、`audio`、`camera_and_materials`。每个 SEG 恰好一行,只能引用当前批次已确认分镜和真实素材。
- `final_parameters_text` 保存用户实际看到的完整普通文本,必须包含一张两列参数表和一张五列分镜表,不得包含第三张表;两张表之后才允许调用 `interaction.ask`。

轻量模式首次生成使用同一数组登记规划页的标准视频生成确认,并额外写 `confirmation_source: planning_preview`。范围固定为唯一视频;规划参数必须完整包含受保护确认 Ref 要求的任务类型、交付格式、数量、时长、比例与分辨率、视觉连续性、声音字幕、参考素材、模型限制与消耗。该记录的调用 ID、用户原文、时间和 `generate` 结果必须与 planning 确认一致。

`text_to_video` 不得登记媒体输入;`image_to_video` 只登记图片;`media_to_video` 至少登记视频或音频,可同时登记图片;`video_edit` 必须登记一个源视频,并写入 `edit_verification`:

```json
{
  "source_duration_s": 12,
  "output_duration_s": 12,
  "source_aspect_ratio": "9:16",
  "output_aspect_ratio": "9:16",
  "duration_preserved": true,
  "aspect_ratio_preserved": true
}
```

`ep_2` 及以后各集的首个 segment 将 `incoming_episode_seam` 写成 `episode_seams.json` 对应 `EPSEAMxxx` 的完整快照;`ep_1` 首段及非首段写 `null`。每个视频批次中的同名字段必须与该快照一致。

### continuity_ep_N.json

仅完整模式创建,用于保存本集抽帧和集内接缝;轻量模式不创建:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "frames": [
    {
      "frame_id": "FRM001",
      "segment_id": "SEG001",
      "role": "start|scene|tail",
      "target_keyframe_id": "KF001",
      "timecode": "",
      "file": "",
      "observed_state": {},
      "keyframe_deviation": {
        "status": "accepted|rework",
        "differences": []
      }
    }
  ],
  "seams": [
    {
      "seam_id": "SEAM001",
      "from_segment": "SEG001",
      "to_segment": "SEG002",
      "outgoing_window_frames": 12,
      "incoming_window_frames": 12,
      "selected_cut": {},
      "comparison": {
        "character_position": "accepted|rework",
        "pose_and_action_phase": "accepted|rework",
        "camera_angle_and_axis": "accepted|rework",
        "scene_layout_and_light": "accepted|rework"
      },
      "status": "planned|verified|blocked"
    }
  ]
}
```

### delivery_manifest_ep_N.json

保存最终采用片段、音轨、字幕和交付文件:

```json
{
  "schema_version": "1.0",
  "episode_id": "ep_1",
  "revision": 1,
  "project_data_card_revision": 1,
  "duration_s": 120,
  "duration_display": "2分钟",
  "assembly_confirmation": {
    "confirmation_purpose": "final_assembly",
    "interaction_ask_call_id": "实际确认调用 ID",
    "interaction_ask_result": "proceed_assembly",
    "segment_ids": ["SEG001", "SEG002"],
    "user_message": "用户通过确认工具同意进入拼接的原文",
    "confirmed_at": "2026-09-08T12:30:00+08:00"
  },
  "subtitle_enabled": false,
  "clean_master": "episodes/ep_1/05_成片/[项目名]_成片_[比例]_无字幕_v01_ep_1.mp4",
  "subtitle_master": "",
  "asr_source": "",
  "subtitle_source": "",
  "subtitle_final": "",
  "subtitle_burn_params": "",
  "basic_qc_reports": [
    "episodes/ep_1/05_成片/质检_基础_无字幕_v01_ep_1.json"
  ],
  "asr_alignment_report": "",
  "outputs": [
    "episodes/ep_1/05_成片/[项目名]_成片_[比例]_无字幕_v01_ep_1.mp4"
  ],
  "status": "deliverable|candidate|blocked"
}
```

轻量模式的 `project_data_card_revision` 留空,`assembly_confirmation` 使用空对象;完整模式按实际数据卡 revision 和拼接确认填写。

默认字幕关闭时,只保留无字幕母版对应的一项 `basic_qc_reports`,字幕相关路径留空,`outputs` 只能包含 `clean_master`。用户明确要求字幕时,无字幕母版作为内部烧录源保留,两种内部媒体各有一份基础可交付检查报告,并且必须存在 ASR 对齐报告;但 `outputs` 必须且只能包含 `subtitle_master`,不得把 `clean_master`、SRT、字幕 JSON 或检查报告作为额外交付物。

- 完整模式的 `assembly_confirmation` 保存进入本集成片拼接前的独立确认;`segment_ids` 必须按顺序精确等于本次采用的 accepted SEG,`interaction_ask_result` 固定为 `proceed_assembly`。轻量模式只有一个最终视频,不执行拼接,`assembly_confirmation` 留空。
- 最终交付校验时 `delivery_manifest_ep_N.json.status` 可以为 `deliverable|candidate`;`blocked` 不得交付。`candidate` 表示存在内部记录的内容风险,但只要客观可播放、可交付,就不得因最终内容质检缺失而扣住交付。该媒体状态不等于用户确认;用户确认仍记录在 `制作状态.json` 与 `用户确认记录.jsonl`。
- `basic_qc_reports` 由主 Agent 根据真实 mediakit 探测终态与实际播放结果生成,分别绑定对应成片、输入文件哈希和媒体探测结果。
- `asr_alignment_report` 由主代理依据 `delivery.md` 的顺序对齐规则生成,绑定当前分集 `script_contract`、`asr_source` 和实际带音轨媒体的路径、字节数与 SHA-256。
- 基础媒体检查结果为 `blocked` 时不得交付;字幕关闭时不执行语音对齐。字幕开启时,语音对齐失败不使内部无字幕母版失效,但会阻断唯一交付物字幕版,修复前不得改交无字幕母版。需要人工判断的画面与表演问题直接查看成片,不要求额外填写固定 Markdown 报告。

## 状态、失效与一致性

- `制作状态.json` 独占规划与生产阶段状态。`phases.planning` 与 `phases.script` 分别表示项目规划和项目级故事包硬门;`episodes.ep_N.stage_status.script` 表示该集详细剧本。资产及后续项目状态是逐集聚合视图。
- `current_stage: script` 且 `current_episode` 为空时表示项目级故事包;`current_stage: script` 且 `current_episode=ep_N` 时表示该集详细剧本。当前集更早阶段必须为 `confirmed|merged`,更晚阶段只能为 `pending|invalidated`;更早集必须至少完成到 `objective.target_stage`,更晚集的详细剧本及后续阶段必须保持 `pending|invalidated`。当前集达到目标后,下一集总是从 `script` 开始。
- `episode_manifest_ep_N.json` 只保存身份、时长和文件指针,不再保存顶层 `status` 或 `stage_status`。旧项目中的同名镜像字段允许保留,但校验和推进只读取 `制作状态.json`。
- 每集状态遵循本集阶段拓扑,但不同集允许处于不同阶段:项目仍在规划或项目级故事包阶段时,各分集生产阶段只能为 `pending|invalidated`;进入逐集循环后,仅 `current_episode` 可以处于活动状态,且先活动于 `script`。较早集必须达到目标阶段,较晚集不得提前生成详细剧本或进入资产阶段。
- `project_manifest.json` 是路径索引,`drama_plan.json` 是规划权威,`project_script_manifest.json` 是项目级完整剧本索引,`project_data_card.json` 是跨阶段设定与状态权威,`asset_registry.json` 是共享媒体资产权威,各自不得复制对方的完整字段。
- `剧本_全剧完整剧本.md` 是项目故事权威;逐集剧本和人物关系张力矩阵是执行细化。修改项目级剧本中的核心因果、人物弧、结局或分集边界时,所有受影响 `script_contract_ep_N.json` 及下游阶段必须失效。
- 任一 Markdown 正文修改后更新对应 `source_sha256` 和 revision,并使依赖它的下游 manifest 状态变为 `invalidated`。
- 共享资产版本变化时,只更新 `asset_registry.json` 和受影响分集的 `asset_usage_ep_N.json`,不复制媒体文件。
- 规划阶段可以先登记未来阶段 manifest 的固定路径;进入对应阶段后,该阶段 JSON 中引用的路径必须存在。`episode_id`、文件后缀 `_ep_N`、所属目录 `episodes/ep_N/` 三者必须一致。
- 完整模式多集项目的 `episode_seams.json` 必须覆盖每对相邻集;完整模式单集作品使用 `ep_1` 且 `seams` 为空。轻量模式不创建该文件。

## 不进入 JSON 的内容

- 剧情梗概、人物小传、完整剧本文字。
- 面向用户的参数确认和按内容形态选择的五列剧情节奏预览。
- 人工审美评价、修改建议和完整看片记录。
- 策略库、风格库和方法说明。
- SRT、图片、音频和视频文件本体。

这些内容由对应 Markdown 或媒体文件承载;JSON 只保存路径、哈希、状态、结构化执行字段和引用关系。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall