AI 编程助手——能听懂自然语言指令、帮你写代码的 AI 程序，比如 Cursor、Claude Code、Codex CLI、OpenCode——写代码已经很熟练，但让它们画一张系统架构图（用方框和箭头展示系统由哪些部分组成、各部分如何通信的示意图），一直是块短板。开源项目 archify 专门补上这块：在 GitHub 上已获 4.06 万 Star 的它，能让 AI 助手用大白话描述系统，直接产出一张经过机器验证、可交互、可导出的架构图，项目以 MIT 协议发布，代码公开免费，个人和公司都可自由使用、修改。
背景：代码 AI 会写，图还得人画
过去两年，AI 编程助手大幅降低了写代码的门槛，但系统设计文档和架构图大多仍靠手工绘制。常用的文本画图工具（如 Mermaid）需要人先想清楚结构、再手写脚本，图更新不及时，很快就会和真实实现脱节。archify 的思路是把画图这个环节也交给 AI，并加上机器验证，让图不再是「仅供参考」的草图。
archify 是什么
archify 是一个基于 Node.js（一种在开发工具中广泛使用的 JavaScript 运行环境）构建的渲染与验证系统，形式上属于技能库（Skill）——给 AI 助手安装的专项能力包。安装后，在任意支持的 AI 助手对话框里用大白话描述系统，例如「浏览器 → API → Redis（内存缓存数据库）→ PostgreSQL（关系型数据库）兜底」，它就能生成一张成体系的图。不需要现有代码仓库，纯文字描述即可起步。
先验证，后出图
archify 的工作流水线是五步：生成、验证、预览、交付、迭代。AI 助手先按固定格式输出图的草稿数据（称为 typed JSON IR——JSON 是人与机器都能读的文本数据格式，IR 即中间表示，相当于一张标准化的图的「草稿」）；archify 的校验器检查草稿是否符合规则，全部通过才渲染成 HTML/SVG 图。
验证失败时也处理得很具体：不是抛出一堆堆栈报错，而是返回机器可读的 JSON 回执，包含稳定的规则码、出错对象和对应的修复建议，支持在两个修正回合内完成修正；本地还有「最后良品」预览模式，文件保存不完整时保留上一版已通过验证的图，不会黑屏。
能画五类图
archify 支持五种图：架构图（组件、服务、存储、边界）、工作流（CI/CD，即持续集成与持续交付——自动构建、测试、发布代码的流程；常用于审批、工具调用场景）、时序图（API 调用、缓存回退、鉴权）、数据流图（管道、血缘、敏感数据）、生命周期图（状态、重试、终态）。提供 4 种视觉预设、明暗双主题和内置品牌图标，导出支持 PNG、SVG、WebM，还能一键生成 1200×630 的分享卡片，适合直接放进 README、发布公告或社交媒体。
两个值得关注的设计
架构变更对比。 对同一系统的两个版本快照做机器对比，输出 Before / Delta / After 三态结果，精确列出新增、删除、移动、改道的组件。代码合并前的架构评审，可以基于机器算出的差异，而不是人肉逐图核对。
源码级证据。 图中的节点可以挂接真实源代码位置，标注格式为 SRC n，点击即跳转到 Git 校验过的文件与行号，保证图上的每个组件都有据可查，不是 AI 凭印象编出来的。
安装与使用
安装只需一行命令：npx skills add tt-a1i/archify -g（npx 是 Node.js 自带的免安装运行工具）。支持 Cursor、Claude Code、Codex CLI、OpenCode 四种主流 AI 编程助手，也可手动 ZIP 安装到 Raven 等环境；社区还提供了 DeepSeek Harness 的 dsh 插件集成。
隐私方面：更新检查默认约 72 小时一次，只请求一份固定清单做提示，不发送版本号、项目代码或任何设备信息；设置环境变量 ARCHIFY_UPDATE_CHECK_DISABLED=1 可彻底关闭联网检查。
结论
archify 把架构图的定位从「画图工具」变成了「可验证的交付物」：图由 AI 生成、机器校验、证据可溯，评审和分享都建立在确凿差异之上。如果你正在用 AI 编程助手做项目，写设计文档、评审架构变更或准备技术汇报，它值得装进技能库试一次——免费、开源、一条命令装完。