Minicharts 深度评测:12 个文件 3,456 行做出 54 种手绘图表,自带检查器的两种结论

让 AI 画一张图表,你大概见过那个结局:出来的是标准模板味儿的柱状图和饼图,配色像幻灯片,横平竖直,看三秒就忘。

Minicharts(一个教 AI 画手绘图表的技能包)走的是反方向——你给它一组数字,它把图表画成你话题里的实物,手绘、按真实比例、每一块都能点。

更反常的是它的体积:整个项目 12 个文件、3,456 行,就能画出 54 种图表,而且复制到任何装了 python3 的机器上就能跑,一个第三方依赖都没有。

我把它整个下载下来重跑了一遍,也复现了它自带检查器的一个奇怪行为:同一份文件、同一个脚本,跑出两个完全相反的结论。

一、它是什么:不是画图工具,是一份「画图手艺」的说明书

先说清楚形态。Minicharts 不是一个网站、也不是一个软件,它是一个技能(skill,也就是写给 AI 看的一整套工作说明书加工具箱)。

装进 Claude Code 或 claude.ai 之后,你用大白话提要求——「把我们咖啡馆上个月的钱花哪了画成饼图,房租 1200、咖啡豆 640、牛奶 310、人工 2100」——它就产出一个 HTML 网页,打开就能点。

官网给了三种拿法,三个包的体积我实测如下:

包 大小 内容
minicharts.zip 174,840 字节 12 个文件
minicharts.skill 174,840 字节 与 zip 字节完全相同(md5 一致)
minicharts.tar.gz 171,546 字节 同样 12 个文件,解包后内容与 zip 逐文件相同

作者是 April Zhu,许可证是 MIT(可以随便用,包括客户项目),免费。她没有把它放在 GitHub 上——这一点后面会讲代价。

二、12 个文件怎么画出 54 种图表

这是全篇最值得看的部分。3,456 行里,2,146 行是一个叫 assets/examples.js 的文件,占 62%。它不是代码库,是54 张范画:每一张对应一种图表,一个不落。

我把两边的清单各导出来做了一次对比:

核对项 结果
文档里列出的图表类型 id 54 个
范画文件里实际画的卡 54 个
两者逐条对比 完全一一对应,缺失 0、多余 0

在同类项目里这一点挺罕见——我们之前评过的一个项目,文档里说的数量和目录里实际的数量就对不上。这里的 54 是实的。

而它的核心设计决策,就藏在「范画即规格」这四个字里。技能文档原文写得很直白:那 54 张范画是「质量标准,也是最好的说明书」。

AI 的工作流不是照着一份抽象规格从零画,而是:先构建出范例看一遍,去代码里找到那张卡的实现,复制过来,改数据、改文案、改画的对象。相当于老师傅先给你一张成品,让你照着临摹再改。

第二个决策更克制。所有颜色在构建时都会被一道函数统一「洗」一遍:色相往六个固定色点吸附、饱和度封顶、亮度分两段提亮。

你写什么颜色都行,出图一定落进同一套调色板。它不靠文档约定、也不靠检查提醒,直接用构建那一步从物理上保证了画面统一。

第三个是确定性。引擎里用了一个固定种子的伪随机数生成器来抖笔触,所以同一份输入永远画出同一根线。我连续构建两次,输出文件的校验值完全相同(acd9fb903e88ddd332abaf964b651905),换个目录重建也一样。

代价也有:因为范画是整份拼进页面的,哪怕你只要一张图,产出的网页也是约 390 KB——只取一张饼图的构建产物 397,654 字节,和 54 张全画出来的 397,648 字节几乎一样大。

三、实测:它自带的检查器,同一页给出两个结论

这个技能带了一个自动检查脚本(下面叫它检查器或闸门),用法很简单:构建完网页,跑一遍,它用无头浏览器把页面真的画出来,然后检查每张卡有没有可点部件、说明文字有没有超长、有没有字画到纸外面。

作者在注释里承诺「它读的是画出来的页面,不是源码,所以不会误报」。

我拿全 54 张卡的那一页跑,连跑两次,输出逐字相同:

card volcano: 7 touchable parts, writing past the sheet edge: room-temperature eggs
card funnel: 7 touchable parts, writing past the sheet edge: took some home
card ridge: 9 touchable parts, writing past the sheet edge: September
card slope: 10 touchable parts, writing past the sheet edge: Long way 260, Blue bowl 190
fix the above, then check again

4 张卡被判定「字写到纸外」,退出码 1,也就是没通过。

然后我把字体域名屏蔽掉(这个技能的网页是从 Google Fonts 在线拉字体的,不打包),同一份文件、同一个脚本,再跑两次:

nothing found

退出码 0,也就是干净通过。

同一份文件,两种结论。我做了探针定位原因:字体装上了的时候,手写字体真的生效,同一串文字「room-temperature eggs」量出来宽度是 174.9 像素。

