现在让 AI 写一个功能,几分钟就交活。难的是交完之后,你得搞明白它到底搭了个什么东西。
今天 Hacker News 首页有篇文章叫《我们把开发者升成了架构师,却没告诉他们》(原文,HN 讨论)。作者举的例子挺扎心:同事让 AI 写了段记录新用户安装的代码,一连串兜底调用全塞在启动第一行,欢迎页要等 15 秒才出来。他的结论是,代码交给 AI 了,架构这件事还得人来把关。前几天 X 热门话题说的「理解债」也是这个意思:功能合进去了,没几个人真看懂(X 热门)。
想看懂一个系统,最快的办法还是画张图。可让 AI 画图,经常拿回来一张挤成一团的 Mermaid,框贴着框,箭头从字上穿过去。今天 GitHub 日榜上,专治这个的 diagram-design 又涨了 636 星(日榜)。我顺着翻了一圈,挑了五个思路不一样的开源项目。先交代一句:五个我都还没装来跑过,下面是读 README 之后的判断。
先解决「丑」:把审美写给 AI

diagram-design(69303 星,MIT)的作者有句话我很认同:模型其实已经看懂了内容,它缺的是审美,所以她把审美写了下来。写下来的规矩很具体:只给最重要的一两样东西上强调色,线条一像素,不加阴影,所有坐标对齐 4 像素网格。
你用大白话说要什么图,它自己挑类型,README 里列了 51 种,架构图、时序图、泳道图、四象限都有。交回来的是一个 HTML 文件,双击就能打开,也能导出 PNG 和 SVG。还能让它去读你的网站,把配色和字体扒下来,之后的图都跟你的品牌一个调调。
装起来就一行:
npx skills add cathrynlavery/diagram-design
作者自己把短板写得很直白:出图质量看你用的模型,同一句话画两次,布局可能不一样;结果不是可编辑的源文件,没法在 PR 里比对改动,也没法拖动方框。所以文档要放在 Git 里、每个迭代都改的,她建议还是用 Mermaid,这个更适合要拿出去发表的那张图。
它 4 月就建了,算是这几个里的老大哥,到今天还挂在日榜上。
架构图要像样:Logo 用官方的

如果你要画的是技术栈,stack-diagram(2685 星,MIT)更省事。一句话描述你的栈,比如「Next.js 和 Hono 跑在 Vercel,数据库用 Neon,登录用 Clerk,支付用 Stripe」,它就出一张带官方 Logo 的架构图。
Logo 这事它挺较真。AWS、Google Cloud、Azure 都用各家官方图标包里的,README 原话是从不改色、从不重画。线会绕开文字走,AI 画完还会自己渲染检查一遍再交给你。浅色深色两套都出,交付默认是一个把字体和 Logo 都内嵌进去的 HTML,断网也能打开。
这是 11 月 1 日才建的新仓库,20 天涨到两千多星,11 月 12 日到 18 日连发了三个版本。要准备的东西 README 也写了:Python 3.9 以上,取 Logo 得联网,导 PNG 要装 Playwright 和 Chromium。画完它会问你要不要发到公开画廊,你得点头两次才会发,你的提示词不会上传。
边讲边画:让 AI 只管内容,排版交给引擎

Sketchy(492 星,MIT)换了个思路。AI 只决定画什么、标什么,摆在哪由 Sketchy 来定,它有一套带锚点的零件库和自动布局,AI 基本不用算坐标。这样画出来的东西才稳,不会今天整齐明天歪。
它画出来的是手绘风、能点能动的图。问「打开一个网页时发生了什么」,它画出整条链路,再一步步用红笔圈出当前那一步。问「讲讲我的仓库」,它读代码画出模块和数据流,点一下方框就跳到对应文件。最戳我的是它能读 Arduino 和 ESP32 的程序,把板子、传感器摆好、按引脚连上线。对我这种代码和电路板都想折腾一下的人,这个太对胃口了。
它在 Claude 网页版和手机 App 里可以当技能用,不用装东西;在 Claude Code、Cursor、VS Code 里装扩展,能多出照片标注、导出 SVG、PNG 和 Excalidraw 文件这些功能。README 还贴了一份 11 月 2 日测的花费:第一轮问答因为多一次工具调用,比纯文字回答稍贵一点;连续问六个问题,整段对话反而比纯文字便宜。
项目是 10 月 9 日建的,最新版 v0.2.0 在 11 月 13 日凌晨发布。星不多,胜在思路干净。
位置你说了算:一门写图的小语言

有时候你心里早有一张图,只是懒得在 draw.io 里一个个拖框。reladraw(1203 星,Apache-2.0)就是给这种时候的:用文字写图,位置用「在谁下面」「在谁右边、跟谁对齐」这种相对关系来说。
我喜欢它的老实。你写多大的间距就是多大,线是直的就是直的,它不会偷偷挪框给你让位置。真碰到线压住框、字叠在一起,它照画,同时打一行警告告诉你在哪、差多少,你或者 AI 回去改源文件就行。自带一个给 AI 用的技能,装上之后 Claude Code 和 Codex 都能写这种文件。
9 月 8 日建的仓库,9 月底上过 HN 的 Show HN,拿了 415 分(讨论)。作者也提醒了:语法还在频繁变,今天在线试玩能画的图,过段时间可能要小改一下。
想自己再改两笔:交给 Excalidraw

前面几个出的大多是成品,想自己拖两下就费劲了。Excalidraw 官方的 CLI(370 星,MIT)补的就是这块。它能把 Mermaid 的流程图、时序图、类图、ER 图、甘特图转成 Excalidraw 里可以直接编辑的形状。所以 AI 照样写 Mermaid,你拿到的是一张能接着拖、接着改的手绘图。
渲染和 Mermaid 转换都在本地跑,不用账号,也不上传东西,需要 Node.js 22 以上。它也给 AI 留了门:输出能是 JSON,自带一组 MCP 绘图工具,不过 MCP 这部分要走 Excalidraw+ 的登录。这个仓库 10 月 8 日才建,星还少,但毕竟是官方出品,我会先收藏。
怎么挑
要拿去发表、讲究好看,先试 diagram-design。画技术栈,stack-diagram 最省心。想让 AI 边讲边画、帮你看懂一个陌生仓库或一块电路板,看 Sketchy。脑子里早有布局,就用 reladraw 写出来。最后想自己动手调,丢进 Excalidraw。
AI 写代码越来越快,看懂它写了什么这件事越来越落到人身上。先让它画张图,至少知道自己升成了一个什么样的架构师。






























