AI画的架构图,为什么总像PPT草稿?我实测了GitHub热榜项目Archify

    

你有没有让 AI 画过系统架构图？

第一版通常很惊艳：彩色方框、漂亮箭头、层次分明。可一旦你追问“把 Redis 加进去”“标出登录失败分支”“这条边到底代表什么”，画面很快就会变成一张看起来专业、实际上没人敢拿去评审的 PPT 草稿。

今天 GitHub Trending 上有一个项目，专门在解决这个问题：Archify。它的思路不是让 AI 继续“画得更花”，而是让 AI 先生成有类型的结构，再用规则验证，最后编译成一个可以交互、可以导出的 HTML/SVG 文件。

01｜它为什么突然出现在热榜？

我在 2026 年 8 月 27 日查看 GitHub Trending 今日榜时，Archify 排在前列，页面显示当天新增约 1,035 个 Star。官方仓库 API 同时显示约 2.16 万 Star 和 1,405 个 Fork。热度会随页面刷新变化，所以这里记录的是我查到的当天快照。

它的定位很明确：面向 Cursor、Claude Code、Codex CLI 和 OpenCode 等编码代理，把代码库或系统描述转换成架构图、工作流图、时序图、数据流图和生命周期图。

与普通 Mermaid 图或白板工具不同，Archify 的核心产物不是一串“看起来像图”的文本，而是 typed JSON IR。简单说，就是先把节点、关系、边界和语义写成结构化数据，再由渲染器稳定地生成 HTML/SVG。

02｜我在本机实际跑了一遍

为了不把“项目宣传图”当成实测，我下载了仓库自带的 archify.zip，解压后直接运行它的 Node.js CLI。环境检查命令是：

结果是 Node.js 版本、核心模板、示例渲染器、实时预览、视觉检查、路径安全、场景指南，以及 5 种图的渲染器和校验器全部通过。项目给出的结论是：Archify is ready。

   

终端截图来自本机实际运行；截图中的 guide 返回值也来自本次操作。

然后我让它判断一个登录链路应该用什么图：

它返回了 type=architecture、proof=web-app 和 confidence=low。这里的 low 反而是一个好信号：项目没有假装自己已经理解了所有上下文，而是提醒你把边界、组件数量和主路径说得更具体。

一个更好的提示词应该像这样：“分析这个仓库，画 8 到 12 个核心运行组件，突出一条主请求链，标出外部依赖和信任边界，把辅助信息放进卡片，不要用额外箭头堆细节。”

03｜它生成的图，和普通架构图有什么区别？

官方示例是一张典型的 Web App 架构图：用户请求经过 CDN、负载均衡、API Server，最终访问 PostgreSQL；旁边还有 OAuth、S3 和安全边界。重点不在颜色，而在于每个节点和关系都来自结构化源数据，图可以被搜索、聚焦、追踪和导出。

   

官方仓库提交的 Web App 架构渲染示例，不是本文临时画的示意图。

它还提供一套比较少见的“交付前检查”：先校验 JSON 结构，再校验布局、HTML/SVG、路线和标签间距；只有通过检查的候选产物，才会替换掉上一次可用的结果。对于要放进 PR、设计评审或 README 的图，这比“模型说画好了”更有价值。

04｜怎么开始用？

如果你使用的是支持 Agent Skills 的环境，官方给出的安装命令是：

安装后不要一上来就说“把整个系统画出来”。先限定范围，比如：

这个写法有三个好处：读者知道图的边界，代理知道要保留哪条主路径，后续迭代也更容易判断到底改了什么。项目同时支持 dark/light 主题，并能导出 PNG、SVG、WebM 和 1200×630 分享卡。

需要注意的是，我这次在受限 Windows 沙箱中运行 validate 时，卡在路径解析权限错误；doctor 和 guide 均已实际通过。正常本地环境可按官方 README 继续使用 validate 和 deliver；这条限制我保留在文章里，避免把“全部跑通”写得过头。

05｜争议点：可验证的图，就是真实架构吗？

不是。Archify 的校验对象是“你提供的结构化事实”和“它能检查到的布局与关系”，不是线上 Kubernetes、云控制台或生产流量。即使一张图通过了所有规则，也可能只是把错误的输入，稳定地渲染成了一张漂亮的错误架构图。

这也是我认为它最值得讲清楚的地方：AI 画图真正缺的不是审美，而是证据链。Archify 提供了 source evidence、版本固定、路线追踪和变更对比等机制，但这些能力仍然建立在“输入是否真实、范围是否完整”的前提上。

所以更靠谱的用法是：让它先帮你整理和质检，再由熟悉系统的人确认边界。把它当成架构评审的放大镜，而不是架构事实的公证处。

最后：它适合谁？

如果你经常需要解释代码库、做设计评审、写技术方案、维护 README，或者正在使用 AI 编程代理，Archify 值得试一遍。它不承诺替你完成架构设计，但能把“从一句话到一张可交付的图”这条链路做得更规整。

我更愿意把它看成一个很克制的方向：当大家都在让 AI 生成更多内容时，它提醒我们，真正能进入团队协作的内容，还需要可检查、可追踪、可复现。