让AI Agent在对话里生成可验证架构图：Archify深度解读

星眸·GitHub 观察者 技术创作者 2026-08-27 1362 阅读

用自然语言在聊天窗口里生成专业架构图——这件事本身不新鲜。但生成的图能直接拿来作技术文档、PR 评审、和团队共享的，却凤毛麟角。大多数 AI 画出来的图，要么箭头歪斜，要么字体发虚，要么输出个残缺的 SVG，发出去丢人。

Archify（tt-a1i/archify，18K ⭐，1.3K Fork）最近在 Trending 上持续走强，8 月单周最高新增 3K Star。它做的事很具体：给 Claude Code、Codex CLI、OpenCode 这类 AI 编程 Agent 装上一个 Skill，让它们在对话里直接产出一张经过验证的、可交互的、自包含 HTML 架构图。

核心逻辑：生成—验证—交付

Archify 的工作流分三层。

第一层：生成。 Agent 接收一条自然语言指令后，不是直接生成图片，而是输出一个结构化的 JSON IR（中间表示）。这个 JSON 描述图的节点、边、标签和语义分类（postgres、redis、aws.lambda 这类标签会被自动映射为对应的视觉类别），但不包含任何坐标信息。坐标由专门的渲染器决定。

第二层：验证。 JSON IR 产出后，Archify 内置的验证器会跑一轮质量检查：Schema 校验 → 布局合理性检查 → HTML/SVG 产物审查。斜线箭头、越界节点、图例区域污染这类渲染 bug 在交付前会被自动修复，并返回稳定可读的修复提示。验证不通过，产物不会替换上一次通过验证的版本。

第三层：交付。 验证通过后，输出一个自包含 HTML 文件，浏览器打开即可交互，无需任何服务器或框架依赖。导出支持 PNG（最高 4 倍分辨率，用于 Retina 屏和打印稿）、SVG（自动携带明暗两套主题变量）、WebM（录制引导演示路径）、1200×630 分享卡片（用于 GitHub README 或社交媒体）。

五种图，覆盖技术沟通主要场景

Archify 支持五种图类型，每种对应不同场景：

  • Architecture（架构图）：展示组件、服务、存储、信任边界，适合系统设计文档和新人 onboarding
  • Workflow（工作流图）：泳道式流程图，适合 CI/CD 流水线、审批流程、异常处理
  • Sequence（时序图）：API 调用链、缓存回源、认证检查，适合代码 review 和事故复盘
  • Data Flow（数据流图）：数据来源→处理→存储→PII 边界，适合数据治理和合规文档
  • Lifecycle（生命周期图）：状态机、重试、等待、终态，适合业务逻辑说明和客服培训

Architecture 图还有个值得关注的特性：Architecture Delta。当你对系统做了重构后，可以让 Archify 分别生成变更前后的两个 JSON IR，再运行 archify.mjs compare architecture base.json head.json delta.html --json，它会输出一张 Before / Delta / After 的对比视图，精确标注出新增、删除、修改、移动的节点和连线。这个功能对 PR 评审场景很有用——架构演进不再是一堆文字描述，而是一张可以点击、可以播放的差量图。

安装极简，但有门槛

安装只需一条命令：

npx skills add tt-a1i/archify -g

Claude Code、OpenCode 开箱即用；Cursor 需要加非交互参数：

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

不想永久安装也可以试用：

npx skills use tt-a1i/archify@archify --agent codex

对于 Claude.ai 网页版，上传 archify.zip 到 Settings → Capabilities → Skills 即可，不过这个场景只有 Prompt-driven 模式，依赖 Node.js 的验证流程不可用。

适合谁，不适合谁

适合的场景：

  • 需要快速给代码仓库出一张架构图，用于设计评审或新人培训
  • 做代码 review 时想让 AI 生成一张调用链时序图，使讨论更直观
  • 开发 AI/Agent 系统，需要画多 Agent 协作链路、工具调用流程
  • 写技术博客或文档，需要一张质量稳定的配图，深浅色主题自适应

不适合的场景：

  • 需要像素级排版控制的最终交付图——这是 Figma/Excalidraw 的领地
  • 想把已有的 Mermaid 文件美化——Archify 不会解析现有的 Mermaid DSL，它是从自然语言重新生成
  • 精细的手工标注和拓扑控制——Archify 的坐标由渲染器自动决定，不开放细粒度调节

此外，Archify 最近新增了 DeepSeek Harness 集成包（v2.15.0，2026-08-17），可通过 dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0 安装，支持 DeepSeek Agent 生态。v2.14.0 到 v2.15.0 之间主要修复了 sequence 图的 opt-in column_fit 和 DSH 打包在 Windows 上的便携性问题，维护频率较高（近期每 4-6 天一个版本）。

与同类工具的本质区别

Archify 的核心价值不在于”让 AI 画图”，而在于”让 AI 画的图值得信任”。

Mermaid 优点是嵌入 Markdown 方便，但语法敏感、AI 生成容易出错、无交互能力。Excalidraw 手绘风格适合头脑风暴，但产出的图无法做可验证的结构化对比。Archify 通过 typed JSON IR + 验证门禁，把图的准确性问题从”生成后靠人眼检查”变成了”生成前由系统保证”——每个节点、每条边都有结构化来源，而非 AI 凭空构造。

可执行的下一步

如果你用 Claude Code 或 OpenCode：

  1. 运行 npx skills add tt-a1i/archify -g 完成安装
  2. 打开一个项目，问你的 Agent：”Use archify to map this repository’s runtime architecture”
  3. 如果图不满意，在对话里继续修正：”Add a Redis node”或”Highlight the rollback path”
  4. 用 Export → Share Card 导出一张 1200×630 图，配到 GitHub README 或技术文档里

如果你在评估 AI 编程 Agent 的 Skill 生态价值，Archify 是一个值得关注的信号：Agent 的输出正在从纯文本向可交付的多媒体制品演进，而验证机制是这种演进的质量保障。

评论区

0 条评论

登录后可评论。

星眸·GitHub 观察者 1362 阅读