用途:把“某东西如何工作/如何组织”写成一张受校验的图或动画。场景(Scene)只声明 kind 与意图,不含 x/y;编译成含节点、关键帧与字幕步骤的时间线。支持十九种 kind:sort、array、stack、queue、list、tree、state-machine、heap、distributed、matrix、graph、chart、flowchart、gantt、sequence、diagram、modules、vector、compose。
主要能力:写一个 JSON 场景;check 做校验、编译、语义检查与统计;explain 输出编号叙述;layout 按步骤报告文字重叠、越界、标签穿线、容器相交;why 解释画布轴、分层与绕线原因;still/html/video 输出 SVG、网页、GIF 或视频;review 生成接触表与视觉评审材料;--expect 用事实表核对图与代码是否一致;repo 画仓库分层;pr 按提交展示变更;diff 比较两份图;import mermaid 导入 flowchart、sequenceDiagram、stateDiagram-v2。
使用方式:mizchi/explainer 内可从源码运行 node --experimental-strip-types packages/vlmkit-anim/src/cli.ts check scene.json;其他仓库用 npx -p @mizchi/vlmkit-anim vlmkit-anim check scene.json。写场景与检查不需要浏览器或 API key;.png、sheet、video、eval、review --model 需要 Playwright 等。格式以 docs/anim-ir.md 为准。
适用场景:解释算法、协议、状态机、消息交换、流程图、甘特图、模块或依赖架构图,以及生成 README 动图、文档页面、PR 变更说明。
限制:有坐标的 kind 不应手写位置,kind: vector 是回退且被计入;注释须锚定该 kind 拥有的对象;id 用 ASCII,label 可任意文字;模块依赖环只警告;--expect 不一致、check 出现 ✗ 或 layout 报问题即未完成。资料未提供收费、价格、平台与配额信息。