❝本期是 AI工具系列 · 第 8 期
写方案、做汇报、带新人、评审架构……每次都要手动画架构图,是不是都很崩溃?
画图两小时,改图又两小时:节点歪了、线交叉了、边界对不齐,更别说还得手工同步代码变化。
今天介绍的 Archify,是一款"AI 原生"的架构图生成工具:你只需要描述需求(甚至粘贴一段 Mermaid),它就能生成一张经过自动化校验、可交互浏览的架构图。而且它不是玩具——我们把它用在了真实项目的合规审查系统上,效果相当能打。
❝🔥 热度证明:Archify 在 GitHub 上已经 9k+ star(截图如下),是目前社区里非常火的架构图生成工具,很多 AI Agent 用户都在用它。

一、Archify 是什么?
Archify 是一个基于类型化 JSON 规格生成架构图的工具,输出的是自包含的交互式 HTML(内联 SVG,无需任何外部依赖)。
它的定位很明确:先让 AI 理解你的系统,再自动排版、自动布线、自动校验,最后交付一张"经得起检查"的图。
二、和普通画图工具比,强在哪?
三个最打动我的点:
可验证:每次生成都跑 9 项构图检查,0 错误 0 警告才交付,杜绝"线穿盒子""标签叠字"这种低级问题; 可交互:交付的是 HTML,支持暗/亮主题、缩放、搜索、聚焦视图、关系追踪,汇报演示直接用; AI 友好:它本身就是一个 Codex/Claude 技能(skill),AI 可以直接读你的代码仓库,画出反映真实代码的架构图。
三、能画哪些图?
四、架构图示例
示例 1:AI 写作助手平台(通用示例)
一张"教科书级"的 LLM 应用参考架构——创作者、前端工作台、应用服务、大模型、数据库、对象存储,主链路 + 旁路一清二楚:

示例 2:真实项目——合规审查 Agent 运行时架构
这是我们实际项目里的图:Vue3 工作台 + Spring Boot 动作流水线(8 个动作处理器)+ 规则引擎 + 大模型审查,SSE 实时推送进度、人工确认(HITL)、报告导出、MySQL 落库,全部映射自真实代码:

❝两张图都是 Archify 自动排版布线,一次通过全部 9 项校验,零手工微调。
五、怎么用?三步搞定
第 1 步:写一份 JSON 规格
Archify 的核心是一个类型化 JSON:声明组件、边界、连线、卡片和视图。
{"schema_version": 1,"diagram_type": "architecture","meta": { "title": "AI 写作助手平台架构", "quality_profile": "showcase" },"layout": { "mode": "grid", "cols": 12 },"components": [ { "id": "user", "type": "external", "label": "创作者", "row": 1, "col": 0 }, { "id": "web", "type": "frontend", "label": "写作工作台", "row": 1, "col": 2 }, { "id": "api", "type": "backend", "label": "应用服务", "row": 1, "col": 5 }, { "id": "llm", "type": "cloud", "label": "大模型服务", "row": 1, "col": 8 } ],"connections": [ { "id": "user-web", "from": "user", "to": "web" }, { "id": "web-api", "from": "web", "to": "api" }, { "id": "api-llm", "from": "api", "to": "llm" } ]}组件类型有 frontend / backend / database / cloud / security / messagebus / external,完全覆盖常见架构语义。
第 2 步:自动校验
node bin/archify.mjs validate architecture candidate.json --quality showcase --json校验会检查连线交叉、标签遮挡、走廊混淆等 9 项指标,并给出精确的修复建议(坐标级的!),改完重跑即可。
第 3 步:交付 HTML
node bin/archify.mjs deliver architecture candidate.json output.html --quality showcase --json交付时会冻结规格快照,返回 SHA-256 校验和,保证"图上所见"与规格完全一致。
六、实测小技巧
用 showcase 质量档:默认交付就走 showcase,9 项检查全过才放行,省去返工;保持一条主链路:主路径清晰 + 少量侧支路,图才好看;节点控制在 12 个以内; 先让 AI 读代码:要画"真实架构",把 archify技能交给 AI,它会去仓库里找证据,而不是凭空编;Mermaid 老用户:直接把 flowchart/sequenceDiagram/stateDiagram粘给它,自动转成 Archify 的干净排版;汇报神器:交付的 HTML 自带聚焦视图和演示模式,开会直接投屏。
七、适合谁?
👨💻 开发者:画系统架构、API 调用链、数据流,交付文档用它; 🧑💼 架构师/技术负责人:评审图、部署拓扑、安全边界,一张图讲清楚; 📝 技术写作/布道:公众号、博客配图,告别"手动画图 2 小时"; 🤖 AI Agent 用户:它是 Codex/Claude 的技能,说一句话就能出图。
Archify 解决了架构图"画出来容易、画好难、维护更难"的痛点——AI 负责生成,工具负责质检,你只需要把注意力放在"系统该怎么设计"上。
下一期想看我拆哪个 AI 工具?评论区告诉我 👇
本文配图均由 Archify 生成。
📌 想要 Archify 技能?
关注后台回复 **skill-archify**,即可获取 Archify 技能的完整安装方式,马上用起来!
❝🔬 想看更多技术深度探索?→ OPC探索系列
📰 想第一时间获取AI行业动态?→ AI资讯系列
🛠 想学会用更多AI工具?→ AI工具系列
🚀想边看边做?→ vibecoding系列
Follow me,一起在AI时代踏浪~

夜雨聆风