Archify：AI编程助手生成交互式架构图新方案

在完成代码编写后，通常需要额外绘制架构图，这不仅费时费力，而且一旦代码修改，原有的图就不再适用。Archify的出现，为这一问题提供了新的解决方案。

Archify是一款开源的AI编程助手技能，它能够读取代码库或系统描述，并生成经过结构与布局检查的交互式HTML架构图。它不依赖于在线绘图工具，也没有拖拽编辑器，更适合已经使用命令行Agent的开发者。

安装后，开发者可以直接对Agent下达指令，例如：“读取当前仓库，画一张运行时架构图。”Archify会分析代码并生成结构化描述，然后负责检查图表规则和完成渲染，从而减少在代码与画图软件之间重复整理的工作。

Archify是什么？和在线架构图工具有什么不同

Archify与GitDiagram这类“输入GitHub链接生成图表”的在线工具不同。它主要作为Agent Skill接入Cursor、Claude Code、Codex CLI和OpenCode，也提供用于校验和渲染的Node.js CLI。Archify本身不包含大模型。

需要分析代码库时，宿主Agent使用的模型会读取其能够访问的代码或系统描述，并生成带有类型的JSON IR（中间表示）。Archify接收这份结构化数据，检查Schema、组件布局和连线路由等图表规则，再渲染成自包含的交互式HTML。

Archify如何生成和校验交互式架构图

JSON IR进入Archify后，会接受Schema、组件布局、HTML/SVG、连线路由以及标签与线路间距等检查。检查失败时，工具会返回对应的规则、对象和修正信息，让Agent针对有问题的部分调整，不需要重新生成整张图。

支持的图表类型和导出格式

Archify不仅生成系统架构图，还可以生成工作流图、时序图、数据流图和生命周期图等多种类型的图表。图表支持深浅主题切换、节点搜索、上下游查看和路径追踪，也能导出为PNG、JPEG、WebP或SVG；启用动态效果后，还可以导出WebM动画。

如何在 Claude Code、Codex 和 Cursor 中安装并使用 Archify

要在本地运行Archify的完整生成、校验和导出流程，需要安装Node.js，并准备好Cursor、Claude Code、Codex CLI或OpenCode等兼容环境。安装完成后，在需要分析的项目目录中打开Agent，直接输入类似下面的要求：

请分析当前仓库，并使用 Archify 生成一张运行时架构图。

Archify、GitDiagram 和 Mermaid 怎么选

这三个工具都能生成技术图表，但使用方式并不相同。Archify接入现有的AI Agent，GitDiagram从GitHub仓库链接开始分析，Mermaid则由用户编写文本语法来生成图表。

Archify适合谁？使用前要注意什么

Archify要不要安装，主要看你平时怎么写代码、怎么交付技术图表。它比较像是Claude Code、Codex 和 Cursor的配套工具，不是传统的画图软件。

Archify常见问题

Archify是免费的吗？

Archify采用MIT协议，项目代码可以免费使用、修改和分发。宿主Agent调用模型时，仍可能消耗API费用或订阅额度。

不用 Cursor 或 Claude Code 能用吗？

可以。Archify的完整工作流还支持Codex CLI、OpenCode 和 Raven，项目也带有用于校验和渲染的Node.js CLI。不同环境的安装方式并不完全相同。

能把已有的 Mermaid 图表转换成 Archify 吗？

Archify没有通用的Mermaid自动导入功能。如果宿主Agent能够理解现有的Mermaid文本，可以让模型将其重新整理成Archify使用的JSON IR，但这属于模型转换，不是Archify自带的解析器。

代码修改后，Archify会自动更新架构图吗？

不会自动持续同步。代码发生变化后，需要重新让Agent分析仓库并生成图表。架构图还支持比较两份经过校验的快照，用来查看新增、删除、移动和连线路由变化。

Archify源码与官方文档入口

Archify GitHub项目主页：https://github.com/tt-a1i/archify

Archify 官方文档：https://tt-a1i.github.io/archify/