Archify 实测：5 种架构图 1 键生成，还能溯源验证专注工具资源与实战教程胖猫小栈

画架构图有多烦，写过代码的人都懂：draw.io 拖拖拽拽半天，代码一改图又得跟着改；Mermaid 效率是高点，颜值又差点意思。

最近 GitHub Trending 上一个叫 Archify 的开源项目火得厉害，一天涨了几千 star。我试了试，发现它最牛的地方反而不是画图，而是能让每张图都”有据可查”。这篇把它的玩法、亮点和坑都给你捋清楚。

它到底是什么

Archify 不是又一个画图软件，而是一个 Agent Skill——给 Cursor、Claude Code、Codex CLI、OpenCode 这些 AI 编程工具用的技能。你在对话里告诉它系统的架构或者丢给它一个代码仓库，它直接给你生成一张可交互、颜值在线的专业技术地图，整个输出就是一个单 HTML 文件，能打开、能分享、能放进 README。

作者把它做成了 Node.js 的渲染 + 校验系统：AI 先产出类型化的 JSON 中间表示，Archify 再用确定性的规则把它编译成 HTML/SVG。说白了，AI 负责”理解”，Archify 负责”把关出图”。目前稳定版是 v2.16.0，MIT 协议，GitHub 上已经 2 万多 star。

5 种图类型

它支持 5 种图，对应不同的场景：架构图（Architecture）看组件、服务、存储、边界，系统整体长啥样；工作流（Workflow）画 CI/CD、审批、工具调用、操作手册这类流程；时序图（Sequence）按时间线看一次交互，适合接口调用、缓存回退、鉴权、异步调用；数据流（Data Flow）看数据怎么流、边界在哪，管道、血缘、PII、消费者都行；生命周期（Lifecycle）画状态、重试、等待、终态，适合状态机和容错设计。

每个类型还带 4 套视觉预设（Signal Flow、Blueprint、Classic 等），深浅主题一键切换，画出来的图风格统一、直接能拿得出手。

最值钱的：验证能力

说句实在的，会画图的 AI 工具不少，Archify 真正打动我的是它拒绝让 AI 瞎编。AI 画架构图最容易出问题：画得好看，但里面的关系是它脑补的，跟真实代码对不上。Archify 用了一套很硬核的机制来堵这个口子：

类型化 JSON 中间表示，每个图都有 schema 可复现，不是黑盒；原子化校验后交付，schema、布局、HTML/SVG、路由、标注全查一遍，全部通过才替换上一版，不然保留旧图；失败带”修复回执”，校验不过时返回结构化诊断，告诉 AI 具体哪个对象出了问题、支持哪些修法，而不是丢一堆堆栈让你自己猜；证据回溯，基于代码库生成的节点会标上 SRC n，点开能直接跳到 Git 校验过的源文件、具体行区间，钉在一个公开 commit 上，不是凭空指认；不编造拓扑，聚焦、上下游追溯、路径探查这些交互，都只用作者写的节点和关系，不会脑补运行时影响。

这套”先验证再交付”的思路，对拿架构图做评审、做汇报的场景特别值钱。

我实测跑了一遍

上手比我想象的简单，不用折腾复杂配置。

第 1 步：安装。一行命令全局装：npx skills add tt-a1i/archify -g。想先试试不装，也可以直接 npx skills use tt-a1i/archify@archify --agent codex。

第 2 步：从描述开始，不用仓库。直接在对话里说：”Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.” 一句话它就能给你画出那条链路图。有代码仓库的话，让它先分析再画：”Analyze this repository, then use archify to create a high-level runtime architecture diagram. Show 8–12 core components, one primary path, external dependencies, and trust boundaries.”

第 3 步：在聊天里迭代。画完之后直接补指令：add Redis、move auth to the left、highlight the rollback path，它会保留类型化源码做定点修改，不会把整张图推倒重来。

第 4 步：打开、交互、导出。生成的 HTML 用浏览器打开就能玩：/ 搜节点、R 探查一条链路、L 对比两个角色、F 进演示模式、T 切深浅主题、E 导出。导出支持最高 4 倍分辨率的 PNG、SVG、WebP、WebM，还有 1200×630 的分享卡片，扔 README 和社媒正好。

有哪些场景

除了给代码仓库画运行时架构，它还挺全能：PR 评审，架构变更对比，Before / Delta / After 三栏，精确列出增删改移，还带机器回执，适合设计评审时看改动到底动了哪些事实；接口设计，时序图画 API 调用、缓存回退、鉴权链路，一目了然；CI/CD 流程，工作流图画审批、部署、回滚的完整路径；数据管道，数据流图画血缘和敏感数据边界，合规评审用得上；状态机/容错，生命周期图画重试、等待、终态。

优点

不编造、可溯源：验证机制杜绝 AI 脑补拓扑，证据还能回到真实源码；单 HTML 交付：一个文件走天下，分享、嵌入、离线打开都方便；交互感强：搜索、链路追溯、角色对比、演示模式都有，不是静态图；导出格式全：PNG/SVG/WebP/WebM + 分享卡片，画质最高 4 倍；免费开源：MIT 协议，装一次全平台的 AI 编程工具都能用。

缺点和坑

也有几盆冷水要泼：它不是独立软件，本质是 Agent Skill，得先有 Cursor、Claude Code、Codex 这类工具，再配上模型 API Key 才能用，纯小白会有点门槛；需要 Node.js 环境，跑渲染和校验要 Node 运行时，环境得先备好；英文指令更稳，官方示例 prompt 都是英文，中文也能处理，但想效果稳定建议照官方英文模板来；校验严格，图越复杂，第一次不一定能过全套校验，得按修复回执调一两轮，急性子可能会觉得烦；有更新检查行为，偶尔会去拿一次稳定版清单做提醒（不下载不更新），在意的话可以设 ARCHIFY_UPDATE_CHECK_DISABLED=1 关掉。