Archify: AI如何将代码库变成精美的系统架构图

为什么你需要了解 Archify#

你是否曾花费数小时手动画系统架构图，然后每次代码变更都要重新更新？Archify 解决了这个问题——只需用自然语言描述，AI 就能将你的代码库变成精美的、可交互的架构图。

[!TIP] Archify 目前在 GitHub 上获得数千星标并处于趋势榜前列。这是目前最热门的 AI Agent 技能之一。

Archify 是什么？#

Archify 是一个开源的渲染和验证系统，作为 Agent Skill 适用于 Cursor、Claude Code、Codex CLI 和 OpenCode。不再需要手动画图或纠结 Mermaid 语法，只需告诉 AI：“帮我绘制这个仓库的运行时架构图”，Archify 就会：

生成类型化 JSON IR — AI 将系统描述为结构化数据
自动验证 — Schema、布局、HTML/SVG、路由检查
渲染为 HTML — 一个自包含的 HTML 文件，打开即可使用和分享

[!NOTE] Archify 不是通用的绘图编辑器或 Mermaid 主题。它将技术意图转化为沟通工件。

五种图表类型#

Archify 支持五种主要图表类型：

类型	最佳用途	示例
Architecture	组件、服务、存储、边界	运行时架构
Workflow	CI/CD、审批、工具调用	审批流程
Sequence	API 调用、缓存回退、认证	API 调用链
Data Flow	管道、血缘、PII	数据管道
Lifecycle	状态、重试、等待	请求生命周期

安装和使用#

全局安装

npx skills add tt-a1i/archify -g

bash

安装后，只需在聊天中询问 AI 代理：

请求架构图

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.

text

Archify 的独特之处#

智能布局#

不是通用的自动布局，AI 会选择层级、间距、路由和重点。端点确定性地分散，而不是所有箭头都堆在一个中点上。

类型化 JSON IR#

每个渲染模式都有 Schema 和可复现的源。你可以 diff、验证和复现任何图表。

原子验证#

交付前，Archify 运行五步验证：

Schema 验证
布局规则检查
HTML/SVG 渲染
路由间隙检查
标签-路由间隙检查

Last-Good 预览#

可选的桌面循环监视源，仅在通过所有检查后刷新。如果保存无效，之前验证的图表仍然可见。

与其他工具对比#

功能	Archify	Mermaid	Lucidchart	Draw.io
从代码自动生成	✅	❌	❌	❌
自动验证	✅	❌	❌	❌
导出 HTML	✅	❌	❌	❌
Before/After Delta	✅	❌	❌	❌
免费开源	✅	✅	❌	✅

实际示例#

绘制登录流程

Use archify to draw this login flow: Browser -> Web App -> API -> JWT validation ->
Redis session lookup -> PostgreSQL fallback. Keep the cache-miss path secondary.