Bookflow Studio
当创作者想要演示或执行一个真实的书籍短视频项目时,请使用此技能。首先,阅读仓库中的 AGENTS.md 和 docs/workflow.md;在填写或排障剧集文件时,请参考 docs/project-format.md。
执行剧集
在创作者选择的剧集文件夹内工作。如果不存在剧集文件夹,请询问创作者想覆盖哪本书,或是否需要推荐;不要自行选择要推广的产品。对于新剧集,请使用 npm run bookflow -- init <episode-folder>,并保留任何现有文件。
引导创作者完成以下交付物,并在适用时使用CLI:
- 确认确切的标题、作者、版本和目标受众。从适当的公开来源研究事实细节;将URL以及每个来源支持的内容保存到
sources.md和claims.csv中。如果创作者已连接阅读笔记服务并授权使用,仅使用他们可访问的笔记作为主题信号;不要复制长篇段落,也不要把高亮当作公开事实。 - 在
script.md中起草原创旁白。将经过验证的事实与个人解读和体验分开。如果创作者提供了参考视频,分析其结构、节奏和大致时长;但不要复用它的台词。如果无法访问参考视频,请说明这一情况并明确告知限制。 - 展示完整的脚本,并在准备制作媒体之前等待创作者明确批准。每个口语节拍保持一个稳定的片段ID。如果创作者仅要求编写或修改脚本,则在此审核环节结束。
- 脚本批准后,构建
storyboard.csv,精确匹配每个口语片段,并指定相关的视觉元素、来源/版权、屏幕文字、动作和时长。展示故事板,并在获取或生成制作素材之前等待批准。 - 故事板批准后,仅使用当前环境中实际可用的媒体工具。记录素材来源和版权。旁白请使用创作者的录音或明确批准的声音源。如果ASR工具(如Whisper)可用,以其时间戳为起点,并对照实际语音轨道进行核查。确保中文字幕准确;可选的英文字幕应在手机上保持可读。使用
npm run bookflow -- export-srt <episode-folder>导出SRT。 - 仅当存在合适的编辑器或渲染器(例如HyperFrames或CapCut)时,才进行视频组装和预览。不要声称此仓库的CLI可以生成图像、语音或视频:它负责准备剧集文件、检查结构/对齐并导出字幕。此处提到的工具名称是可选的集成,而非捆绑的依赖;详见
docs/integrations.md。 - 运行
npm test和npm run bookflow -- check <episode-folder> --release以生成发布候选。解释自动化检查能做什么和不能做什么。创作者仍需自行审查事实准确性、版权、移动端可读性以及渲染后的视频。
对于介绍Bookflow Studio本身的视频,仅描述此仓库中存在的功能,并通过实际运行验证其有效性。将Codex引导的工作流与CLI的具体功能区分开来;切勿将计划中的或依赖工具的媒体生成描述为已由代码自动完成。
保持剧集素材和私人工作内容在公共仓库之外。不要提交凭据、原始语音、账户数据、未经授权的封面、音乐、截图或客户媒体。