技能介绍

要解决什么问题

讲数学概念时，纯文字或静态图往往不够直观；MathDoIt 公网服务（https://www.mathdoit.cn）可以把题目渲染成 2D 动画视频 或 3D 交互场景。本技能是 MathDoIt 的 Client Skill v2.0，让 Agent 不必手写 HTTP 细节，而是通过 CLI 脚本 或 MCP 工具 完成登录、提交任务、轮询状态与下载成品。

技能如何工作

generate_math_video：传入 problem（必填），可选 render_type（2d / 3d）和 image_path（手写题图片）。
check_video_status：用 task_id 查询任务是否完成。
CLI 一条龙：登录 → 提交 → 轮询（建议 3 秒 间隔）→ 下载；视频通常 2～5 分钟 完成，最长约 10 分钟。
v2.0+ 的 CLI 与 MCP 已内置 User-Agent，避免 Cloudflare 返回 HTTP 403；账号可通过环境变量 MATHDOIT_USERNAME、MATHDOIT_PASSWORD、MATHDOIT_SERVER 配置。

典型 Agent 流程：先确认题目、2D/3D 偏好与是否上传图片，再调用工具或脚本，最后把桌面上的文件路径与答案反馈给用户。

适用边界与注意点

需在 www.mathdoit.cn 注册账号（资料提到需邀请码）；非订阅用户 有免费生成次数，用尽后需订阅，登录响应里会带额度信息。
技能包默认位于 ~/.qclaw/skills/mathdoit-client/，MCP 配置需使用脚本的绝对路径（如 mathdoit_mcp_server.py）。
Agent 若用 exec 直接跑 CLI，建议 600 秒 超时，并注意 Python 输出缓冲（脚本已 flush=True）；无输出时可改为执行独立 .py 文件。
更细的 HTTP 接口说明见技能内 references/api.md。

截图预览

使用场景

在备课或录课前，把「勾股定理」「函数图像」等题干交给 Agent，生成 2D 动画视频用于课堂演示。
辅导学生时上传手写题照片，指定 `3d` 渲染，得到可展示的立体几何或空间关系场景。
在 Cursor / WorkBuddy 对话里描述微积分或几何问题，由 Agent 调用 MCP 提交任务并轮询，完成后告知桌面视频路径。
QClaw Agent 通过 CLI 执行登录到下载全流程，在长时间生成（2～10 分钟）期间用 `check_video_status` 跟踪 `task_id`。

适合人员

需要在网课或面授中插入动态推导画面的 K12 / 高校数学教师，希望少自己搭动画工程。
一对一答疑时手头只有拍照题目的家教或助教，想把同一道题快速变成 2D 或 3D 讲解素材。
在 SkillHub 安装 mathdoit 后、用 WorkBuddy / QClaw / Cursor 接 MCP 的 Agent 集成者，要把「生成数学视频」做成对话能力。
已注册 MathDoIt 账号、需批量提交题干并自动下载成品的教研或内容运营，需遵守免费额度与订阅规则。