Archify: AI编程代理的架构图生成工具

将代码库或系统描述转换为精美的交互式系统图——直接在对话中完成。

Archify 是一个面向 Cursor、Claude Code、Codex CLI 和 OpenCode 的 Node.js 渲染与校验系统。Agent 产出类型化 JSON IR；Archify 以确定性方式将其编译为 HTML/SVG。

打开即可演示——五种图类型、四种预设、明暗主题、内置品牌标识与有限动画

在合并前审查架构变更——将两个已校验的快照对比为「变更前 / 增量 / 变更后」，呈现精确的增、删、改、迁、路由变更

每一次交互都基于事实——搜索节点、可选打开经修订校验的源码、追踪上游/下游的创作者影响范围与精确路由、对比角色、在无需自行推断拓扑的情况下播放引导式故事

一个文件，即可信赖与分享——类型化 JSON IR 与确定性校验产出自包含 HTML 及 PNG、SVG、WebM 和 1200×630 分享卡片

当前开发版本：v2.16.0-dev.0。参见更新日志。

项目主页 · 场景指南 · Proof Lab

npx skills add tt-a1i/archify -g

使用 Cursor？打开面向 agent 的快速入门，获取精确的全局与项目命令。

然后向你的 agent 提问：Use archify to map this repository's runtime architecture.

希望赞助 Archify？请通过电子邮件联系我们。

实际效果演示

以下均为 Archify 自动生成的产物，非产品 mockup。点击任意框体可打开其可分享的实时状态。

三个真实生成的产物。Signal Flow · Blueprint · Classic · 打开交互式 Proof Lab ↗

Proof Lab 包含全部 11 个已入库的场景、其 JSON 源码、命名视图与校验收据。

来自真实仓库的系统图

Archify 追踪了 mco-org/mco 在 9f1a1cf 版本并产出了这张经校验的图。打开它 ↗ · 追踪影响范围 ↗ · 类型化源码

同一张图，两种主题，一键切换：

导出菜单可将 PNG 复制到剪贴板并下载静态或动态格式：

需要为 README、Release 或社交帖子准备规范 1200×630 图片时，使用「复制分享卡片」。

追踪某条路由后，导出 → 路由分享卡片可将那条原创路径下载为 1200×630 PNG，同时保留完整架构图作为上下文。

追踪了原创的上游或下游影响范围后，导出 → 范围分享卡片可捕获精确的阅读视图，而不会声称具有运行时影响。

在本地打开 examples/web-app.html 以体验完整查看器。

安装

npx skills add tt-a1i/archify -g

显式、非交互式的 Cursor 安装方式：

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

无需安装即可试用：

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

DSH 社区用户：dsh plugin --profile web add @tt-a1i/archify-dsh@0.1.0

agent 切换器支持 cursor、codex、claude-code 和 opencode。对于 Raven 的手动 ZIP 安装，将 archify.zip 解压到 ~/.raven/workspace/skills；最终路径为 ~/.raven/workspace/skills/archify。Raven 不是切换器的目标平台。

使用方式

1. 请求一个有限视图

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.
Put supporting detail in cards instead of adding more edges.

Use archify to draw this login flow: Browser -> Web App -> API -> JWT validation ->
Redis session lookup -> PostgreSQL fallback. Keep the cache-miss path secondary.

后续可继续提出聚焦式请求，如添加 Redis、将认证移到左侧、高亮回滚路径等。Archify 会保留类型化源码以支持精准迭代。

选择合适的图类型

对于生产部署审查，Architecture 可选择启用 deployment-ownership 工程配置。当缺少负责人、单区域部署、私有数据库范围或命名边界跨越时，它会失败关闭。它不会静默启用，且只校验原创内容——而非真实基础设施。参见已校验的部署证明。

对于设计或 PR 审查，Architecture Delta 将已校验的变更前/增量/变更后快照与机器收据进行对比。选择一条精确的原创变更，或播放一次有限 Review——仅查看器模式，无影响、无风险、无合并安全推断。

node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json

不确定哪种适合？使用交互式场景指南，或询问零依赖 CLI：

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"
node archify/bin/archify.mjs guide "Map Kafka topics, consumer groups, replay, and DLQ" --json

Workflow 保持跨通道的主路径清晰：

Sequence 描述单一交互随时间的演变：

Data Flow 明确呈现数据流向与敏感边界：

Lifecycle 分离进度、等待、重试与终态：

Architecture 示例：web-app · Archify pipeline · grid placement · desktop agent

核心特性

布局判断优于通用自动布局——agent 选择层级、间距、路由与重点；共享的自动端点以确定性方式展开，而非将箭头堆叠在单一中点。

类型化 JSON IR——每种渲染器支持的模式均有 schema 与可复现的源码。

交付前的原子级校验——schema、布局、HTML/SVG、路由与标签到路由的清除检查必须全部通过，才能用展示级产物替换上一个已知良好输出。

失败附带修复收据——validate --json 和 deliver --json 返回稳定的规则码、精确的主体、实测证据以及仅支持的修复控制，而非 Node 堆栈或非结构化的重试猜测。

上一良好产物实时预览——可选的桌面循环监视一个 JSON 文件，仅在最新候选通过所有检查后才刷新，并在保存不完整或无效时保留先前已校验的图。

诚实的交互——焦点、上游/下游影响范围、精确路由、角色对比与故事均复用原创节点和关系，而非凭空构造拓扑或声称运行时影响。

按需呈现的源码证据——Evidence-backed Architecture 节点自行标记为 SRC n 并打开 Git 校验过的文件与固定到某次公开提交的行列范围；普通产物保持无源码。

默认可移植——结果即一个 HTML 文件；导出保持完整图幅且不含临时查看器状态。

Archify 不是通用绘图编辑器或 Mermaid 主题。它将技术意图转化为沟通产物。

有用的仓库命令

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

preview 是一种显式的桌面创作模式，非默认后台服务：它仅绑定到 127.0.0.1 的随机端口、监视指定的一个 JSON 文件、在失败时保留上次已校验的输出，并可通过 Ctrl-C 停止。添加 --no-open 用于测试或当你将自行打开打印出的本地 URL 时使用。它不会为生成的 HTML 增加任何运行时依赖。

使用 deliver --open 进行一次性交互式本地交付。默认关闭，仅在已校验产物提交后运行，且当 OS 打开器不可用时不会将成功交付转为失败；JSON 保留在 stdout，完整的手动打开路径输出到 stderr。

失败时，validate --json 和 deliver --json 仍精确输出一个 JSON 对象。读取 diagnostics[] 并仅使用其 supportedFixes 修改命名主体；不要重写整张图或超出 Skill 的两轮聚焦纠正。确定性诊断与视觉审查分开处理。

{
  "meta": {
    "locale": "en",
    "animation": "trace",
    "visual_preset": "signal-flow"
  }
}

meta.locale=en|zh-CN 本地化页面标题、图例、状态/错误、可访问性、HTML/SVG lang——而非原创内容。否则请省略；保留请求语言的副本；披露英文降级方案。static 省略动画；classic 为默认值。

探索与分享输出

稳定链接可恢复 #focus=<id>、#focus=<id>&reach=upstream|downstream、#relation=<id>、#route=<source>~<target>、#lens=<kind>~<kind> 和 #view=<view-id>。读者驱动的动画是有限的，遵循 prefers-reduced-motion，且永不进入规范导出。

完整的生成与查看器契约见 archify/SKILL.md。

Schema 参考 · Skill · 示例 · Agent 烹饪书

自动 Mermaid 解析、通用自动布局、托管分享与 WYSIWYG 编辑不在当前范围内。

MIT 协议——可自由使用、修改与分发。

欢迎提交 Issue、Pull Request 和真实世界的架构图。从贡献指南开始，使用可复现的 Bug 表单提交失败信息，或通过社区展示表单提交已校验的图。· LINUX DO