145 lines
6.0 KiB
Markdown
145 lines
6.0 KiB
Markdown
# 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/
|
||
``` |