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
安装状态（2026-09-07）✅
- 已装进 TraeWork：技能位于
~/.trae-cn/skills/archify/（v2.17），npm 依赖已装，官方 doctor 自检 15 项全过 - 用法：新开对话后直接说「用 Archify 画一张 XX 系统的架构图」即可自动触发；核心命令是
node ~/.trae-cn/skills/archify/bin/archify.mjs（validate / deliver 子命令）
⚠️ 本地版本已落后大版本（2026-10-02 核实）
| 项目 | 内容 |
|---|---|
| 本地版本 | 2.17 |
| 上游最新 | v3.0.1（v3.0 于 2026-09-28 发布） |
| 上游状态 | 仍在活跃维护 |
3.0 是破坏性升级：
- ❌ 移除 guided / story 视图
- ❌ 移除普通分享卡导出
- ✅ 新增 Lifecycle v2 泳道/列布局
- ✅ 交付前加入自动校验
- 要求 Node 18+
要不要升：本地 2.17 仍能用。若需要 Lifecycle 泳道图或分享卡，得升到 3.0；但要注意 3.0 砍掉了部分功能，依赖旧视图的用法会失效。
边界
校验器只查格式 / 几何 / 已写入关系，不能证明代码分析没漏组件——真实项目仍需懂系统的人确认；超大仓库（1000+ 文件）识别准确率会下滑。
相关日记
- 2026-09-07 - 首次了解
- 2026-10-02 - 核实：本地 2.17 落后上游 v3.0.1，3.0 为破坏性升级（移除 guided/story 视图与分享卡导出）