Archify

基本信息

类型：Agent Skill——让 AI 编程助手把代码仓库 / 系统描述画成可交互架构图
热度：约 35.7K Star、2.3K Fork（2026-09 报道）；MIT 协议
开源地址：GitHub tt-a1i/archify
宿主：装进 Cursor、Claude Code、Codex CLI、OpenCode 等 AI 编程工具

说人话版：它是干什么的

你说一句「画出 Browser → API → Redis → PostgreSQL 的缓存回源过程」，AI 生成结构描述（Typed JSON IR），Archify 校验后编译成一份独立自包含的 HTML 文件——打开就能搜索节点、追踪路径、切换主题、导出图片
迭代友好是最大亮点：需求变了（加 Redis、移鉴权），Agent 只改相关 JSON 对象，不重排整图；校验失败返回机器可读诊断，Agent 照单修复

五种图表类型

Architecture（系统结构）/ Workflow（流程审批 CI/CD）/ Sequence（API 调用链）/ Data Flow（数据管道 ETL）/ Lifecycle（状态机）

与同类工具对比

工具	驱动方式	AI 生成	迭代
Mermaid / PlantUML	代码 DSL	语法敏感易错	全量重写
draw.io / Excalidraw	鼠标拖拽	不适配 AI	手工改
Archify	自然语言 + Agent	JSON IR 容错	精确补丁

安装

npx skills add tt-a1i/archify -g

自检：node bin/archify.mjs doctor

✅ 已升级到 3.0.1（2026-10-02 完成）

项目	内容
旧版本	2.17.0-dev.1
当前版本	3.0.1（官方 2026-09-28 发布）
安装位置	`~/.trae-cn/skills/archify/`
依赖	无（3.0 起零 npm 依赖，比 2.17 更干净）
Node 要求	≥18（本机 v26.3.1 ✅）
旧版备份	`~/.trae-cn/backup/2026-10-02/archify_v2.17.0-dev.1_backup_20261002_100927/`（194 个文件）

3.0 的破坏性变更（已生效）：

❌ 移除 guided / story 视图
❌ 移除普通分享卡导出
✅ 新增 Lifecycle v2 泳道/列布局
✅ 交付前自动校验（visual-check）

升级后实测（全部通过）

环节	结果
下载校验	2,157,085 字节，与官方 Release 一致；`unzip -t` 无错误
doctor 自检	21 项全过（2.17 是 15 项）
官方示例出图	✅ 758KB 自包含 HTML
中文渲染	✅ 某内部 BI 项目架构图一次通过，中文标签清晰无乱码
validate	✅ 0 错误 0 警告
deliver	✅ 9/9 检查通过
visual-check	✅ 全 pass（containment / readability / themeStates / captures）

3.0 的校验明显更严：我第一次造图时用了 toSide: "top" + 手写 via 路径，被校验器拦下两处错误（连线方向不垂直、标签压住节点），并给出可直接照抄的修复建议。按建议改成 toSide: "left" + labelDy: -28 后一次通过。这就是「交付前自动校验」的实际价值。

visual-check 还会自动截图：深浅色 × 两种分辨率共 4 张 PNG，方便交付前肉眼过一遍。

常用命令（3.0.1）

A=~/.trae-cn/skills/archify/bin/archify.mjs
 
node $A validate architecture 图.json          # 只校验，不出图
node $A deliver  architecture 图.json 输出.html  # 校验 + 出图 + 收据
node $A check 输出.html                          # 检查成品
node $A visual-check 输出.html --summary         # 交付前视觉校验（3.0 新增）
node $A doctor                                  # 环境自检

五种图：architecture / workflow / sequence / dataflow / lifecycle

边界

校验器只查格式 / 几何 / 已写入关系，不能证明代码分析没漏组件——真实项目仍需懂系统的人确认；超大仓库（1000+ 文件）识别准确率会下滑。

AI 知识库

探索

Archify（画架构图的 Agent Skill）