如果你还在手动拖方框画架构图,或者被 AI 甩出来的 Mermaid 图气得半死,这周 GitHub 榜首的项目值得你停一下。
8 月 29 日,一个叫 Archify 的架构图工具冲上 GitHub Trending 第一,单日涨星 4561。知乎截至发稿,我通过 GitHub 接口实时查了一遍:星标已达 38297,fork 超过 2400,最新提交就在当天。GitHub按微博开源信息账号的统计,这一周它涨了约 1.8 万星。微博
有意思的是,它不是一夜爆火。项目 4 月中旬建立,7 月在微博上被分享时只有 3900 星左右,默默积累了两个多月,这周突然引爆——典型的"圈内人悄悄在用,终于等到引爆点"的走法。微博

一句话说清它是什么
Archify 是一个 Agent Skill,装进 Claude Code、Cursor、Codex、OpenCode 这类 AI 编程助手后,你说一句"分析这个仓库,画一张运行时架构图",它吐出来的是一个自包含的 HTML 文件——双击就能在浏览器打开,支持节点搜索、调用路径追踪、深浅主题切换,还能导出 PNG、SVG、WebP 高清图。
图型支持五种:架构图、工作流图、时序图、数据流图、生命周期图。技术团队日常要画的图,基本逃不出这五类。
它为什么火:不是"更好看的 Mermaid"
很多人第一反应是:AI 画图工具不是有一堆吗,它新在哪?
区别在分工。让 AI 直接画 Mermaid 的问题,是让同一个模型同时干两件事:理解系统结构,外加审美布局。前一件事它擅长,后一件相当不稳定——所以你拿到的图永远是"节点挤成一团、连线交叉乱飞,手动调完还是丑"。
Archify 的思路是拆开:AI 只负责产出一份有类型约束的 JSON 中间表示,也就是把结构描述对;布局、配色、间距交给确定性的渲染引擎。中间还压了一整套校验关卡,每次生成新图都先产出候选版本,跑 schema 校验、布局校验、HTML/SVG 校验、路由校验、标签避让校验,五道关卡全部通过才原子性替换目标文件。知乎校验失败也不甩报错栈,而是返回一份机器可读的"修复收据",写清违反了哪条规则、怎么修,AI 照着自动改,不用瞎试。
这套设计带来一个关键属性:确定性输出。同样的描述,每次画出来的图都一样,不存在"两次生成两个样"的随机性。
更值得说的是它把架构图拉进了评审流程。给它两个版本的架构快照,它能做 Before / Delta / After 对比,新增、删除、修改、移动标得清清楚楚——架构变更从此能像代码 diff 一样被审查。知乎每个组件还能挂"源码证据",点开直接跳到对应的 Git 文件和行号。知乎

谁值得装,谁先别装
先说结论。
适合的三类人:
已经在用 AI 编程干活的人(Claude Code / Cursor / Codex):安装成本几乎为零,一条命令的事。
需要快速吃透陌生代码库的人:让 AI 直接分析仓库出图,配合路径追踪——选中两个节点按 R 键,最短路径逐节点高亮——比硬读代码效率高不少。
经常做架构评审、写技术文档、给团队讲系统的人:输出风格统一,省掉"每人画一个风格"的沟通成本。
先别装的三类人:
完全不用 AI 编程助手的:Archify 是 Skill,离开 Agent 环境跑不起来。
需要像素级微调的拖拽党:目前不支持 WYSIWYG 编辑,纯描述式生成需要适应期。
助手接的是不带视觉能力的纯文本模型:有网友实测,搭配 deepseek-v4-flash 这类模型时体验不太顺,额度消耗偏大,节点详情展示也偏小,开发者已表示正在更新版本修复这些问题。36氪

装起来用,三行命令
```
全局安装(推荐)
npx skills add tt-a1i/archify -g
Cursor 用户
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
免安装试用
npx skills use tt-a1i/archify@archify --agent codex
```
装好后直接跟你的 Agent 说:"用 archify 画一个微服务架构图,包含 API 网关、三个微服务、Redis 缓存和 PostgreSQL。"它会自动选图型、排布局、走连线,生成完告诉你文件路径。知乎
爆火背后的一层
Archify 两个月从 3900 星涨到 3.8 万星,表面是工具颜值的胜利,实际踩中了 AI 编程时代的一个隐痛:代码生成越来越快,"表达架构、评审架构"的能力没跟上。社区最近讨论很热的两件事——“AI 看不懂微服务屎山代码”“vibe coding 让代码量暴涨,架构腐化谁来管”——指向的是同一个方向:架构正在变成人和 AI 之间的接口。表达不清楚,AI 就改不对;评审跟不上,系统就在你看不见的地方腐化。
顺带一提,这个项目的作者专升本出身,求职时多次被学历卡住,最后靠这个开源作品拿到了大厂 Offer。36氪"用作品自证"的故事被广泛转发,大概也给这周的涨星添了把火。
值得继续盯的信号:主分支版本徽标已到 v2.16.0,提交在发稿当天仍然活跃;开发者承诺修复节点详情偏小、无视觉模型、额度消耗大三个问题。后续它会不会加 WYSIWYG 编辑、能不能接入仓库监控做图随代码自动更新,决定它是从"爆款"变成"基础设施"。建议先 star 观望,不用急着把它塞进团队规范。