Archify：7 万+ 星霸榜开源，一键把代码仓库变成可交互架构图

一、这是什么项目

Archify 是一款开源架构图生成工具，由独立开发者 @tt-a1i 创建，MIT 协议，截至 2026-10 实查已收获 76,368 个 GitHub Star，曾在 GitHub Trending 霸榜。

它解决的核心痛点是：把代码仓库或系统描述一键转换成专业级、可交互的架构图——支持 Architecture、Workflow、Sequence、Data Flow、Lifecycle 五种图表类型，生成自包含 HTML 文件，可直接分享或嵌入文档。

项目信息

GitHub: tt-a1i/archify
协议：MIT · 语言：JavaScript (Node.js) · 最新：v2.16.0（2026-08-30）

二、核心功能一览

一键切换深色/浅色主题，适配不同场景

功能	说明
五种图表类型	Architecture（组件关系）、Workflow（工作流）、Sequence（时序）、Data Flow（数据流）、Lifecycle（生命周期）
Agent Skill 集成	支持 Cursor、Claude Code、Codex CLI、OpenCode 等 AI 编程助手，通过自然语言描述生成架构图
自包含 HTML 输出	生成的图表是单个 HTML 文件，无需外部依赖，可直接打开或分享
Dark/Light 主题
多格式导出	支持 PNG、SVG、WebM 动图、1200×630 分享卡片导出
可交互体验	支持搜索节点、追溯上下游关系、查看精确路由、对比语义角色、播放引导故事
架构对比	Architecture Delta 可比较两个版本的架构图，显示新增/删除/修改/移动的节点
源码追溯	支持标记 SRC n，点击可查看 Git 验证的文件和行号范围

三、为什么这么火

1. 真正的实用价值

Archify 不是普通的图表工具，它是为 AI 编程助手设计的 Agent Skill。你只需要在 ChatGPT、Claude、Cursor 等对话中描述系统架构，Archify 就会自动生成专业的架构图。

比如："Show me the architecture of this repository" 或 "Map the CI/CD pipeline with approval gates"，一句话就能得到可交互的架构图。

2. 严格的验证机制

Archify 的核心优势是 Typed JSON IR + 原子化验证。生成的架构图必须通过 Schema、布局、HTML/SVG、路由、标签等多个维度的检查，失败时会返回机器可读的错误信息和修复建议。

这意味着生成的图表不仅是好看的，更是准确可靠的——每个节点、每条连线都有据可查。

3. 零配置开箱即用

安装只需要一条命令：

npx skills add tt-a1i/archify -g

然后就可以在任何支持的 Agent 中使用。无需 Docker、无需 Python、无需额外依赖。

4. 丰富的交互功能

生成的架构图不是静态图片，而是完整的交互式应用：

/ — 搜索并聚焦节点
R — 追踪上下游关系
L — 对比语义角色
M — 打开总览雷达图
P — 播放引导故事
F — 进入演示模式

安装方式

支持 Raven、Claude Code、Codex CLI、OpenCode、Claude.ai、DeepSeek Harness 等多种环境。上传 archify.zip 到对应目录即可使用。

四、下载与安装

Archify 完全免费开源，MIT 协议。

方式一：Agent Skill 安装（推荐）

npx skills add tt-a1i/archify -g

然后在 Cursor、Claude Code、Codex CLI 等工具中直接使用。

方式二：本地运行

git clone https://github.com/tt-a1i/archify
cd archify
node bin/archify.mjs guide "Show me a CI/CD pipeline"

方式三：在线体验

下载 Release

archify.zip（约 1.26MB）

五、我的判断

优点

真正解决痛点 — 架构师的日常需求，AI 时代终于有了好工具
验证机制严谨 — Typed JSON IR + 原子化检查，输出可靠
交互体验出色 — 搜索、追溯、对比、故事模式，不止于看图
零配置 — 一条命令安装，开箱即用
MIT 协议 — 可自由使用和修改

注意点

目前主要面向 Node.js 环境（^22.19.0 || >=24.0.0）
复杂架构的描述需要一定的技术功底
120 个 open issues，部分边界场景可能不稳定
主要面向开发者，非技术人员使用门槛较高

Archify 是今年 GitHub 上最实用的架构可视化工具——它不只是画图，而是让 AI 帮你理解、验证、追溯代码库的真实架构。7 万+ 星、Trending 霸榜不是偶然，是真正解决了开发者的痛点。

六、我把它生成的图拉到本地跑了一遍

这版没只读 README——Archify 生成的是自包含 HTML（零外部依赖、离线可开）。我把仓库 examples/ 里现成的三张产物 HTML 拉下来，在 1920×1080 无头浏览器里渲染截了真图，验证它「一键出可交互架构图」不是 PPT：节点、连线、图例、说明卡都是运行时画出来的，不是死图。