摘要：
在AI编程助手日益普及的今天，开发者们早已习惯在聊天窗口中让AI帮忙写代码、修Bug、做重构。但当需要把一段复杂的系统描述变成一张清晰、专业、可交互的架构... 在AI编程助手日益普及的今天，开发者们早已习惯在聊天窗口中让AI帮忙写代码、修Bug、做重构。但当需要把一段复杂的系统描述变成一张清晰、专业、可交互的架构图时，大多数AI助手却显得力不从心——要么只能输出粗糙的Mermaid代码，要么生成的图表缺乏美感、难以验证、更谈不上分享和协作。
Archify 的出现，正在改变这一切。
什么是Archify？
Archify 是一个专为 AI 编程助手设计的 Node.js 渲染与验证系统，支持 Cursor、Claude Code、Codex CLI、OpenCode 等主流 AI 编程工具。它的核心使命很简单：让 AI 代理直接在聊天中生成精美、可验证的交互式系统架构图。
你不需要提供完整的代码仓库——只需用自然语言描述你的系统，AI 代理就能生成结构化的 JSON IR（中间表示），Archify 再将其确定性编译为自包含的 HTML/SVG 文件。整个过程就像在 AI 导航 中精确设置目的地一样——你描述需求，它帮你绘制出清晰的路线图。
五大图表类型，覆盖全场景
Archify 不是那种“只能画一种图”的工具。它原生支持五种图表类型：
架构图：展示组件、服务、存储和信任边界，适合系统整体概览
工作流图：呈现 CI/CD、审批流程、工具调用和运行手册
序列图：刻画 API 调用、缓存回退、认证流程和异步追踪
数据流图：描绘数据管道、血缘关系、PII 处理和消费者链路
生命周期图：展示状态、重试、等待和最终结果
每种图表类型都有对应的 Schema 和验证规则，确保输出的每一张图都是“合格的”。
不止于“画图”——真正的工程级能力
如果只是把文本转成图表，Archify 和 Mermaid 的差距并不大。但 Archify 的真正价值在于它构建了一整套 工程级的可视化工作流：
原子级验证：Schema、布局、HTML/SVG、路由和标签等所有检查必须全部通过，才能替换上一次的已知良好输出。这意味着你得到的每一张图都是经过“质量门禁”的。
架构变更对比：在 PR 审查时，Archify 可以对比两个验证快照，以 Before / Delta / After 的形式精确显示新增、删除、变更、移动和重新路由的内容。这对团队协作和代码审查来说是一项极具实战价值的能力。
修复回执：当验证失败时，Archify 不会抛出一个让人摸不着头脑的 Node 堆栈，而是返回稳定的规则代码、精确的问题主体和测量证据，以及支持的修复控制项。AI 代理可以根据这些信息精准地修正 JSON 源文件。
自包含输出：最终产物是一个独立的 HTML 文件，可导出 PNG、SVG、WebM 以及 1200×630 的分享卡片。无论是放进 README、发到社交媒体还是用于演示汇报，都极其方便。
为什么说它超越了 Mermaid？
在 AI 工具导航 中，图表生成类工具并不少见，但 Archify 的定位和思路完全不同。
Mermaid 是一个通用的文本转图表引擎，而 Archify 是 AI 时代的专业架构可视化工具。它不追求“什么图都能画”，而是专注于“把系统架构图画得专业、可信、可验证”。
Archify 让 AI 代理自主选择层级、间距、路由和重点，而不是依赖通用的自动布局算法。它还支持聚焦节点、上下游可达性追踪、精确路由探测、角色对比以及引导式故事播放等功能——所有交互都基于已授权的节点和关系，不会凭空捏造拓扑或声称运行时影响。
上手有多简单？
npx skills add tt-a1i/archify -g
然后在任意 AI 代理的聊天窗口中描述你的系统即可。比如：
“分析这个仓库，然后用 archify 创建一个高层次的运行时架构图，展示 8-12 个核心组件、一条主路径、外部依赖和信任边界，把细节放在卡片里而不是增加更多连线。”
后续还可以继续用自然语言迭代优化：add Redis、move auth to the left、highlight the rollback path。
谁在用 Archify？
Archify 已获得 APINEBULA 和 EverMind 两家公司的赞助支持。其中 EverMind 的 Raven 项目已将 Archify 作为其 Skill 之一，用于生成经过验证的交互式系统地图。
项目当前稳定版本为 v2.16.0，代码采用 MIT 开源协议，欢迎任何形式的 Issues、PR 和真实场景的图表投稿。
总结
如果说 Mermaid 解决了“把文本变成图表”的问题，那么 Archify 解决的是“让 AI 画出可信、可审查、可分享的专业架构图”的问题。它不是一个通用的绘图编辑器，而是一个 为 AI 编程助手量身打造的可视化基础设施。
在 AI 编程助手日益成为开发标配的今天，Archify 正在填补一个重要的空白——让架构可视化这件事，像聊天一样自然。