English · 简体中文

Archify

将代码库或系统描述变成精美的交互式系统地图——直接在聊天中完成。

Archify 是面向 Raven、Cursor、Claude Code、Codex CLI 和 OpenCode 的代理技能。输入系统描述或仓库，即可获得可交互、可分享的技术地图。

• 打开即展示 — 五种图表类型、四种预设、深/浅主题、内置品牌标识和有限动效
• 合并前审查架构变更 — 以“变更前 / 变更后 / 差异”的方式对比两个已验证快照，精确显示新增、删除、修改、移动和重新路由的事实
• 每次交互都有据可依 — 搜索节点、可选打开经修订验证的源码、追踪上游/下游编写可达性与精确路径、对比角色、播放引导故事而不虚构拓扑
• 一个文件，可信且可分享 — 类型化 JSON IR 和确定性检查生成自包含 HTML，以及 PNG、SVG、WebM 和 1200×630 分享卡片

当前开发版本： v2.16.0-dev.0。参见 Changelog。

项目页面 · 场景指南 · 验证实验室

npx skills add tt-a1i/archify -g

使用 Cursor？打开代理感知快速入门以获取精确的全局和项目命令。

然后向代理提问：Use archify to map this repository's runtime architecture.

❤️ 赞助商

APINEBULA	APINEBULA 以统一 API 赞助 Archify，支持 Claude、GPT、Gemini 等。通过 Archify 注册并使用 Archify 可享 9 折。
EverMind · Raven	EverMind 赞助 Archify，并为代理构建记忆基础设施。其 Raven 支持将 Archify 作为技能用于验证过的交互式系统地图。

想赞助 Archify？通过邮件联系我们。

观看 Archify 的实际效果

这些是 Archify 生成的制品，不是产品模型。点击任一帧即可打开其实时、可分享的状态。

_{三个真实生成的制品。 Signal Flow · Blueprint · Classic · 打开交互式验证实验室 ↗}

引导故事	路径探测	语义视角
播放一个有限的命名章节。	检查最短的编写有向路径。	比较语义角色间的真实流量。

验证实验室包含全部 11 个已检查场景、其 JSON 源、命名视图和验证凭证。

一个真实仓库，从源码映射

Archify 在提交 9f1a1cf 处追踪了 mco-org/mco，并生成了这张已验证地图。打开它 ↗ · 追踪可达性 ↗ · 类型化源

预览

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

深色	浅色

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

当需要为 README、发布或社交媒体帖获取标准的 1200×630 图片时，使用 复制分享卡片。

追踪路径后，导出 → 路径分享卡片 会将该条编写路径下载为 1200×630 的 PNG，并保留完整图表作为上下文。

追踪编写的 Upstream 或 Downstream 可达性后，导出 → 可达性分享卡片 会捕获该精确读数，而不断言运行时影响。

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

快速开始

1. 安装

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

代理切换器覆盖 cursor、codex、claude-code 和 opencode。对于 Raven 的手动 ZIP 安装，将 archify.zip 解压到 ~/.raven/workspace/skills；它会生成 ~/.raven/workspace/skills/archify。Raven 不是切换器目标。

2. 提出一个有限范围的请求

分析此仓库，然后使用 archify 创建高级运行时架构图。
展示 8–12 个核心组件、一条主路径、外部依赖和信任边界。
将支持细节放在卡片中，而不是添加更多边。

对于聚焦的流程：

使用 archify 绘制此登录流程：Browser -> Web App -> API -> JWT 验证 ->
Redis 会话查找 -> PostgreSQL 回退。将缓存未命中路径设为次要。

3. 在聊天中细化

继续提出聚焦请求，例如 add Redis、move auth to the left 或 highlight the rollback path。Archify 会保留类型化源，以便进行有针对性的迭代。

选择正确的图表类型

对于生产部署审查，架构图可选用 deployment-ownership 工程配置。当缺少所有者、单区域部署、私有数据库范围或指定边界穿越时，它会自动失败关闭。它绝不会静默启用，并且验证的是编写事实——而非实时基础设施。参见已验证的部署证明。

对于设计或 PR 审查，架构差异模式会以机器凭证比较验证过的 Before / Delta / After 快照。选择一项精确的编写更改，或播放一个有限的 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

工作流可在泳道中保持主路径清晰：

时序图解释一段时间内的交互：

数据流图使流动和敏感边界明确：

生命周期图区分进度、等待、重试和终止结果：

架构图示例： web-app · Archify 管道 · 网格布局 · 桌面代理

为什么选择 Archify

• 布局判断优于通用自动布局 — 代理选择层次、间距、路径和强调；共享自动端点确定性展开，而不是将箭头堆积在一个中点上。
• 类型化 JSON IR — 每个基于渲染器的模式都有模式和可复现的源。
• 交付前原子化验证 — schema、布局、HTML/SVG、路径和标签到路径的间隙检查都必须通过，然后展示制品才会替换上一个已知良好的输出。
• 失败附带修复凭证 — validate --json 和 deliver --json 返回稳定的规则代码、精确主体、测量证据和仅受支持的修复控件，而不是 Node 堆栈或非结构化的重试猜测。
• 最后一版良好实时预览 — 可选的桌面循环监视一个 JSON 文件，仅当最新候选通过所有门后才刷新，并在保存不完整或无效时保留先前已验证的图表可见。
• 真实交互 — 焦点、上游/下游可达性、精确路径、角色比较和故事复用已编写的节点和关系，而不是虚构拓扑或声称运行时影响。
• 仅按需提供源码证据 — 基于证据的架构节点标记自己为 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 停止。对于测试或当你自行打开打印的本地 URL 时，添加 --no-open。它不会给生成的 HTML 增加运行时。

使用 deliver --open 进行一次性交互式本地交接。它默认关闭，仅在已验证制品提交后运行，并且当操作系统打开器不可用时不会将成功交付变成失败；JSON 保持输出到 stdout，绝对手动打开路径输出到 stderr。

失败时，validate --json 和 deliver --json 仍然只输出一个 JSON 对象。阅读 diagnostics[]，仅使用其 supportedFixes 更改指定主体；不要重写整个图表或超过技能的两轮专注修正。确定性诊断与视觉审查保持分离。

设置：

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

meta.locale=en|zh-CN 本地化页面标题、图例、状态/错误、无障碍、HTML/SVG lang——绝不本地化编写内容。否则省略；保留所请求语言的文案；披露英文回退。静态省略 animation；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 参考 · 技能 · 示例 · 代理食谱
• 变更日志
• 路线图
• 生成的验证实验室

自动 Mermaid 解析、通用自动布局、托管分享和所见即所得编辑目前明确不在当前范围内。

许可证

MIT — 可自由使用、修改和分发。

贡献

欢迎提交问题、拉取请求和真实世界图表。从贡献指南开始，使用可复现的错误表单报告失败，或通过社区展示表单提交已验证图表。