手绘视频生成|白板动画·配音字幕
基于 trustfuture/simon-skills 的 whiteboard-video 改编,保留 MIT 来源。制作程序包含在本包,不依赖作者电脑上的目录。默认横屏 1920×1080,竖版封面不等于竖屏成片。
首次使用
读取 @references/windows-setup.md,安装依赖并执行 node "<本技能目录>/scripts/setup-font.cjs" 获取完整字体后,再执行 node "<本技能目录>/scripts/wb.cjs" doctor。Node.js 至少 20.12;Windows x64 已验证;macOS 已适配运行入口,仍需 Mac 真机验证。运行期间需要联网获取依赖和调用配音服务。
凭证由用户在本机 .env 中配置,模板为 .env.example;不要把真实凭证写入聊天、日志、发布包。配音请求使用用户火山账号并消耗额度,提前说明实际调用。缺配置时停在相应环节,不伪称已出片。
制作流程
- 明确观众、主题和用途;先写短口播稿,用户确认后制作。不要为了符合示例时长填充内容。事实、数字和日期先核对来源,参考 @references/common/fact-check.md。
- 用
node "<本技能目录>/scripts/wb.cjs" new "<项目名>"建工程。把旁白、场景和封面写入生成的 scenes.js。按 @references/dsl.md 和 @references/scene-patterns.md 编排;底部 y≥960 留给字幕,右上 320×130 留给水印。 - 复杂人物和物件使用用户提供或合法生成的 PNG,放在工程 assets 目录;生图方法见 @references/stickers.md。原生 Codex 生图调用需另行配置并实测,不能承诺 WorkBuddy 自带该能力。也可先用基本图形做讲解。官方 Logo 的来源与使用条件单独核验。
- 执行
stills "<项目名>",逐张检查遮挡、中文、越界与视觉密度;这些命令都使用 scripts/wb.cjs 入口,不调用旧 Bash 入口。 - 用户确认内容后,执行
build "<项目名>",按 scenes → tts → render → mix → cover 生成成片。配音可缓存,改过旁白需要重新配音。修改字幕或品牌时按相应场景重新渲染。 - 按 @references/common/delivery-qa.md 检查实际 MP4 和字幕。只有存在可解码的新文件才算完成;完整听审与抽帧检查分开说明。交付 MP4 路径、工程、封面及需要的发布文案,不代替用户自动公开发布。
命令
入口均为 node "<本技能目录>/scripts/wb.cjs",后接:
- doctor / list:检查依赖配置状态、列工程。
- demo:复制内置短示例到 episodes/demo,无接口调用。
- new "标题":创建新工程,不覆盖同名工程。
- scenes / stills / tts / render / mix / cover "项目名":分步处理。
- build "项目名":完整制作,配音需要用户服务凭证。
- image "项目名" name="英文描述":仅在 Codex CLI 生图已经配置并验证后使用;此项非默认必需。
- logo "项目名" name="Commons 文件名.svg":获取标识,核对来源与授权条件。
默认工程在 episodes,成片在 build/<项目名>/outputs/final.mp4。目录可在 config.json 修改,品牌和语速也在该文件调整。语音服务、音色和额度由用户自行开通,不包含在技能许可内。
来源与改动见 @references/provenance.md;使用第三方字体或素材仍须遵循其许可。