告别拖拽画图！用大白话生成专业架构图的 Archify 工具（5700 Star）

做开发和架构设计的人一定有过这种体会——
写技术方案、技术文档、README，最耗时的不是理清逻辑，而是画图。  

Draw.io、Visio 得手动拖拽组件、连线、调布局、改颜色，一张微服务架构图没十几分钟下不来。
Mermaid、PlantUML 又得记一堆语法，多分支流程一复杂就容易踩坑。  

最近 GitHub 上冒出一个叫 Archify 的项目，已经揽了 5700 个 Star。  

一句话说清楚它做啥：用大白话就能生成专业架构图的 Skill。  

上手一试，就知道有多顺手

我想给微服务项目出一张架构图。
打开 Claude Code，随口提了一句：  

画一个电商系统的架构，包含前端、API 网关、订单服务、支付服务、数据库、缓存。  

Claude 先生成一个结构化的 JSON 描述，组件、连线、坐标全在里面。  

  

然后自动生成一个独立的 HTML 文件，浏览器直接就能打开。  

  

图表自带深色/浅色两种主题，按 T 键就能一键切换，视觉效果很舒服。  

  

导出也很方便——按 E 键弹出菜单，可以把 PNG 复制到剪贴板，也能下载成 PNG、JPEG、WebP、SVG。
整个过程我只说了一句话，后面 JSON 生成、渲染、切主题、导出全它自己搞定。  

它是怎么做到的？

01 五种图表类型全覆盖  

Archify 支持五种最常用的技术图表：  

• Architecture：系统架构图  
• Workflow：泳道流程图  
• Sequence：时序图  

  

• Data Flow：数据流图  

  

• Lifecycle：状态机图  

这五种类型基本覆盖了技术文档、方案设计、架构评审、CI/CD 文档、API 文档里 99% 的绘图需求。
每种图表都有对应的 JSON Schema 和渲染器，保证输出稳定、可复现。  

02 自然语言驱动，零学习成本  

你只需要用大白话描述系统或流程，比如一条 CI/CD 链路：  

pull request → tests → approval → build image → staging → smoke test → production  

Archify 就能直接生成对应的流程图，不用学 Mermaid 语法，不用拖拽，不用调布局。  

  

03 双主题自适应，一处嵌入自动跟随系统  

每个图表都有深色和浅色两套主题，你按 T 键切换或点按钮都行。
导出的 SVG 文件里嵌入了双主题 CSS 变量和 prefers-color-scheme 媒体查询，一旦放进 GitHub README 或博客，就会自动跟随读者的系统主题。
也就是说，你只需要维护一个 SVG 文件，就能同时适配深色和浅色阅读环境。  

04 最高 4 倍高清导出，直接粘贴到任何地方  

所有栅格导出（PNG、JPEG、WebP）都以最高安全分辨率渲染，最高可达 4 倍，不会出现模糊或锯齿。
并且支持一键复制 PNG 到剪贴板，随手就能粘贴到 Slack、Notion、GitHub、Figma 里。  

05 JSON IR + Schema 验证，不是单纯的 AI 生成器  

Archify 不是简单让 AI 画张图，而是一套完整的工程化闭环：
每种图表对应一个 JSON IR 和 JSON Schema，Claude 先生成结构化 JSON，渲染器再去生成 HTML/SVG。
渲染前会做 Schema 校验、布局检查、HTML/SVG 完整性检查，防止产出畸形图表。  

  

五分钟跑起来

安装只需要一条命令：  

npx skills add tt-a1i/archify -g

这条命令会通过开源的 skills CLI 安装 Archify，支持 Claude Code、Codex CLI、opencode 等多种 AI Agent 平台。  

装好之后，在 Claude Code 里直接说：  

使用 archify 来绘制出该仓库的运行时架构图。  

图就出来了。  

如果只是临时试用，不用永久安装：  

npx skills use tt-a1i/archify@archify --agent codex

把 codex 换成 claude-code 或 opencode 就能适配不同的 Agent。  

边界也要说清楚

Archify 不是通用的绘图编辑器，不能像 Figma、Visio、Draw.io 那样自由拖拽编辑。
它专注于把自然语言直接转成成品图表，不能直接在画布上拖动修改——如果要改，要么继续对话，要么编辑底层的 JSON IR。  

另外，导出为 PNG、JPEG、WebP 时，会优先使用系统自带的等宽字体，只有本地装了 JetBrains Mono 后才会调用。
Archify 也没有采用自动布局引擎，而是让 AI 自己去判断布局，所以偶尔可能还需要你手动微调一下 JSON。  

写在最后

我关注 Archify 有一阵子了，今天抽空上手试了一把。
它有意思的地方在于，并不试图替代 Draw.io 或 Figma，而是解决了另一个场景：架构已经在你脑子里，但要快速把它可视化出来。  

需要精确调节、多人协作，还是交给专业工具；但快速出图、迭代验证，Archify 一句话就成，省下来的时间你还能多琢磨琢磨架构本身。  

项目基于 MIT 协议开放，感兴趣可以去 GitHub 仓库翻源码和文档：
https://github.com/tt-a1i/archify  

如果你对这类 AI 开发工具有更多想法，欢迎到云栈社区一起交流，聊聊你用过的好用开源项目和架构心得。