Book Video
这是一个通过自然语言制作图书带货短视频的开源工作流。它把选书、文案、氛围图、旁白对齐和成片制作组织成一套可复用的流程。
Copyright (c) 2026 prototech, endless, and 未济.
如何使用
你不需要先学习代码或命令。打开 Codex 后，直接用自然语言描述你想做的图书视频即可。
如果是第一次使用，Codex 会先自动检查和准备本地环境。需要你确认的地方，它会直接问你。
制作步骤
- 告诉 Codex 你要做哪本书，或者让它推荐五本适合做短视频的书。
- Codex 确认书名、作者和版本，并在对话中用代码块完整展示可直接复制到剪映的配音稿，第一行包含书名，同时保存为本地脚本文件。
- 你直接在对话中审核文案；确认后，Codex 生成氛围图和视频画面。
- 如果当前 Agent 环境明确支持免费豆包参考音克隆，Codex 会用项目参考音生成口播；否则你用剪映导出口播 MP3，并把文件路径告诉 Codex。
- Codex 用 ASR 生成时间参考，以
script.csv为字幕真源，对齐字幕、混入 BGM，并渲染最终 MP4。 - 如果你要求替换文案、图片或音频，Codex 会生成新方案，通过检查后覆盖旧方案。
BOOK_VIDEO_DIAGNOSTIC 并保存到 tmp/last-workflow-diagnostic.json。Codex 会据此检查输入或依赖、修复后重试最小失败步骤；旧的有效成片在新候选通过前不会被替换。
每期制作还会在本地维护 episodes/<书名>/workflow-state.json。它按产物依赖记录可执行、有效、降级、待诊断和过期状态，不设置终止失败；文件缺失或损坏时可从现有产物重建。使用 npm run workflow -- status "<书名>" 查看状态，使用 npm run workflow -- next "<书名>" 查看下一步，使用 npm run workflow -- repair "<书名>" 重新核对产物；文案确认使用 approve，对话内嵌入成片后使用 deliver，其他步骤从产物与校验报告自动识别。
你也可以直接用自然语言操作，例如：
- “你好。”
- “推荐五本适合做情绪共鸣类视频的书。”
- “我想制作一本关于孤独和自我成长的书。”
- “把当前文案换成我提供的版本。”
- “这版视频不满意，请保留模板，替换图片和文案。”
参考来源
本项目的图书视频工作流参考了 Serena 的原帖，特此致谢。
文案结构研究参考了抖音博主「听页」发布的三条视频，整理稿和分析见参考文案与共鸣分析，特此致谢。原视频文件不随仓库分发。
版权与许可
本项目的代码、文档和可复用模板采用 Apache-2.0 发布，版权方为 prototech（组织名），endless（网名）。随仓库分发的得意黑字体遵循其上游 SIL OFL 1.1 许可，见 字体许可证。Apache-2.0 不代表它自动覆盖第三方工具、模型、图片生成服务或媒体素材。
参考文案整理自第三方口播，不属于 Apache-2.0 授权范围；公开再分发前请确认相应权利。仓库仅保留文案与分析，不包含原视频。
仓库包含四首默认 BGM，位于 assets/bgm/：城南花已开.mp3、红色高跟鞋.mp3、起风了.mp3、如愿.mp3，仅作为项目学习交流素材。Apache-2.0 不适用于这些音频；版权归相关权利人所有，使用或再分发前请自行确认已取得相应许可。
更详细的内部生产规则见 AGENTS.md 和 docs/book-video-playbook.md。