痛点：架构图为什么这么难画？
手动绘制架构图是开发者的噩梦。一个中型系统的架构图，从理解代码到画出图表，通常需要 2-4 小时。更糟糕的是，架构图很快就会过时——代码更新了，图表还是旧的。
根据 GitHub 数据，34,400 个 Star 和 2,185 个 Fork 证明了这个问题的普遍性。Archify 提供了一个激进的解决方案：让 AI 代理直接从代码生成可验证的架构图，从理解到输出只需几分钟。
工作原理：从代码到交互式地图
Archify 的工作流程分为四步：
- 生成（Generate）：AI 代理分析代码库或系统描述，创建类型化的 JSON 中间表示（IR）
- 验证（Validate）：内置验证器检查布局、路由、标签清除等规则，确保图表质量
- 预览（Preview）：桌面模式实时监视 JSON 文件，只在验证通过后更新
- 交付（Deliver）：渲染成自包含的 HTML 文件，包含交互功能
关键创新在于类型化 JSON IR。代理生成结构化的中间表示，而不是直接画图。这使得图表可以精确验证、版本控制、增量更新。
功能拆解：五个核心模块
| 模块 | 一句话 | 核心能力 | 适用场景 |
|---|---|---|---|
| 架构图（Architecture） | 系统组件、服务、存储、边界 | 层级布局、路由追踪、信任边界 | 系统设计、技术评审 |
| 工作流（Workflow） | CI/CD、审批、工具调用、运行手册 | 渠道隔离、分支逻辑、异常处理 | DevOps 流程、自动化 |
| 序列图（Sequence） | API 调用、缓存回退、认证、异步追踪 | 时间线、返回路径、时序分析 | API 设计、性能优化 |
| 数据流（Data Flow） | 管道、血缘、PII、消费者 | 数据转换、存储、边界 | 数据工程、合规审计 |
| 生命周期（Lifecycle） | 状态、重试、等待、终止结果 | 状态机、重试逻辑、取消路径 | 事务处理、错误恢复 |
独特优势：
- 布局判断优于通用自动布局：代理选择层级、间距、路由、重点，而不是通用算法
- 原子验证：模式、布局、HTML/SVG、路由、标签清除必须全部通过
- 失败修复收据：
validate --json返回稳定的规则代码、确切主题、测量证据
- 真实交互：聚焦、上下游追踪、精确路由、角色比较、故事播放都复用作者节点
实测数据：从代码到图表的真实表现
基准数据：
- Star 增长：4.5 个月从 0 到 34,400（平均每月 7,644 Star）
- 版本：v2.16.0（2026-08-30）
- 测试覆盖：1,026 个测试，988 通过，38 条件跳过
- 支持平台：Cursor、Claude Code、Codex CLI、OpenCode、Raven
实际体验：
# 安装
npx skills add tt-a1i/archify -g
# 从描述生成（无需代码库）
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
# 从代码库生成
Analyze this repository, then use archify to create a high-level runtime architecture diagram.成本对比：
| 场景 | 手动绘制 | Archify 生成 |
|---|---|---|
| 简单架构图 | 2-4 小时 | 5-10 分钟 |
| 复杂系统图 | 1-2 天 | 30-60 分钟 |
| 维护更新 | 每次重画 | 增量更新 |
局限性：
- 需要 Node.js 22+ 环境
- 复杂图表需要多次迭代优化
- 72 个 Open Issues 表明仍在活跃开发
- 不支持 Mermaid 解析、通用自动布局、托管共享
安装+适用场景+结语
安装（一行命令）：
npx skills add tt-a1i/archify -g最适合：
- 架构师：快速生成可评审的架构图
- DevOps 工程师：自动化 CI/CD 流程文档
- 技术负责人：系统设计评审、团队沟通
- 开源维护者：README 图表、发布说明
不适合：
- 需要 WYSIWYG 编辑器的设计师
- 非 Node.js 环境
- 需要实时协作的团队
对不同角色的意义：
- 开发者：从「画图」到「生成图」，节省 80% 时间
- 团队：架构图版本控制，与代码同步更新
- 组织：技术文档标准化，降低沟通成本
内链相关旧文：
合规披露：本文基于公开的 GitHub 仓库、官方文档和实际测试数据撰写，不构成投资建议。Archify 是开源项目，MIT 许可证，作者与本文无利益关系。
评分：8.5/10（功能完整度 9、设计深度 9、文档质量 8.5、安装便捷度 9、中文友好度 7、实际效果 8.5、社区活跃度 9）