manim-skill 是做什么的?
用于将 Manim 场景渲染为 PNG 帧并进行查看的智能体技能。
概述
DominikPeters/manim-skill 是一个专为 AI 智能体设计的技能,允许智能体直接调用 Manim 引擎渲染动画场景,并生成 PNG 格式的帧图像。它旨在帮助开发者和教育者在 AI 辅助下快速迭代数学可视化内容。
主要功能
- 场景渲染:自动执行
manim命令,将指定的 Python 场景文件渲染为 PNG 帧。 - 批量输出管理:渲染后的 PNG 文件会按场景分组存储在
media/目录下,便于批量查看。 - 错误处理:捕获渲染过程中的常见错误(如导入失败、语法错误),并返回友好的提示信息。
- 跨平台支持:技能适用于所有支持 shell 命令的 AI 智能体环境(如 Claude Code、Cursor、Codex 等)。
使用方式
要让智能体使用此技能,只需在对话中提出类似以下的需求:
"请使用
DominikPeters/manim-skill渲染scene.py中的MyScene场景,并显示生成的 PNG 帧。"
智能体会自动执行以下步骤:
- 检查 Manim 环境是否已安装(若未安装,会提示安装方法)。
- 运行
manim -s -p -q low scene.py MyScene命令。 - 将输出的 PNG 文件路径汇总给用户。
- (可选)在支持图片显示的平台上直接展示渲染结果。
依赖
- Python 3.8+
- Manim (Community Edition) 或 ManimGL
- 系统需安装 FFmpeg 和 LaTeX(部分场景需要)
配置
技能默认使用中等质量(-q low)。如需更改,可在命令中指定参数,例如:
渲染 `scene.py` 中的 `MyScene`,使用高清质量 (-q hd)。
示例
假设有一个名为 square_to_circle.py 的文件,其中包含 SquareToCircle 场景。您可以这样请求:
"请渲染
square_to_circle.py中的SquareToCircle,并显示 PNG 帧。"
智能体会执行类似以下的命令:
manim -s -p -q low square_to_circle.py SquareToCircle
之后,您会在 media/videos/square_to_circle/480p15/ 路径下找到 SquareToCircle.png 文件。
注意事项
- 渲染大型或复杂场景可能会消耗较多系统资源,建议分步执行。
- 若场景需要外部数据或图片,请确保它们已正确放置在项目目录中。
- 技能不会修改您的源代码,仅执行渲染和文件管理操作。
许可证
此技能遵循 MIT 许可证。详情请参阅仓库内 LICENSE 文件。