开源工具评测:Archify 把一句话变成可交互架构图
开篇痛点
让 AI 画架构图,痛苦经历谁都有过:
- 让 Claude 写 Mermaid,出来的图丑得整整齐齐,箭头交叉得像毛线团;
- 用 draw.io,得自己一个框一个框拖,半小时画不出一个系统;
- 想让图跟代码对应起来?基本别想,AI 凭空画的图和你 repo 里的实现根本对不上;
- 画完想改?"加个缓存层"——你得重新描述一遍,它又给你生成一张完全不一样的图。
Archify 干的事就是把这些痛一次解决:你跟 Agent 说一句话,它给你生成一个可交互的单文件 HTML——能点节点、能跳源码、能高亮路径、能继续对话修改。89.5k Star,不是没原因的。

项目基础
Archify(GitHub: tt-a1i/archify)是一个 Apache-2.0 + MIT 双协议的 Agent Skill,作者 tt-a1i 单人项目。它不是独立 App,是一个装在 Claude Code / Codex / Cursor / OpenCode 里的技能包,Kimi Work 插件商店也有上架。
它的核心设计很简单:
| 层 | 谁干 | 干什么 |
|---|---|---|
| Agent | Claude / Codex 等 | 理解你的需求,写 typed JSON 图表描述或 Markdown 解答稿 |
| Archify | 内置渲染器 | 把 JSON/Markdown 渲染成自包含可交互 HTML |
| 浏览器 | 用户 | 打开 HTML,点节点、切主题、导出图片/PDF |
支持的图表类型覆盖十种:架构图、工作流、时序图、数据流、状态机、ER 图、类图、树形图、时间线、执行瀑布图。
两种工作模式:
- 画图模式:你描述一个系统,Agent 生成可交互架构图;
- Explainer 模式:你问一个问题(比如"P99 为什么飙高"),Agent 生成"结论先行"的一页式解答——先给答案,然后每个面板一个问题,步骤和图并排走,读到哪步图上高亮到哪步。

为什么推荐它
1. Source-backed:图和源码是连在一起的
这是它和所有其他画图工具最本质的区别。
你让 Agent 读你的 repo,它会真的去分析代码结构,然后画出来的图上每个节点都钉在某个具体 commit 上——点一下节点,直接打开对应源码片段。新人接手项目、面试讲自己做过什么、写技术文档,这个能力比"好看"重要一个量级。
2. 不是静态图,是可交互 HTML
Mermaid 生成的是死图,draw.io 导出的是死图。Archify 生成的 HTML 里:
- 点节点可以展开详情;
- 可以高亮某条路径("高亮缓存未命中这条链路");
- 可以切明暗主题、换四种风格;
- 可以导出 PNG / WebP / JPG 长图 / PDF / WebM 视频。
3. 可以继续对话修改
图生成完不是终点。你可以接着说:
- "加个鉴权模块"
- "高亮从浏览器到数据库这条路径"
- "切浅色主题"
- "把这个图导出成 PNG"
Agent 会在原 JSON 上改,重新渲染,而不是从头再画一张。
4. 接受 Mermaid 作为输入
你已经写好的 Mermaid 不用扔——直接喂给它,Archify 会渲染成交互版。
核心优势对比
| 维度 | Mermaid | draw.io | PlantUML | Archify |
|---|---|---|---|---|
| 产出 | 静态 SVG | 静态图 | 静态图 | 可交互 HTML |
| 能否点节点跳源码 | 否 | 否 | 否 | 是(source-backed) |
| 继续对话修改 | 重写代码 | 手拖 | 重写代码 | 直接说人话改 |
| 上手成本 | 学语法 | 手拖 | 学语法 | 说一句话 |
| 排版美观 | 丑 | 看你手活 | 一般 | 自动排版 |
| 排障一页纸 | 做不到 | 做不到 | 做不到 | Explainer 模式 |
| 导出 | SVG | PNG | PNG | PNG/WebP/PDF/WebM |
| 协议 | MIT | 免费 | GPL | MIT/Apache-2.0 |
一句话:Mermaid 是写代码画图,draw.io 是手拖图,Archify 是用对话生成可浏览的架构图——它占的生态位之前没人占住。

