示範影片產生器
概述
從單一提示詞生成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 秒緩衝。