Archify 是一个开源项目，最近霸榜好几周，它可以在对话里，把代码仓库或系统描述变成漂亮、可靠、可交互的系统地图。它是一套基于 Node.js 的渲染与校验系统，并以 Agent Skill 的形式支持 Raven、Cursor、Claude Code、Codex CLI 和 OpenCode。
它的玩法跟你想的不太一样，你说一句“帮我画一下这个系统的架构”，它不是直接让 AI 涂一张图出来，而是分两步：
- AI 先把你的描述（或者直接扫你的代码仓库）整理成一份结构化的 JSON 文件；
- 一个写死的程序拿这份 JSON 去渲染、去检查，检查不过就打回去，通过才给你出图。
为什么要多这一道？因为让 AI 直接画图有个老大难问题：它会编。图看起来挺像回事，仔细一看多了个不存在的服务，或者箭头指向完全说不通。
而 Archify 则不同，AI 负责理解和组织，渲染和校验交给程序，编不了假。检查失败的时候它也不给你甩一堆报错堆栈，而是返回一份“修复收据”，哪条规则挂了、问题出在哪个节点、建议怎么改等等。AI 又拿着这个能自己改，改完再验，直到通过为止。
如何安装
安装特别简单，需要具备 NodeJS 环境，使用下面命令安装即可。
npx skills add tt-a1i/archify -g
按空格选择全部，回车。
选择自己终端上要安装技能的智能体，自定义多选即可。
推荐软连接方式，这样后续便于技能的升级。
默认 Yes，直接回车。
看到如上输出，安装就完成了。
它本质上是个 Skill（技能插件），装到 Cursor、Claude Code、Codex CLI 这些 AI
编程工具里就能用，安装完后在对话框里直接自然语言交流使用就行。几秒钟给你一个 HTML
文件，双击打开就是一张可以点的系统图，字体都内嵌在文件里，离线也能直接打开，直接扔给同事或者贴入文档都可以。
测试生成图
我这里拿 CodeBuddy 中安装的技能测试，技能安装路径是： C:\Users\tzhuw\.codebuddy\skills，使用开源的项目 deepseek-harness 开源项目 源码测试。
先跑两条命令找找感觉：
node bin/archify.mjs doctor # 检查环境 node bin/archify.mjs demo /tmp/archify-demo # 生成一套示例
他会在项目目录下生成一个 archify-demo.html 的 Demo 架构图。
接下来，我们分析 deepseek-harness 源码并生成对应架构图。
稍安勿躁，等待几分钟，让它慢慢分析，会提示生成 JSON 文件。
经过漫长等待，生成后会有提示说明。
浏览器打开效果图如下，效果不错，比自己手搓的好太多太多。
这里是拿开源项目做演示，如果是自定义项目也是同理。
实际用后的感受
画真实项目的时候别贪多。 第一次让它扫仓库，一口气让它画了所有组件，出来的图密密麻麻没法看。后来在提示词里写清楚“8 到 12 个核心组件、一条主路径、细节放卡片里”，效果立刻不一样。画架构图跟写文章一个道理，什么都想说是什么都说不清。
图是活的，能操作点击。 打开生成的 HTML，按 / 搜节点，点中一个能看它的上下游依赖，按 R 看完整调用路径。关键是这些交互都是基于你真实的数据，不会点着点着冒出一条图上没有的连线。
导出格式很全面。 PNG、SVG、视频都有，还有一张 1200×630 的分享卡，尺寸刚好当公众号封面或者 PPT 插图。也支持稳定链接，比如 #focus=某节点，发给同事，人家点开就是你想要他看的那个视角，不用附一堆解释。
改图靠自然语言对话。 “把 auth 挪到左边”“高亮回滚路径”，改一处不影响其他部分的位置。手画过图的人都知道这有多省事——以前挪一个框，后面的连线全得重新捋。
五种图，别选错
| 类型 | 什么时候用 |
|---|---|
| Architecture | 组件、服务、存储、边界（最常用，拿不准就选它） |
| Workflow | CI/CD、审批流 |
| Sequence | API 调用、缓存回退这类有先后顺序的 |
| Data Flow | 数据从哪来到哪去、管道、血缘 |
| Lifecycle | 状态机、重试、超时 |
你学废了么 ^ ^
Good Luck~
原文链接：https://menglanglang.blog.csdn.net/article/details/166015002
《代码地图（Archify）——代码仓库秒生架构图》有0条回应