字体加载不到时,页面回落到系统无衬线字体,同一串变成 129.9 像素——差了 26%。

而检查器判断「有没有出界」用的正是文字的实际包围盒。字体一换,测量就变,结论就翻。

这里要说明一点:我实测字体文件本身下载是正常的(Google Fonts 的样式表和字体文件都是 200,字体文件 16,400 字节),所以问题不是「字体挂了」,而是字体在不在包里。

作者自己在声明文件里写得很清楚:字体运行时从 Google Fonts 加载,不打包。而技能文档开头写的是「输出:一个自包含的 HTML 页面」。

这条链条值得记住:自称自包含 → 字体其实外链 → 离线打开时版面会变 → 版面测量不稳定 → 自检结论随网络环境翻转。这不是「检查器是假的」,而是版面测量这件事本身依赖字体,而字体不在它手里。

四、闸门查结构,查不了正确性

第二个实验更关键。我自己写了一个反例文件,四张卡,故意各犯一个错:

反例 故意做的错 检查器报了吗
A 说明文字写到 183 个字符(上限 150) 报了
B 三根柱子,没有一处可点 报了
C 50/50 的两半,画成 90° 对 270° 没报
D 一行字直接冲出画布右边 报了

C 就是问题所在。它只输出「这张卡有 2 个可点部件」,然后通过。而「按真实比例」恰恰是这个技能反复强调的第一条规则——文档原文说「数字说了算:每一片的角度、每根柱子的高度、每个点的数量都按数据真实比例绘制」。

所以这个闸门的能力边界很清楚:它检查结构(有没有可点、说明有没有超长、字有没有出画布),不检查每个数是不是真按比例。

比例对不对,目前只能靠人眼看截图复核,文档里也是这么要求的——「数一遍小圆面包,量一个角度,比较两根柱子的高度」。

还有两件顺手记下的事。这个项目的零依赖是真的:两个 Python 脚本只 import 标准库(argparse、colorsys、json、pathlib、re 这类),没有任何依赖清单文件,网页脚本也不用打包器,是直接拼接的。

另外,我把下载和构建关进隔离沙箱跑,沙箱里构建正常,但检查器起不来——沙箱的只读根里没有浏览器需要的一个启动目录,浏览器根本没启动,报表报「一张卡都没画出来」。

所以检查器这一步我是在沙箱外单独一个一次性目录里跑的,两种环境下构建出的产物校验值相同,可以确认没有走样。

五、适合谁、不适合谁

拿它和站内评过的同类对照:handraw-style 是 366 种画风的手绘风格库,管的是「像不像手画的」;Minicharts 管的是「图表能不能画成你话题里的实物,并且比例是对的」。StyleSeed 是设计方法引擎,把设计流程拆成可执行步骤;

Minicharts 是同一思路的极端简化版——它连流程都不抽象,直接把 54 张成品摆在 AI 面前让它临摹。而它被 AI 调起来的方式,和我们在 agent-autoloop 里写的调度中台是一回事:技能文档就是给 AI 的作业指导书,写得好不好,直接决定产出质量。

适合:要用一张图讲清一组数字、又不想要模板味的人;给客户做提案、需要「手作感」的独立开发者和小团队;

以及想研究「怎么给 AI 写作业指导书」的人——这份 219 行的技能文档,把「不许把没来源的事实当数据讲」「不许画人,要画人手里拿的东西」这类规矩写得像老师傅口传,很值得读。

不适合:要精确可复现的图表流水线(比例得自己看);要求完全离线可用(字体外链);需要版本管理和问题追踪的团队。

六、判断

风险面得说清楚。这是单人维护、没有 GitHub 仓库的项目,意味着没有 issue、没有 PR、没有星数生态,出问题只能走官网或作者本人的 X 账号。没有版本号、没有更新日志、没有持续集成的配置、没有测试目录。

唯一的自动检查就是那个有明确盲区的脚本。字体运行时外链,离线或被墙的环境下版面会变。至于「画得好不好」,没有任何客观测试,全靠那 54 张范画的水准和 AI 的临摹能力,出图是概率性的。

但也得说句公道话:署名是干净的。声明文件里写明了借用的两个公开算法(曲线平滑和伪随机数)和一套爆炸图约定,我在引擎代码里逐条核到了位置;MIT 许可证 24 行,写明商用可以。

文件时间戳集中在 2026 年 11 月 6 到 7 号,距今约十天,比多数项目都「活」。作者在官网上的原话是:Minicharts 保持免费。

我的判断:值得试一试,但把它当手艺模板而不是生产工具。你要的是一张让人多看一眼的图,它做得比大多数工具好;

你要的是一张数字绝对没错、离线也能开的图,它现在的自检兜不住这个底。整包 12 个文件、174 KB,装进 ~/.claude/skills/ 就完事,试错成本几乎为零。

关注 AI商业快讯,每天一篇 AI 热点深度解读。

相关阅读:

发表评论