Archify：把代码仓库一键变成可交互架构图的AI Agent

近日，一款名为 Archify 的 AI Agent 工具登上 GitHub Trending 榜首，截至发稿已收获约 3.14 万 Star、1.9k Fork，并在 X 上获得多条十万级点赞的正面测评。与常见的 Mermaid、D2 等文本生成图工具不同，Archify 并不只是把文字描述渲染成图片，而是把绘图能力直接嵌入到 AI 编程 Agent 的工作流中，让 Agent 能够理解代码、生成结构化图表并持续修改。

工作原理：代码到架构图的四步链路

Archify 面向 Claude Code、Codex、Cursor 和 OpenCode 等 AI 智能体，以 Agent Skill 的形式运行。用户可以用一句自然语言指令，例如「分析这个代码仓库，并生成一张高层运行时架构图」，驱动 Archify 完成全流程。

其内部处理大致经过四个环节：

• Archify 先理解代码或文字描述，生成结构化的 JSON IR；
• 由规则层完成 Schema、布局和渲染检查；
• 最终输出一个独立的 HTML 文件，支持 SVG 与 PNG 导出；
• 同时附带搜索节点、追踪调用路径、切换深浅主题、导出 WebM 与分享卡片等交互能力。

Archify 目前支持架构图、工作流图、时序图、数据流图和生命周期图五类技术图。

与 Mermaid 的差异：嵌入 Agent 而非单纯渲染

Mermaid、Graphify 等工具主要负责把已有的文本描述渲染为静态图片，而 Archify 的差异在于它把绘图工具嵌入了编程 Agent 的工作流。开发者无需从头学习绘图语法，只需描述技术意图，代码理解、组件组织与结构化数据生成交给 Agent，Archify 则负责验证与渲染。

针对「模型画得快但不一定画得对」的问题，Archify 在交付前会检查数据结构、节点布局、标签和连线冲突；验证失败时，它会指出具体问题与允许采用的修复方式，而不是交付一张「看起来漂亮、实际上有错」的图。此外，Archify 还可以对比两个架构快照，以 Before / Delta / After 的形式标注新增、删除、修改、移动和重新路由的部分，让架构图有可能参与代码评审并随项目迭代。

局限与待改进点

Archify 并非实时监控系统，也不能自动证明图与线上运行状态完全一致，结果是否准确仍然取决于代码信息、用户提示以及 Agent 的分析能力。有网友实测后反馈，节点详情展示偏小，搭配无自带视觉能力的模型（如部分 DeepSeek 轻量版本）使用还不够顺畅，且 token 消耗偏大。作者在 X 上表示正在更新版本、持续攻克这些问题。

开发者背景

Archify 的开发者以网名「也无风雨也雾晴」（本文亲切称其为「晴天老师」）活跃于 X，自述通过专升本考试进入重庆邮电大学软件工程专业，曾在多家大厂的背景调查环节因学历碰壁，后来在 Manus 时任 COO Cz Chen 的建议下转向以开源项目证明能力，并最终凭借 Archify 等作品获得上海大厂 Offer。他表示，开源并不能抹去学历标签，但作品被使用、被认可，对他而言已是开源最大的意义。