演示视频生成器 是做什么的?
概述
从单个提示生成1920x1080演示视频,包含配音、转场和CSS动画。通过编排Playwright(HTML到帧渲染)、FFmpeg(合成和转场)和Edge TTS(神经语音合成)MCP服务器实现。
前置条件
- Python 3.11+ 和
uv包管理器 - 已安装FFmpeg(
ffmpeg -version) - Playwright chromium浏览器(
uv run playwright install chromium) - 用于Edge TTS语音合成的互联网连接
使用说明
从市场安装framecraft插件:
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
快速开始
uv run python framecraft.py init my-demo # 搭建项目
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # 质量检查
MCP编排
当Playwright、FFmpeg和Edge TTS MCP服务器可用时,framecraft直接编排它们,以最大程度控制每个帧和音频段。
流水线回退
当MCP服务器不可用时,framecraft运行原子化的CLI流水线,在一次调用中处理所有内容。
工作流
- 故事设计 -- 选择叙事弧(问题-解决方案、英雄之旅、前后对比)
- 场景创作 -- 编写带有CSS动画的HTML场景,或使用内置模板
- 渲染 -- Playwright捕获帧,Edge TTS生成配音,FFmpeg合成
输出
- 1920x1080 MP4视频,包含配音和转场
- 用于迭代的逐场景预览
- 质量保证验证报告
错误处理
| 错误 | 原因 | 修复方法 |
|---|---|---|
ffmpeg: command not found | 未安装FFmpeg | 通过 brew install ffmpeg 或系统包管理器安装 |
playwright._impl._errors.Error | 未安装Chromium | 运行 uv run playwright install chromium |
edge_tts.exceptions.NoAudioReceived | TTS服务不可用 | 检查互联网连接;几秒后重试 |
FileNotFoundError: scenes.json | 缺少场景配置 | 首先运行 uv run python framecraft.py init my-demo |
| 空白或黑色帧 | HTML场景渲染失败 | 检查HTML语法并确保资源可访问 |
示例
{
"scenes": [
{
"title": "认识YourApp",
"subtitle": "更智能的任务管理方式",
"narration": "24个任务。一个仪表盘。零压力。",
"voice": "en-US-AndrewNeural",
"bullets": ["智能优先级", "团队同步", "一键报告"],
"duration": 0
}
],
"output": "demo.mp4",
"width": 1920, "height": 1080,
"voice": "en-US-AndrewNeural",
"transition": "crossfade"
}
duration: 0 = 从TTS时长自动检测并增加1.5秒缓冲。
资源
- 包含模板和流水线的源代码仓库:github.com/vaddisrinivas/framecraft
- Edge TTS语音列表
- Playwright文档
- FFmpeg文档