不合格,不出厂
让 AI 画架构图,现在不新鲜了。新鲜的是画得怎么样。
常见的毛病大伙儿都见过:线从字上头压过去,框挤出了页面,箭头全扎堆在一个点上,乍一看挺热闹,细一看没法儿用。更要命的是图跟代码对不上,它画了个你项目里压根儿没有的服务,画得还挺像那么回事儿。
最近有个开源项目,只干一件事:画图。但它的规矩是,不合格不出厂。
先说是个啥
项目叫 Archify,作者在 GitHub 上叫 tt-a1i。它不是个网站,是个 agent skill,装进你的 AI 助手里用。
2026 年 4 月开张,到现在 9.1 万颗星(我看的时候是 91,081),6 千多个 fork,9 月初还上过一回 GitHub 全语言周榜第一。协议是 Apache-2.0;早先是 MIT,后来改了,改之前发的版本照旧按 MIT 算。最新版本 v3.2.0。
一句话:把一个想法、一份计划,或者一整个代码库,画成能点、能查、能追路径的技术图。
它跟别的 AI 画图有啥不一样
上回写过一个 Next AI Draw.io,路数是聊着天画 draw.io,画出来是一张能接着手动改的图。
Archify 走的是另一条道。它不让模型直接画,分了三步:
- 先写图纸。 AI 先写一份带类型的 JSON,每种图都有自己的格式规定,哪个是组件、哪个是存储、谁调谁,一样一样写清楚。
- 再按图纸出图。 Archify 照着这份 JSON 生成一个 HTML 文件。同一份图纸,出来的图每次都一样,不靠模型临场发挥。
- 出厂前过质检。 格式对不对,布局乱不乱,线有没有压着字,东西有没有挤出框,一样一样查。不过关就打回去,还附一张单子,写清楚哪条规则没过、哪个地方、该怎么改,AI 照单返工。过了关的新图才替换旧的;没过,你手里那张上回合格的图还在。
所以它出来的图,看着像设计出来的,不像生成出来的。
README 里有句话说得挺干脆:Archify 不是通用的画图编辑器,也不是 Mermaid 换了身皮肤。

能画哪些图
一共十种:
- 架构图:组件、服务、存储、信任边界
- 工作流图:CI/CD、审批、工具调用、运维手册
- 时序图:API 调用、缓存回退、鉴权、异步链路
- 数据流图:数据管道、血缘、敏感数据、谁在用
- 生命周期图:状态、重试、等待、最终结局
- ER 图:数据库的表、字段、主外键、一对多多对多
- 类图:类、接口、谁继承谁、谁依赖谁
- 树状图:目录结构、模块拆分
- 时间线:事故复盘、发版历史
- 瀑布图:一个请求的时间都花在哪儿了
后五种是 3.1 版才加上的。
有没有代码库都行。没代码,一句话描述就能起图;有代码,让它先读一遍仓库,画出来的节点会标上出处,点一下能打开对应的源文件和行号,钉死在某一个提交上。画得对不对,一查便知。
画出来能干啥
出来的是一个独立的 HTML 文件,不用装 Archify,浏览器打开就能玩(官网上有一堆能点着玩的例子):
- 点一个节点,看它往下游牵动了谁、上游靠着谁。
- 挑两头,把中间那条路径高亮出来。
- 深色浅色一键切换。
- 导出图片,还能导出分享卡片。
不满意就接着聊:“把 Redis 加进去”“把鉴权挪到左边”“把回滚那条路高亮”。图纸还在,改哪儿动哪儿,别的地方不乱。
还有个叫 Architecture Delta 的:把改之前和改之后的两份架构图纸一比,加了什么、删了什么、挪了什么,一目了然,拿来做 PR 评审正合适。
另外,问它一个问题,它还能答成一整页:结论放最前头,下面一个问题一块,表格、步骤、图都有,图还是验过的。
怎么装
npx skills add tt-a1i/archify -g
Claude Code、Codex、OpenCode 都是全套功能,Cursor 也能用。装好以后跟它说人话就行:
用 Archify 画一个网页请求:浏览器调 API,API 先查 Redis,
没命中就查 PostgreSQL,再把结果写回缓存。
顺便说一句,它会不时去查一下有没有新版本,只是提醒你,不会自己偷偷升级,也不往外传你的项目和提示词。嫌烦,设个 ARCHIFY_UPDATE_CHECK_DISABLED=1 就彻底关了。这事儿 README 里写得清清楚楚,挺讲究。
最后说两句
以前 AI 画图,是画完了等你来挑错;Archify 是自己先把错挑完了,才拿给你看。
这年头,连 AI 画的图都得过了质检才能出厂,比好些人的 PPT 讲究多了。
