用途：回答“这是怎么工作的/结构如何/这次改动是什么”这类问题，用一张从代码或事实画出的图，加上沿着图逐步讲解的文字，而不是用图代替答案。
主要能力：按问题选择图形类型——仓库/目录结构用 modules 模块图；请求或事件流用带序列的 modules 或 sequence；算法与数据结构用 sort、array、tree、heap、stack、queue、list、matrix、graph；状态变化用 state-machine；服务通信与故障用 distributed 或 sequence；决策分支用 flowchart；PR 改动用 pr 或 diff；排期用 gantt；已有 mermaid 可 import。
使用方式：先用 vlmkit-anim facts <dir> --depth 1 --out f.expect.json 获取导入图，或 vlmkit-anim repo --out <dir> 处理整个工作区；写 <name>.scene.json 后依次执行 vlmkit-anim check、layout、still（结构图输出 SVG）或 video（流程输出 GIF），再用 vlmkit-anim explain 得到讲解骨架。最多五轮编辑与检查；若仍不通过，则改用文字说明并保留场景文件。
适用场景：需要展示四个以上模块、状态、参与者、步骤，或存在时间顺序、前后对比的说明；单行答案、单个函数体或数值问题不建议画图。
限制：图必须来自源码或可验证事实，不能凭记忆绘制；无法验证的内容只能写进文字并标注“not drawn”。不要描述图形几何位置，应使用图中 id。交付时聊天给文字加文件，PR 用生成的 md，文档用 vlm-anim 代码围栏或提交 SVG。