一天涨 4260 星：tt-a1i/archify 让你用一句话画出能跑的架构图，AI 编程助手的隐藏神器

GitHub 今日 Trending 第一名是 tt-a1i/archify——一个让 AI 编程助手（Claude Code、Cursor、Cline）能直接生成”可编辑、可验证”架构图的 Agent Skill。单日涨星 4260。它解决了一个长期被吐槽的问题：”AI 画的架构图丑到没法用”。

它到底是什么

archify 不是另一个 Mermaid 替代品，它是一个给 AI Agent 用的架构图生成 Skill。

核心理念是：你给 Claude Code 或 Cursor 一句”画一下我们后端的微服务架构图”，它会：

1. 读取项目代码，识别出服务、数据库、消息队列

2. 根据服务关系生成一张自带动效、可交互的暗色架构图

3. 输出一个自包含的 HTML 文件（不依赖 Mermaid 服务端，浏览器直接打开）

4. 同时输出 PNG / SVG / JPEG / WebP 格式用于贴文档

整个过程不需要你懂任何绘图语法，也不需要打开 draw.io 或 Figma。

一天 4260 星：为什么突然爆

8 月 27 日的 GitHub Trending 数据显示 archify 一天涨了 4260 星，累计达到 9300+。结合项目 issue 列表的时间戳，最近一周 PR 集中爆发，社区讨论密度极高。

爆的几个关键原因：

1. 解决了”AI 画的图丑”的硬伤

过去两年 AI 生成的架构图基本是 Mermaid 渲染出来的——线条、字体、配色全部”AI 风”，一眼能看出来。和人类设计师画的 draw.io 图、Figma 图差距明显。archify 走的是“暗色主题 + 精心设计的样式 + 自动布局”路线，第一次让 AI 生成的图能”直接贴 README”。

2. 兼容所有主流 AI 编程助手

archify 的 Skill 设计是agent-native——不绑定特定 AI 厂商。Claude Code、Cursor、Cline、Windsurf、Continue 都可以用同一个 Skill 文件。这对开发者来说”零迁移成本”。

3. 输出可交互的 HTML 而不是静态图

这是和 Mermaid 最大的差异。archify 输出的 HTML 自带：

– 节点 hover 显示元数据

– 拖动调整布局

– 缩放、聚焦

– 局部高亮（按服务、按数据流）

一位用户在 issue 里说：”第一次看到 AI 画的图能让我想点进去看每个节点。”

和同类项目比强在哪

GitHub 上做”AI 生成架构图”的项目不少，archify 突出的地方是：

| 维度 | archify | Mermaid | draw.io + AI 插件 |

|—|—|—|—|

| AI 友好度 | 高（Agent Skill） | 中（语法严格） | 低（手动操作） |

| 输出可编辑性 | 高（HTML/PNG/SVG） | 中（mermaid 源） | 高（XML） |

| 学习成本 | 零（说人话即可） | 中（要学语法） | 高（要学 UI） |

| 主题美观度 | 高（暗色系） | 低（默认简陋） | 中（依赖模板） |

| 实时协作 | 否 | 否 | 是 |

最大的优势还是 “AI 友好度”——Mermaid 和 draw.io 都是为人设计的，AI 用起来要写严格的语法。archify 的 Skill 协议是给 AI 看的，AI 可以直接”读”项目代码自己画。

适合谁用 / 不适合谁用

适合：

– 后端工程师，每周要给团队讲一次架构

– 开源项目维护者，README 里需要画架构图

– 技术博主，写文章时需要配图

– AI 编程助手的重度用户，嫌 Mermaid 不够好看

不适合：

– UI 设计师需要精细排版（archify 自动化优先，定制空间小）

– 嵌入式/硬件系统架构（archify 主攻软件架构）

– 公司内部”流程图 + 审批图”（archify 不擅长）

上手成本 / 限制

上手成本：低。如果你已经在用 Claude Code 或 Cursor，安装只需要一行命令（archify 提供了 marketplace 方式）。安装后说”画一下当前项目的架构图”就行。

限制：

– 大型单体项目（>1000 个文件）第一次扫描会比较慢

– 复杂的微服务调用链路（动态发现的服务）识别准确率约 70%

– 目前只支持英文界面（中文项目名识别偶发问题）

– 输出 HTML 单文件大小约 200KB-2MB（看节点数）

第一个验证用法

跑通后，archify 提供了”五种图表”开箱即用：

1. architecture（系统架构）—— 节点 + 连线

2. workflow（业务流程）—— 横向泳道

3. sequence（时序图）—— 角色 + 消息

4. data-flow（数据流）—— 数据走向

5. lifecycle（生命周期）—— 状态机

社区最近在讨论新增第六种 erd（Entity-Relationship Diagram）—— 数据模型图。

关注它的两个信号

1. 是否被大厂内置——如果 Claude Code 或 Cursor 把它纳入官方推荐 Skill，archify 会从”小众神器”变成”AI 编程助手标配”

2. 中文支持的进展——issue #123 已经在讨论中文项目名的解析问题，这块一旦解决，国内开发者采用率会大幅上升

对开源 AI 工具生态的判断：archify 的爆火印证了一个趋势——**”AI 时代的基础设施 = AI 友好 + 人类可读”**。Mermaid 解决了人类画图的问题，archify 解决了 AI 画图的问题。下一波值得关注的是”AI 时代的 Confluence / Notion”——给 AI 看的文档系统。

— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn