GitHub 趋势 · 第 4 期
别再贴 Mermaid 源码了：这个 Agent 技能把架构图画成了会动的网页
#AI编码#Agent技能#架构可视化#开源工具
一句话判断：如果你的团队还在用 Mermaid 文本手写架构图、或在评审会上对着一张静态 PNG 比划，archify 值得今天花十分钟试一下——它把「代码库 / 系统描述」直接变成可在聊天里交互、可导出、可审阅的网页地图。
你有没有过这种时刻：PR 里贴了一段 200 行的 Mermaid，评审的人根本懒得展开；或者你花一下午画的架构图，三个月后和代码对不上了，没人敢动。静态图最大的问题是——它不会说话，也不会自己验证。
项目是什么
archify 是一个 Agent 技能（skill），官方一句话定位是 「Turn a codebase or system description into a polished, interactive system map — directly in chat.」 它支持 Cursor、Codex、Claude Code、OpenCode 等主流 Agent，也能完全脱离 Agent 走命令行。它输出的不是图片文件，而是自包含 HTML——可点击、带动效、可导出 crisp 的静态版本，覆盖架构图、工作流图、时序图、数据流图和生命周期图五种类型。
核心能力
| 能力 | 说明 |
|---|---|
| 多图类型 | architecture / workflow / sequence / data-flow / lifecycle |
| 自包含 HTML + 动效 | 可交互，尊重 prefers-reduced-motion，导出物则为静态 crisp 版 |
| 证据锚点 | 节点标记 SRC n，可跳转 Git 校验过的文件与行号（钉死单一 commit） |
| 对比评审 | compare 命令生成架构 delta 的 viewer-only Review，不臆测影响与风险 |
| 部署归属档案 | deployment-ownership 缺字段时 fail closed，绝不隐式推断 |
| 隐私 | 更新检查只 GET 固定 manifest，不上传版本 / Agent / 项目数据 |
上手：命令全部来自 README 原文
全局安装（Claude Code / Codex / Cursor / OpenCode 通用）：
npx skills add tt-a1i/archify -g # 非交互式安装到 Cursor npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes # 不安装直接试（Codex） npx skills use tt-a1i/archify@archify --agent codex
在 Agent 对话里直接描述意图：
Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback. Analyze this repository, then use archify to create a high-level runtime architecture diagram. Show 8-12 core components, one primary path, external dependencies, and trust boundaries.
脱离 Agent 也能用命令行：
node archify/bin/archify.mjs guide "Show an API request with Redis cache miss" node archify/bin/archify.mjs doctor node archify/bin/archify.mjs demo /tmp/archify-demo node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json
我的判断：谁该用、谁别碰、坑在哪
适合谁：常写架构文档、技术评审、Onboarding 材料的工程师、技术 Lead 和开源作者——它把「画图」这件事从手工劳动变成了对话。
不适合谁：想要「通用绘图编辑器」或「Mermaid 主题」的人。archify 明确声明：自动 Mermaid 解析、通用自动布局、托管分享、WYSIWYG 编辑都不在当前范围。它不是 Excalidraw 的替代品。
几个坑：① 依赖沙箱里的 Node.js 访问（Claude.ai 场景会受限）；② deployment-ownership 档案在缺 owner / region / scope / 命名穿越时 fail closed，要自己补齐；③ 渲染动效不进导出物，正式交付是静态 crisp 版——别拿动效截图当最终件。
仓库地址：github.com/tt-a1i/archify
本周新增：+13,318 ★（GitHub Trending weekly，抓取快照）
开源许可：MIT（可自由使用、修改、分发）
抓取时间：2026-09-09 18:37 (GMT+8)
你在用什么画架构图？Mermaid、Excalidraw，还是直接丢给 Agent？评论区聊聊你的工作流。下期我会盯一个「让 Agent 像最懒的高级工程师一样思考」的项目——它已经冲上榜单，本周 +7,102 ★。
#AI编码#Agent技能#架构可视化#开源工具