# 20_SYSTEM_video-workbench项目说明

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

## 1. 项目定位

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

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

## 2. 三方协作分工

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

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

## 3. 当前真实目录结构

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

```text
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 执行时：

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

## 8. 与 CCPE / skills-vault 的关系

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

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

```text
requirements/ccpe/
```

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

```text
requirements/skills-vault/
```