Skip to content

开源工具评测:Archify 把一句话变成可交互架构图 ​

开篇痛点 ​

让 AI 画架构图,痛苦经历谁都有过:

  • 让 Claude 写 Mermaid,出来的图丑得整整齐齐,箭头交叉得像毛线团;
  • 用 draw.io,得自己一个框一个框拖,半小时画不出一个系统;
  • 想让图跟代码对应起来?基本别想,AI 凭空画的图和你 repo 里的实现根本对不上;
  • 画完想改?"加个缓存层"——你得重新描述一遍,它又给你生成一张完全不一样的图。

Archify 干的事就是把这些痛一次解决:你跟 Agent 说一句话,它给你生成一个可交互的单文件 HTML——能点节点、能跳源码、能高亮路径、能继续对话修改。89.5k Star,不是没原因的。

Mermaid 死图 vs Archify 可交互 HTML(示意)

项目基础 ​

Archify(GitHub: tt-a1i/archify)是一个 Apache-2.0 + MIT 双协议的 Agent Skill,作者 tt-a1i 单人项目。它不是独立 App,是一个装在 Claude Code / Codex / Cursor / OpenCode 里的技能包,Kimi Work 插件商店也有上架。

它的核心设计很简单:

层谁干干什么
AgentClaude / Codex 等理解你的需求,写 typed JSON 图表描述或 Markdown 解答稿
Archify内置渲染器把 JSON/Markdown 渲染成自包含可交互 HTML
浏览器用户打开 HTML,点节点、切主题、导出图片/PDF

支持的图表类型覆盖十种:架构图、工作流、时序图、数据流、状态机、ER 图、类图、树形图、时间线、执行瀑布图。

两种工作模式:

  1. 画图模式:你描述一个系统,Agent 生成可交互架构图;
  2. Explainer 模式:你问一个问题(比如"P99 为什么飙高"),Agent 生成"结论先行"的一页式解答——先给答案,然后每个面板一个问题,步骤和图并排走,读到哪步图上高亮到哪步。

Archify 四步工作流(示意)

为什么推荐它 ​

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 会渲染成交互版。

核心优势对比 ​

维度Mermaiddraw.ioPlantUMLArchify
产出静态 SVG静态图静态图可交互 HTML
能否点节点跳源码否否否是(source-backed)
继续对话修改重写代码手拖重写代码直接说人话改
上手成本学语法手拖学语法说一句话
排版美观丑看你手活一般自动排版
排障一页纸做不到做不到做不到Explainer 模式
导出SVGPNGPNGPNG/WebP/PDF/WebM
协议MIT免费GPLMIT/Apache-2.0

一句话:Mermaid 是写代码画图,draw.io 是手拖图,Archify 是用对话生成可浏览的架构图——它占的生态位之前没人占住。

四种画图工具对比(示意)

手把手实操 ​

环境要求 ​

  • 装了 Claude Code / Codex CLI / Cursor / OpenCode 任意一个
  • Node.js 环境(npx 可用)

第一步:安装 ​

bash
npx skills add tt-a1i/archify -g

Kimi Work 用户直接在插件商店搜"可交互架构图"。

第二步:画一张架构图 ​

在 Agent 里直接说:

用 Archify 画一个 web 请求流程:浏览器请求 API,API 优先读 Redis,
缓存未命中时查 PostgreSQL 并回填缓存。

Agent 会走三步:

  1. 理解:把你的描述解析成图表 spec(JSON);
  2. 渲染:调 Archify 渲染器生成 HTML;
  3. 自校验:Proof Lab 里有 11 个内置校验场景,确保图能打开、节点不重叠、链接不悬空。

第三步:继续对话修改 ​

- 加个鉴权中间件
- 高亮缓存未命中这条路径
- 切浅色主题
- 导出成 PNG

第四步:读 repo 生成 source-backed 图 ​

读一下这个 repo,给我画一张架构图,节点能跳到对应源码。

Agent 会扫描代码结构,分析模块依赖,然后画出来的图每个节点都钉在 commit 上。

Source-backed:节点钉在 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 是给人用对话生成可浏览的架构图。它把"画图"从一门手艺变成了一次对话。

仓库:github.com/tt-a1i/archify

快速上手:

bash
npx skills add tt-a1i/archify -g

装完跟 Agent 说一句话,你就知道为什么它能拿到 89k Star 了。

本文阅读--次|全站访问--次|访客--人