一分钟看懂
Archify 是一个给 AI 编程助手使用的“自动画图工具”。你可以把一段系统说明交给 Cursor、Claude Code、Codex CLI 或 OpenCode，也可以让它分析一个现有代码仓库，随后生成结构清晰、可以交互和导出的架构图或流程图。
它最适合解决这样的需求：项目已经有代码或设计思路，但内容散落在文件、文档和聊天记录里，很难快速向别人讲清楚。使用 Archify 后，AI 可以把这些信息整理成一份独立网页，读者不仅能看到组件和连线，还能搜索节点、查看上下游关系、追踪指定路径，并将结果导出为图片或视频。
普通用户不需要自己编写复杂的绘图代码。你主要负责说明“想展示什么”，AI 负责生成图表需要的结构化数据，Archify 负责检查和渲染。不过，最终图中的业务关系是否准确，仍然需要熟悉项目的人确认。
你可以用它做什么
下面是几个比较容易理解的使用场景。
看懂一个陌生代码仓库
当你接手一个新项目时，可以让 AI 分析其中最重要的模块、数据库、外部服务和主要调用路径，再用 Archify 生成高层架构图。相比阅读一长段分析文字，图表更容易帮助新人建立整体印象，也方便团队检查 AI 是否遗漏了关键组件。
把系统设计变成可讨论的图
即使还没有代码，也可以从自然语言描述开始。例如：
浏览器请求先进入 API 服务，API 优先查询 Redis；缓存未命中时读取 PostgreSQL，并把结果重新写入缓存。
AI 可以把这段描述整理为包含浏览器、API、缓存、数据库和回退路径的架构图。你还可以继续要求它增加认证模块、移动某个组件，或者突出故障回退路径，不必自己从空白画布开始绘制。
描述流程和状态变化
除了系统架构，它还能表达发布审批、CI/CD、工具调用、接口时序、数据处理管道以及任务生命周期。例如，可以展示一次部署从代码提交、自动测试、人工审批到上线和回滚的完整过程，也可以展示订单从创建、支付、发货到取消的状态变化。
对比两个版本的架构
在设计评审或代码合并前，可以对比两份已经通过校验的架构快照。页面会明确区分变更前、具体差异和变更后，并列出新增、删除、修改、移动或重新连接的内容。它负责呈现变化事实，但不会替团队判断风险等级或代码是否适合合并。
生成结果是什么样的
Archify 的主要交付物是一份可以独立打开的 HTML 网页。样式和交互能力都包含在文件中，不需要为了查看图表再搭建一个网站。它适合放进项目文档、设计评审材料和会议演示，也可以直接交给其他人打开。
图表支持搜索和聚焦节点、查看明确写入的上下游关系、探查两点之间的有向路径、比较不同角色，以及播放预先编排的讲解章节。阅读过程中产生的视角变化不会修改图表原始事实。
需要静态材料时，可以导出 PNG 或 SVG；需要展示交互过程时，可以导出 WebM；还可以生成适合 README、发布说明或社交分享的 1200×630 图片。导出的内容会保留完整图表作为上下文，避免只截取一条路径后让读者失去整体方向。
主要能力
- 五类图表：支持架构图、工作流图、时序图、数据流图和生命周期图，分别适用于系统组成、办事流程、调用顺序、数据去向及状态变化。
- 多种展示风格：提供四种视觉预设、深浅主题、品牌标记和有限动画，可以在普通阅读与演示场景之间切换。
- 交互式阅读：支持搜索、节点聚焦、上下游查看、路径探查、角色比较和故事播放，复杂图表不必一次看完。
- 多格式导出：可生成自包含 HTML、PNG、SVG、WebM 和分享卡片，用于网页、文档、会议或项目介绍。
- 架构变化对比：可对比两个快照，清楚标出具体发生变化的节点和关系。
- 交付前检查：在生成最终文件前检查数据结构、布局、连线、标签间距和页面输出。新版本未通过检查时，可以继续保留上一份正确的预览。
- 可选源码证据：分析公开代码仓库时，可以在用户明确要求后，让部分架构节点关联到固定 Git 版本的源码文件和行号，方便从图表返回原始依据。
适合哪些人
它主要面向已经使用 AI 编程助手，并且需要把技术结构讲给别人听的用户。
- 开发者可以快速了解陌生仓库，或为自己的项目补充架构说明。
- 架构师和技术负责人可以制作设计评审、系统边界和架构演进材料。
- 运维、平台及安全团队可以描述部署、回滚、数据流向和信任边界。
- 技术写作者和开源维护者可以生成更容易阅读和分享的项目图解。
- 产品经理也可以借助图表理解系统大致结构，但关键关系仍应由研发人员复核。
如果你需要的是自由拖拽绘图、精细手绘、多人在线同时编辑，或者把任意 Mermaid 文件自动美化，它并不是通用替代品。官方明确说明，通用自动布局、托管式在线分享和所见即所得编辑不在当前产品范围内。
怎么开始使用
完整使用通常需要一台能够运行 Node.js 的电脑，以及 Cursor、Claude Code、Codex CLI 或 OpenCode 等受支持的 AI 工具。项目采用 MIT 开源许可证，可以免费使用、修改和分发。
上手过程可以简化成三步：
- 按官方说明把 Archify Skill 安装到正在使用的 AI 编程助手中。
- 描述需要展示的系统，或者打开代码仓库，让 AI 分析核心组件、主路径、外部依赖和系统边界。
- 让 AI 使用 Archify 生成图表，打开结果检查；如果重点不清楚，再通过对话要求移动、增删或突出相关内容。
第一次使用时，建议先画一个范围较小的架构图或工作流，只保留主路径和少量关键组件。确认结构正确后再逐步增加支线，比一次放入几十个节点更容易得到清晰结果。
使用前需要知道
- Archify 检查的是图表数据和展示规则。校验通过不代表业务逻辑、安全性或生产环境配置已经通过审计。
- 图中的上下游和路径来自用户或 AI 明确写入的关系，不是对真实系统进行的在线调用追踪，不能代替日志、监控或链路追踪工具。
- 架构对比只展示两个快照之间发生了什么变化，不判断影响范围、风险或是否应当合并代码。
- AI 对仓库的分析可能遗漏隐式调用、运行时配置或外部依赖。用于正式评审前，应由熟悉项目的人核对。
- Architecture 图可以启用严格的“部署归属”配置；缺少负责人、区域或私有数据库范围等必要信息时会验证失败，但它不会连接真实云环境进行检查。
- 项目仍在持续开发，支持范围和使用命令可能变化，安装或升级时应以官方快速入门和更新日志为准。
想先看效果，可以访问 Archify 官方项目页 和 场景指南；源码、安装方法和最新能力以 GitHub 仓库 为准。