# book-video

**Repository Path**: gaoshd/book-video

## Basic Information

- **Project Name**: book-video
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-07-27
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Book Video

这是一个通过自然语言制作图书带货短视频的开源工作流。它把选书、文案、氛围图、旁白对齐和成片制作组织成一套可复用的流程。

Copyright (c) 2026 prototech, endless, and 未济.

## 如何使用

你不需要先学习代码或命令。打开 Codex 后，直接用自然语言描述你想做的图书视频即可。

如果是第一次使用，Codex 会先自动检查和准备本地环境。需要你确认的地方，它会直接问你。

## 制作步骤

1. 告诉 Codex 你要做哪本书，或者让它推荐五本适合做短视频的书。
2. Codex 确认书名、作者和版本，并在对话中用代码块完整展示可直接复制到剪映的配音稿，第一行包含书名，同时保存为本地脚本文件。
3. 你直接在对话中审核文案；确认后，Codex 生成氛围图和视频画面。
4. 你用剪映或其他工具导出口播 MP3，并把文件路径告诉 Codex。
5. Codex 用 ASR 生成时间参考，以 `script.csv` 为字幕真源，对齐字幕、混入 BGM，并渲染最终 MP4。
6. 如果你要求替换文案、图片或音频，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`，其他步骤从产物与校验报告自动识别。

你也可以直接用自然语言操作，例如：

- “你好。”
- “推荐五本适合做情绪共鸣类视频的书。”
- “我想制作一本关于孤独和自我成长的书。”
- “把当前文案换成我提供的版本。”
- “这版视频不满意，请保留模板，替换图片和文案。”

## 参考来源

本项目的图书视频工作流参考了[原帖](https://x.com/369Serena/status/2073398014333321498)，特此致谢。

## 版权与许可

本项目的代码、文档和可复用模板采用 [Apache-2.0](LICENSE) 发布，版权方为 prototech（组织名），endless（网名）。Apache-2.0 不代表它自动覆盖第三方工具、字体、模型、图片生成服务或媒体素材。

仓库包含四首默认 BGM，位于 `assets/bgm/`：`城南花已开.mp3`、`红色高跟鞋.mp3`、`起风了.mp3`、`如愿.mp3`，仅作为项目学习交流素材。Apache-2.0 不适用于这些音频；版权归相关权利人所有，使用或再分发前请自行确认已取得相应许可。

更详细的内部生产规则见 `AGENTS.md` 和 `docs/book-video-playbook.md`。