5.1 KiB

Raw Blame History

附录 E：Codex 执行包 Schema

当强哥要求“交给 Codex 执行”“生成执行包”“落到 video-workbench”时，必须输出 JSON。不要同时再输出一套重复 Markdown。

0. 当前状态与路径优先级

本附录负责规定 Codex 执行包的基本字段结构，不负责永久锁定 video-workbench 的最终目录方案。

当前 video-workbench 仍处在试运行前阶段，尚未跑完真实端到端项目。目录、文件名和输出路径会在第一次真实试运行后继续校正。生成执行包时必须遵循以下优先级：

当前 GPT Instructions。
本附录规定的 JSON 字段结构。
20_SYSTEM_video-workbench项目说明.md 与 21_SYSTEM_Codex_JSON执行样例.md 中记录的 video-workbench 真实目录和路径规则。
案例文件中的旧路径仅作字段颗粒度参考，不作为真实落盘路径。

如果本附录或旧案例中出现 outputs/images/... 这类路径，而系统文件已经给出 projects/<project-id>/slides/sNN/... 这类新路径，应以系统文件的新路径为准。

当前默认项目路径形态是：

projects/<project-id>/
  project.md
  intake/
  slides/
    slides.md
    s01/
    s02/

1. 基础结构

{
  "project": {
    "id": "",
    "name": "",
    "type": "",
    "goal": "",
    "medium": "",
    "series_id": ""
  },
  "inputs": {
    "source_md": "",
    "reference_images": [],
    "character_refs": [],
    "style_refs": [],
    "audio_refs": [],
    "intake_files": []
  },
  "outputs": {
    "project_root": "",
    "intake": "",
    "slides": "",
    "handoff": ""
  },
  "global_style": {
    "visual_style": "",
    "character_consistency": "",
    "voice_style": "",
    "typography": ""
  },
  "tasks": [],
  "acceptance_criteria": [],
  "notes_for_codex": ""
}

说明：

project.id 用于目录名，建议使用英文、数字、短横线，例如 ai-float-ocean-redteam。
project.type 使用媒介类型，例如 science_video_ppt_style、training_ai_ppt、client_solution_ppt、science_voiceover、mv_storyboard。
inputs.intake_files 用于记录强哥放入 projects/<project-id>/intake/ 的总纲、分镜、执行包、背景资料和参考材料。
outputs.project_root 默认指向 projects/<project-id>/。
outputs.slides 默认指向 projects/<project-id>/slides/。

2. 任务类型

允许的任务类型包括：

write_project_note：更新 project.md，只写项目小抄和文件映射，不复写完整内容。
write_slides_mapping：创建或更新 slides/slides.md，记录每页 / 每镜的映射和执行进度。
generate_voiceover：根据口播稿生成音频。
text_to_image：根据文字 Prompt 生成图片。
image_to_image：基于定妆照或参考图生成新图。
create_slide_asset：生成 PPT 页面资产或页面文件。
write_markdown：写入 Markdown 文件。
write_json：写入 JSON 元数据。
export_assets：整理输出目录和资产清单。

当前默认不执行自动剪辑成片，不默认图生视频，不默认发布平台，除非强哥明确要求并且 video-workbench 的系统文件说明已经支持。

3. 单个任务格式

{
  "id": "s01_image",
  "type": "text_to_image",
  "slide_id": "s01",
  "input": "projects/<project-id>/intake/storyboard.md",
  "prompt": "",
  "output_path": "projects/<project-id>/slides/s01/image-v1.png",
  "dependencies": [],
  "acceptance_criteria": [
    "画面符合全局风格",
    "主体与分镜描述一致",
    "图片中没有可读正文文字"
  ]
}

任务字段原则：

每个 task 必须有 id、type、output_path、acceptance_criteria。
图片任务必须有 prompt，且默认包含 no readable text。
图生图任务必须有 reference_image 或在 input 中指向参考图。
音频任务必须有 input 或 script。
PPT / slide 任务必须有 slide_id，并尽量包含 slide_copy、layout、speaker_notes。
output_path 应尽量落在 projects/<project-id>/slides/sNN/ 或 projects/<project-id>/ 的明确位置。

4. 命名规范

当前命名仍会在试运行后校正，默认建议如下：

项目目录：projects/<project-id>/
用户 / GPT 输入：projects/<project-id>/intake/
分镜 / 页面映射：projects/<project-id>/slides/slides.md
第 1 页 / 第 1 镜：projects/<project-id>/slides/s01/
图片提示词：projects/<project-id>/slides/s01/image-prompt.md
口播稿：projects/<project-id>/slides/s01/voiceover.md
生成图片：projects/<project-id>/slides/s01/image-v1.png
生成音频：projects/<project-id>/slides/s01/voiceover-v1.wav

不要默认使用 active/、completed/、abandoned/、standalone/、series/ 或根部 outputs/ 作为项目目录。

5. 验收标准

Codex 执行包必须让执行者清楚知道：

用什么输入；
生成什么资产；
放到哪里；
按什么顺序执行；
每个任务的验收标准是什么；
如果失败，应该回到 Prompt、参考图、页面结构、口播稿还是文案层修改。

5.1 KiB Raw Blame History Unescape Escape