Book Video Factory

Book Video Factory 是面向图书视频创作者的可审计生产工作台与 Codex Skill 集合。它把素材入口、图书取证、口播文案、分镜、配音、渲染、合规检查和交付记录组织成可回溯的工作流。

当前仓库版本：3.8.2。

项目结构

• platform/：Book Video Studio 工作台源码、接口、数据库访问、渲染流程、部署文档和集成示例。
• skills/produce-wechat-book-video/：微信视频号图书视频生产 Skill，覆盖来源取证、二创文案、标题、分镜、配音、成片、封面和交付校验。
• skills/produce-script-video/：用户明确提供最终口播稿时的直接生产 Skill。
• skills/produce-wechat-book-video-matrix/：多账号、多变体的配置和校验 Skill。

核心模块

1. 入口与证据：接收用户文案或受支持的视频链接，保留来源、转写和版本证据。
2. 图书与文案：核对书名、作者和版本，区分参考内容、书籍划线和原创表达。
3. 视觉与音频：按语义生成分镜，使用锁定的配音与渲染规则，输出竖屏成片和独立封面。
4. 质量与交付：执行文本、媒体、发布前检查，保留标题候选、时间轴、校验报告和交付记录。

工作流边界

正常流程有两个人工阻塞点：确认二创文案，以及确认全部分镜图片。正式发布、账号操作、归档和其他不可逆动作仍需逐任务明确授权。工作流不会把书名、主题、链接预览或单独的短标题当作最终口播稿，也不会把未核验的参考句子标成书中原句。

外部服务（例如图书平台、视频平台、图像或语言模型、云端 ASR/TTS、飞书和发布适配器）只通过配置调用；它们的可用性、条款、费用和数据处理责任不由本仓库保证。

安全边界

• 不要提交 API key、Cookie、账号绑定、私有数据库、模型权重、日志或生成视频。使用 .env.example 和 platform/integrations/feishu-book-pipeline.example.json 创建本地配置。
• 运行时密钥应从环境变量或本地密钥文件读取，不写入源码、Issue、日志或产物。
• 任何 shell、路径、网络请求和发布操作都必须在用户授权的目录、账号和任务范围内执行；默认拒绝隐式发布和不明来源下载。
• 发现漏洞请阅读 SECURITY.md，不要在公开 Issue 中粘贴敏感数据。

快速开始（开发检查）

本项目不是“一键安装”软件。请先阅读 platform/AGENTS.md、platform/book-video-studio/README_V1.md 及相关 Skill 文档，准备 Node.js、Python、FFmpeg 和你自行取得许可的外部服务。

cd platform/book-video-studio
复制 .env.example 为本地 .env，并只在本地填写必要配置
npm install
npm run build

根据实际工作流再配置 ASR、图像、TTS、Feishu 或发布适配器；未配置的可选能力不应被假定为可用。不要把 .env、node_modules/、模型或 work/ 目录提交到仓库。

许可证与媒体资产

原创源码、Skill 文本和文档的许可范围见 LICENSE。仓库中的媒体资产和参考内容不自动包含在 MIT 许可中，尤其是 skills/produce-wechat-book-video/assets/** 下的 WAV、PNG、用户提示词/语音文本及其他参考资产；使用、再分发或商用前必须取得对应权利。第三方依赖、模型、外部服务、平台内容、用户生成内容和商标均受各自条款约束，详见 NOTICE.md。

参与贡献

请先阅读 CONTRIBUTING.md。小范围、可验证的修复最容易审查；提交前请运行与改动相关的最小检查，并确认没有密钥、绝对路径或未经授权的媒体。

版本记录

版本变更见 CHANGELOG.md。