whaleyxbt/claude-motion

解决的问题

编码代理程序通常难以掌握高质量动态设计所需的「品味」与精确度。虽然它们可以学习 API，但通常缺乏确保平滑缓动（easing）、视觉与声音同步，或在最终渲染前验证画面正确性的能力。此工具包提供了设计规则、自我审查机制与声音引擎，使代理程序能够制作专业级的动态图形与模拟。

运作方式

此工具包透过一组「技能」与结构化流程与代理程序（如 Claude Code 或 Cursor）整合：

• 设计规则： 提供缓动曲线、弹簧预设与时序的具体数值指南（例如：用于进场的特定贝兹曲线），而非模糊的指令。
• 自我审查循环： 由于代理程序无法观看影片，系统会渲染一张「联络表」（包含时间戳记的影格网格）。代理程序会分析这些影格以检查碰撞、裁切与可读性，并在最终渲染前修正错误。
• 声音引擎： 基于纯 Python 的合成器透过提示表生成音效（点击声、呼啸声、上升声），确保音讯与视觉时间轴完美同步。
• 网页模拟流程： 对于复杂的模拟（如使用 three.js 的 3D 场景），它使用 headless Chromium 与 ffmpeg 逐影格渲染单一 HTML 页面，确保无论渲染速度如何，输出皆为稳定的 60 fps。
• 统一时间轴： 一个 JSON 档案将每个「节拍」对应到时间戳记，供场景、声音引擎与审查循环使用，以保持所有内容同步。

适用对象

使用 AI 编码代理程序自动化制作动态图形、宣传影片与技术模拟，且无需使用 After Effects 等手动工具的开发者与设计师。

特色亮点

• 影格精确捕捉： 使用 Playwright 与 ffmpeg 将网页模拟渲染为 60 fps 的 MP4。
• 自动化视觉质量保证： 使代理程序能够透过审查自身作品的联络表来执行质量保证。
• 程序化音讯： 一个自订的 Python 声音引擎，无需外部样本即可生成母带级音讯。
• 节拍同步时序： 一个 beats.py 工具，可分析轨道节奏以将模拟与音乐对齐。