6.0 KiB

Raw Blame History

20_SYSTEM_video-workbench项目说明

本文件用于让 GPT「强哥的策划导演」理解 video-workbench 的真实执行环境、目录结构和能力边界。它不是风格文件，也不是案例文件；当强哥要求“交给 Codex 执行”“生成执行包”“落到 video-workbench”“生成图片 / 音频 / PPT 资产”时，必须优先参考本文件和 21_SYSTEM_Codex_JSON执行样例.md。

1. 项目定位

video-workbench 是 Wantsong 的本地降维输出执行工作台。

它负责承接 GPT 端已经规划好的内容材料，并在本地整理项目资料、生成或保存执行资产、维护轻量项目小抄、保留必要交接。它不是内容创作源头，不是完整视频剪辑系统，也不是平台发布系统。

2. 三方协作分工

GPT / 强哥的策划导演 = 规划、总纲、分镜、页面设计、执行包
强哥                 = 决策、确认、放入材料、补充参考
Codex / video-workbench = 项目小抄、文件映射、资产生成、落盘、交接

GPT 负责把内容设计到可执行颗粒度。Codex 负责按文件和任务执行。强哥负责决定哪些 GPT 输出进入项目。

3. 当前真实目录结构

当前 video-workbench 的项目主入口是：

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

handoff/
tmp/
garden-gpt-image-2/
requirements/
ccpe-consumption/

说明：

projects/ 是唯一项目入口。
不使用 active/、completed/、abandoned/ 这类状态目录。
不用目录区分 series 和 standalone。项目是否属于系列，写在项目文件里；真实需要系列管理时，可在未来建立 projects/_series/。
handoff/ 位于仓库根部，用于跨项目、跨系列或上下文窗口不足时的交接。
tmp/ 是本地临时目录。
garden-gpt-image-2/ 是本地图像生成提示词 / 工作流痕迹目录，是否长期使用会在试运行后再定。
ccpe-consumption/ 是未来 CCPE 接口和消费记录相关目录，后续会重构。

4. 项目内部文件职责

`projects/<project-id>/intake/`

强哥放入的资料区。包括：

GPT 生成的总纲；
分镜清单；
分镜详细设计；
Codex 执行包；
背景资料；
参考图、音频参考、人物定妆照说明；
其他强哥确认采用的输入文件。

GPT 不需要假设 intake 内的固定文件名。首次真实试运行后会沉淀命名习惯。

`projects/<project-id>/project.md`

Codex 维护的小抄和项目管理资料。它只记录：

项目状态；
媒介类型；
来源和参考；
intake 中哪些文件对应总纲、分镜清单、执行包、背景资料；
当前执行到哪一页 / 哪一镜；
下一步动作。

不要把完整总纲、完整分镜、完整执行包复写进 project.md。

`projects/<project-id>/slides/`

Codex 的页面 / 分镜执行区。这里的 slides 同时兼容：

PPT 页面；
科普视频分镜；
MV 镜头；
其他一页 / 一镜为单位的执行任务。

slides/slides.md 是 mapping 和执行进度表，类似 writing-workbench 中的 drafting/drafting.md。

slides/s01/、slides/s02/ 等目录保存单页 / 单镜的所有执行产物，包括图片 Prompt、口播、生成图片、生成音频、本页元数据和局部说明。不要把同一页 / 同一镜的资料分散到多个按产物分类的目录里。

5. 支持媒介类型

GPT 可以把以下媒介交给 video-workbench 执行：

science_video_ppt_style：科普 / 降维视频，当前理解为 PPT 式画面播放 + 口播 + 分镜图片。
client_solution_ppt：客户方案 PPT，目标是决策推进。
training_ai_ppt：培训 / 科普 AI PPT，目标是教学、讲座、方法论传授、案例练习。
science_voiceover：科普口播，主要生成口播音频或音频相关资产。
science_article：科普文章通常不需要 Codex 执行，除非生成封面图、配图或落盘资产。
mv_storyboard：MV / 歌曲视觉分镜，可能需要人物定妆、图生图、镜头图。

6. 当前能力状态

当前状态仍是试运行前。很多路径和文件名尚未通过真实项目验证，后续可能调整。

已确认的工作边界：

implemented：本地项目结构、projects/、根部 handoff/、轻量项目记录规则。
available_via_codex_skill：文生图、图生图提示词整理、语音生成等可以由 Codex 在实际会话中按可用 Skill / 工具执行。
planned_or_to_be_tested：完整 PPT 文件生成、统一 schema 校验、批量执行器、稳定命名模板。
not_default：自动剪辑完整视频、图生视频、平台自动发布。

GPT 生成执行包时，不要把 available_via_codex_skill 写成 video-workbench 已经拥有固定自动流水线。Codex 执行时会按当前环境确认可用工具。

7. GPT 生成执行包时的行为约束

当强哥要求交给 Codex 执行时：

输出 JSON，不要同时输出重复 Markdown。
路径默认落到 projects/<project-id>/...。
GPT 规划文件、参考材料、总纲、分镜、执行包等输入，写入或引用 projects/<project-id>/intake/。
单页 / 单镜资产默认落到 projects/<project-id>/slides/sNN/。
不要要求图片模型生成大量可读中文；页面文字由 PPT / 页面层渲染。
图片 Prompt 默认包含 no readable text。
不要生成 full_video_generation、publish_to_platform 这类当前不默认支持的任务。
如果路径、命名或能力不确定，在 notes_for_codex 中说明“需要 Codex 在试运行中确认”，不要编造确定能力。

8. 与 CCPE / skills-vault 的关系

video-workbench 不保存 canonical prompts、agent specs、model cards、runtime specs 或可复用自动化源码。

缺少本地工作 Agent、Runtime、Model Card、接口协议等，写入：

requirements/ccpe/

缺少可复用脚本、批处理器、导出器、自动化 Skill 等，写入：

requirements/skills-vault/

6.0 KiB Raw Blame History Unescape Escape