手把手实操
环境要求
- 装了 Claude Code / Codex CLI / Cursor / OpenCode 任意一个
- Node.js 环境(npx 可用)
第一步:安装
npx skills add tt-a1i/archify -gKimi Work 用户直接在插件商店搜"可交互架构图"。
第二步:画一张架构图
在 Agent 里直接说:
用 Archify 画一个 web 请求流程:浏览器请求 API,API 优先读 Redis,
缓存未命中时查 PostgreSQL 并回填缓存。Agent 会走三步:
- 理解:把你的描述解析成图表 spec(JSON);
- 渲染:调 Archify 渲染器生成 HTML;
- 自校验:Proof Lab 里有 11 个内置校验场景,确保图能打开、节点不重叠、链接不悬空。
第三步:继续对话修改
- 加个鉴权中间件
- 高亮缓存未命中这条路径
- 切浅色主题
- 导出成 PNG第四步:读 repo 生成 source-backed 图
读一下这个 repo,给我画一张架构图,节点能跳到对应源码。Agent 会扫描代码结构,分析模块依赖,然后画出来的图每个节点都钉在 commit 上。

第五步:Explainer 排障一页纸
用 Archify 一页回答:接口 P99 从 80ms 涨到 600ms,平均值没动,
可能原因是什么?怎么排查?它会生成一页 HTML:先给结论,然后每个面板一个问题,步骤和图并排,图上跟着高亮。
常用命令速查
| 你想干嘛 | 对 Agent 说 |
|---|---|
| 画架构图 | "用 Archify 画:……" |
| 改图 | "加个 XX 模块" / "高亮 XX 路径" |
| 切风格 | "切浅色主题" / "换第二种风格" |
| 导出 | "导出 PNG" / "导出 PDF" |
| 读 repo 画图 | "读这个 repo,画架构图" |
| 排障一页纸 | "用 Archify 一页回答:……" |
适用场景
- 新人接手项目:让它读 repo 画 source-backed 架构图,点节点看源码,比读 README 快十倍;
- 面试讲项目:生成可交互架构图共享链接,比 PPT 上贴一张死图有说服力;
- 写技术文档:博客里插的架构图不再是静态 PNG,读者能自己点着探索;
- 排障复盘:P99 飙高、缓存击穿、数据库慢查询,一页纸带图讲清楚;
- 旅行攻略 / 知识地图:社区已经有人把上海 CityWalk 做成四天可切换的行程图。
客观优劣
✅ 优势
- 真能"说人话出图",不用学 Mermaid / PlantUML 语法;
- Source-backed 是杀手级功能,图和源码对得上;
- 可交互 HTML,点节点、跳源码、切主题、高亮路径;
- Explainer 模式把排障报告产品化了;
- 不绑死平台,Claude Code / Codex / Cursor / OpenCode / Kimi Work 都能用;
- MIT/Apache-2.0 双协议,可商用;
- 有 Proof Lab 11 个内置校验场景,输出质量有保底。
⚠️ 局限
- 本质是 Agent Skill,离不开 Claude Code / Codex 这类客户端,豆包网页版跑不了;
- 渲染器在仓库里,本地生成需要 Node 环境;
- 复杂架构图的排版还是不如 draw.io 手调精细;
- 单人项目,迭代节奏看作者;
- Token 消耗不低(每次调用约 3952 tokens);
- 导 WebM 视频需要额外渲染步骤。
结尾总结
Archify 占的生态位很准:Mermaid 是给程序员写代码画图,draw.io 是给人手拖图,Archify 是给人用对话生成可浏览的架构图。它把"画图"从一门手艺变成了一次对话。
快速上手:
npx skills add tt-a1i/archify -g装完跟 Agent 说一句话,你就知道为什么它能拿到 89k Star 了。