Archify 是什么：Agent 画出可交互架构图

Archify 是开源 Agent Skill：你用自然语言描述系统、流程或问题，Agent 写出带类型校验的 JSON（或一页讲解稿），再渲染成可交互、自包含的 HTML。截至 2026-10-30（北京时间），稳定版是 v3.2.0，许可证 Apache-2.0；GitHub 约 9.2 万星。

它是什么

Archify 不是通用画图板，也不是 Mermaid 换皮。Agent 按 Skill 约定写出类型化中间表示（typed JSON IR），本地 CLI（archify/bin/archify.mjs）负责校验并交付。官网与 README 把它定位成：把想法、计划和代码库证据，变成可探索、可分享的可视化产物。也支持把回答做成一页讲解：结论与理由在前，后面按问题分面板，可夹表格、步骤、图表和已校验的图。

解决什么问题

口头讲架构、贴一张静态截图，或让模型随手画 Mermaid，常见问题是：节点对不上源码、布局乱、改一处牵全身、别人打开还要装工具。Archify 把「画什么」收成可校验的源文件，把「交出去什么」收成一个 HTML：点节点看卡片、追上游/下游、高亮一条路径，导出分享卡或长图。仓库侧可要求 Agent 读仓库证据，节点标 SRC n 并钉到某次 commit 的文件行号。

官方说法：校验检查的是「写成的产物」，不替你担保每条业务断言或线上系统行为都正确。

怎么用

官方 README 与站点 quick start：

# 全局安装（skills CLI）
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 diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.

# 或从仓库证据画运行时架构
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.

# 做成一页讲解
Use Archify to answer as one page: our API's P99 went from 80 ms to 600 ms
while the mean barely moved. What is the likely cause, and how should we investigate?

Skill 约定交付走 finalize（或分步的 validate / deliver / check）：同目录候选渲染通过后原子替换目标文件。可选 ARCHIFY_UPDATE_CHECK_DISABLED=1 关掉更新提醒联网；提醒只读固定稳定清单，不会自动下载安装。

用法要点

十种图类型与适用场景写在 SKILL.md 的 Type router：Architecture（部件与边界）、Workflow（跨泳道步骤）、Sequence（调用顺序）、Data Flow（数据去向）、Lifecycle（状态与重试）、ERD（表/列/键/基数）、Class（类型与契约）、Tree（单亲层级）、Timeline（按时间的事件）、Waterfall（嵌套耗时）。拿不准时可用 node archify/bin/archify.mjs guide "场景描述" --json。

v3.1 起增加 ERD / Class / Tree / Timeline / Waterfall；v3.2.0 是当前稳定标签。查看器支持深浅色、演示模式、路径/镜头聚焦；导出含 PNG、JPEG、WebP、SVG、WebM 等（具体项以浏览器里 Export 菜单为准）。官网 Proof Lab 放了校验过的示例与 JSON 源。

和本站已有图相关内容的差别：Archify 侧重Agent 驱动、校验后交付的交互 HTML；知识图谱类工具（如 Graphify）更偏代码结构检索。通用安装仍可用 npx skills；装第三方 Skill 前也可先过 SkillSpector。

适合谁，不适合谁

适合：要用 Coding Agent 把架构/时序/事故时间线讲清楚、并随 HTML 发给同事的人；需要从仓库证据生成可钉 commit 的系统图的人；想把诊断结论做成一页讲解、再按面板改稿的人。

不适合：要找托管协作白板、WYSIWYG 拖拽编辑器，或指望自动解析任意 Mermaid 样式的人——官方把这些划在范围外。也不适合当实时监控大盘：SKILL.md 写明 Not for dashboards。

最后：先 npx skills add tt-a1i/archify -g，用一句缓存未命中时序或「answer as one page」小问题试交付；打开生成的 HTML，用路径聚焦和导出确认是否够用，再接到真实仓库证据流程。