📌 项目地址：tt-a1i/archify | ⭐ 3,863 颗星 | 🔧 JavaScript | 📜 未标注
让AI替你把系统结构画出来
写技术文档时最烦人的事之一就是画架构图。尤其是当你要描述一个微服务调用链、数据流或CI/CD流水线时，手动拖拽方块、连线、调颜色，一折腾就是半小时。Archify解决的就是这个痛点——它是一个专门为Claude和Codex CLI设计的agent技能，你只需要用英语描述你的系统或流程，它就会生成一个结构清晰、主题可切换、支持高清导出的技术图。
Archify的产出是一个独立的HTML文件，没有任何外部依赖。你可以直接在浏览器中打开它，一键在深色/浅色主题间切换，复制PNG到剪贴板，或者导出为PNG/JPEG/WebP/SVG格式。特别值得一提的是SVG导出：它会自动包含@media (prefers-color-scheme)变量，意味着你把SVG扔进GitHub README后，读者的浏览器会根据系统主题自动切换深色/浅色，不再需要你准备两个PNG再包一层<picture>。
60秒内开始使用
Archify是一个agent skill，所以你需要先有一个支持agent的CLI环境（Claude Code、Codex CLI或opencode）。安装只有一条命令：
npx skills add tt-a1i/archify -g
安装完成后，你可以在对话中直接调用。最简单的用法是：
Use archify to map this repository’s runtime architecture.
Archify会读取你当前仓库的代码结构，分析运行时代理关系，然后生成一张架构图。如果你没有现成仓库，也可以直接描述：
Use archify to draw a sequence diagram of a user login flow: frontend calls auth service, auth service validates against LDAP, then issues JWT, frontend stores token.
五种图类型，覆盖技术文档常见场景
Archify支持五种输出形式，每种都对应一种典型的文档需求：
- Architecture（架构图）：描述系统组件、云资源、数据库、缓存、安全组等。
- Workflow（工作流图）：请求生命周期、审批流程、CI/CD步骤、故障响应。
- Sequence（时序图）：API调用链、服务间请求顺序。
- Data-flow（数据流图）：数据管道、PII边界。
- Lifecycle（生命周期图）：状态机、对象状态变化。
你只需要在对话中告诉Archify你想要的类型和参与者/步骤，剩下的交给它处理。它的渲染器背后有JSON Schema验证、布局检查和HTML/SVG工件检查，如果第一次生成的图不完美，它会在验证后自动迭代调整。
它和传统画图工具有什么不同？
传统工具（draw.io、Excalidraw、Mermaid）也有AI辅助功能，但Archify的特殊之处在于它作为agent skill运行——你可以在同一个对话中既写代码又画图，上下文连贯。例如你在用Claude编写一个Kubernetes部署文件，然后可以直接说“顺便用Archify画一下这个部署的网络流量图”，Claude会调用Archify生成图，无需切换到另一个网站或软件。
另外，Archify的图渲染质量值得单独提一句：所有栅格导出（PNG/JPEG/WebP）都支持最高4倍原始分辨率渲染，而不是像大多数工具那样用Canvas上采样产生模糊。SVG则是真正的矢量。
谁真正需要这个项目？
不是所有人都需要，但下面这两类人群会发现它非常有用：
- 技术文档写作者：在GitHub仓库README中需要插入自适应主题的架构图。过去你不得不准备两张PNG，现在一个SVG搞定。
- DevOps和SRE：需要快速绘制CI/CD流程、故障处理runbook、事件响应时序。这些场景下，时间比完美排版更重要。
- 架构评审或头脑风暴：几个人在Claude对话中讨论系统设计，随手让Archify生成初稿，然后再迭代调整，比谁在白板上画得准。
当然，如果你对图表排版有极其苛刻的要求（比如像素级对齐、特定品牌色），Archify目前提供的定制接口有限。它更适合快速生成“整洁、专业但不极致定制”的图。
需要注意的点
- Archify目前只支持在Claude Code、Codex CLI和opencode这类agent环境中使用。如果你没有安装相应的CLI，或者习惯在浏览器中使用ChatGPT/Claude网页版，暂时用不了。
- 安装命令中的
-g表示全局安装，确保你的Node.js版本较新（建议18+）。 - 生成的HTML文件是自包含的，你可以直接发送给同事，无需担心他们是否有相关工具。但注意文件可能会包含一些内联的字体和样式，体积稍大。
- 项目许可证是MIT，可自由使用和修改。
总结
Archify把一个低频但痛苦的操作——画技术图——变成了自然语言对话的一部分。它没有试图取代Visio或draw.io的全部功能，而是精准切入了“快速生成、可嵌入代码仓库、自适应主题”这个子场景。如果你经常需要为README、技术文档或评审写架构图，并且已经在使用agent CLI，装上它应该能让你省下一半的画图时间。