Communitygithub.com

DominikPeters/manim-skill

用于将 Manim 场景渲染为 PNG 帧并进行查看的智能体技能。

manim-skill 是什么?

该技能使 AI 智能体(如 Claude Code、Cursor、Codex 等)能够直接利用 Manim(一个用于创建数学动画的 Python 库)渲染场景,并将结果保存为 PNG 帧。它特别适合需要快速可视化数学概念或动画过程的开发者和教育者。用户可以通过智能体调用 skill,自动执行 Manim 场景的渲染命令,并将输出的 PNG 文件汇总到指定目录,便于后续查看或集成到文档中。该技能支持所有主流 AI 编程工具,其工作原理是通过预定义的脚本或命令与 Manim 环境交互,无需手动编写渲染脚本。简而言之,它简化了从代码到可视化反馈的闭环,提升了数学动画的开发效率。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add DominikPeters/manim-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 帧。"

智能体会自动执行以下步骤:

  1. 检查 Manim 环境是否已安装(若未安装,会提示安装方法)。
  2. 运行 manim -s -p -q low scene.py MyScene 命令。
  3. 将输出的 PNG 文件路径汇总给用户。
  4. (可选)在支持图片显示的平台上直接展示渲染结果。

依赖

  • 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 文件。

相关技能