架构图生成器 tt-a1i/archify

把你想理解、规划或分享的事，变成可以互动的可视化作品。

官方入口： archify.si · GitHubArchify 开源免费。第三方提供的在线服务、收费套餐由其运营方负责，不代表 Archify 官方。 查看详细说明 →

从一个想法、一个问题或一份计划开始。把它描述给 AI Agent，Archify 就能生成可以探索、修改和分享的交互式 HTML。从旅行行程、知识地图到复杂系统，你都可以继续扩展，做成自己需要的样子。

看看社区正在创造什么，也想想你还能用它做些什么。

交互演示 · 开始使用 · 场景指南 · 社区交流 · English · 日本語 ·

❤️ 合作与赞助伙伴：Kimi Work · Supercode · OpenLux

看看 Archify 能做什么

https://github.com/user-attachments/assets/88cff7dd-bdf3-4b97-950c-37cc079898b1

一句话，看懂你的项目。 35 秒演示：探索交互图、查看源码关联、追踪完整路径。试试可交互示例 ↗

安装，然后说出你的想法

支持 Cursor、Claude Code、Codex CLI 和 OpenCode；更多接入方式见下方安装选项。

Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt

把这句话发给你的 Agent：

用 Archify 画出一个网站的请求流程：浏览器请求 API， API 优先读取 Redis，缓存未命中时查询 PostgreSQL 并回填缓存。

继续说：“添加鉴权步骤”“突出缓存未命中的路径”“切换浅色主题”。

不需要绑定代码库：从描述开始即可。也可以让 Agent 阅读仓库，生成有源码依据的架构图。

按 Agent 选择安装方式 · 安装细节与更新检查 · 用 Agent 画图并检查结果

问一个问题，得到一页讲清楚的答案

不是每个答案都是一张图。让 agent 用一页来回答，Archify 会生成一份 explainer：先给结论，再按问题分成几个面板，用表格、步骤、图表、代码和经过校验的图把理由讲清楚。

一页式解答：结论在前，步骤和它讲解的流程图左右并排

- 结论先行。 先写答案和理由，每个面板只回答一个问题。
- 图和文字一起讲。 步骤放在它讲解的图旁边，读到哪一步，图上就亮起哪一部分；点任意节点进入完整的交互图。
- 能核对。 结论标注编号来源；仓库代码固定到具体提交，悬停即可看到原文。
- 好分享。 一个 HTML 文件，四种样式，浅色深色都有；可导出 PNG、WebP、JPG 长图或打印成 PDF。对任何面板都能追问，生成的追问让 agent 只改这一块。

用 Archify 一页回答：接口 P99 从 80 ms 涨到 600 ms，平均值几乎没变，可能是什么原因，应该怎么排查？

在线示例：P99 延迟排查 · 读 Archify 仓库：finalize 怎么保住旧产物 · 第一次租房要确认什么 · 第一次打开 HTTPS 网站（英文）

❤️ 赞助伙伴

Archify × Kimi Work。 在 Kimi Work 插件商店搜索 「可交互架构图」，用一句话描述你的系统，即可生成可交互的图。在 Kimi Work 中使用 →

supercode.sh
Supercode 赞助 Archify，通过 Token 优化、精选 Skills 和规范驱动开发增强 Codex 与 Cursor。Archify 已入选 Supercode Editor’s Choice 技能。

OpenLux
感谢 OpenLux 对本项目的赞助！OpenLux 是一个面向企业的一站式 AI 聚合平台，汇集全球各大厂商主流大模型，平台提供高效、稳定的服务与及时的技术支持。Claude、OpenAI、Gemini 系列模型基准折扣分别低至官方的 0.882 折、0.4 折和 0.8 折。Archify 用户还可享受专属福利：通过专属链接注册，充值最高可享 7.5% 优惠！立即体验 →

PackyCode
PackyCode 提供统一域名、统一密钥和智能容灾切换，一句话接入主流大模型，提供专属 Codex / Claude Code 高速通道。新用户可获 $1 免费体验额度，首充享折扣，多分组折扣低至 2 折起。支持人民币 1:1 充值，无汇率加价或额外充值手续费。立即体验 PackyCode →

AICodeMirror
感谢 AICodeMirror 赞助 Archify！AICodeMirror 提供 Claude / Codex / Gemini API 中转服务，支持企业级高并发、开票和 7×24 技术支持。Codex 通道低至基准价格 0.7 折，充值还有额外优惠。Archify 专属福利：通过专属链接注册，可享首充 8 折。立即体验 AICodeMirror →

Infistar.cc 无限星河感谢 Infistar.cc 无限星河赞助 Archify！一个 API Key 覆盖文案、图片与视频创作，支持 GPT、Claude、Gemini、DeepSeek、通义千问、可灵等主流模型，无需分组。大模型低至官方 0.1 折，AI 生图低至 ¥0.06/张。Archify 专属福利：通过专属链接注册即送 $5 体验额度，并享首充特惠。立即体验 Infistar →

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

用图把事情讲明白

| 讲清 Agent 如何调用工具 | 跟随一次缓存回源请求 | 看清服务与数据库的关系 |
| Agent 工作流中 Planner 驱动的全部下游 | 缓存未命中时从 Web App 到 Postgres 的路径 | 生产架构中后端与数据库角色的真实关系 |
| 追踪一个步骤影响到的全部下游。 | 点亮 Web App 到数据库的路径。 | 聚焦后端与数据库之间已定义的连接。 |

Proof Lab 收录全部 11 个仓库内场景、JSON 源和校验回执。

看懂一个真实代码仓库

CODE → DIAGRAM · 有源码依据的系统地图

根据公开仓库 mco-org/mco 生成的 MCO 运行时架构图

Archify 追踪 mco-org/mco 的 9f1a1cf 版本并生成这张校验地图。打开成品 ↗ · 追踪下游 ↗ · Typed Source

易于扩展，社区还在不断创造新用法

COMMUNITY STORIES · 社区用户提供的部分案例

生成之后，还可以继续创造。 Archify 开源，成品是独立 HTML，你可以让 Agent 在此基础上继续修改、接入链接、扩展交互，做出适合自己场景的作品。社区已经把它用到了团队协作、旅行规划、法律核验、合同审查和故障复盘；下面只是其中一部分。

一位用户从纸上手绘的多智能体架构开始，让 Agent 生成交互图，再通过对话加入 Kimi 执行池。另一些用户让 Agent 阅读项目，把生成的架构图带进飞书或钉钉，继续和团队讨论。

还有用户把上海 CityWalk 攻略整理成了四天行程图：按天切换路线，点击节点查看地点信息，并跳转高德地图、小红书和大众点评。作者还扩展了到达打卡和停留记录，让一张路线图变成旅途中可以实际使用的小工具。这些扩展由社区作者为该作品添加。

▶ 点击体验上海 CityWalk 交互版

社区用户创作的上海 CityWalk 四天行程图

▶ 点击体验交互版 · 切换 D1–D4 行程，点击地点查看详情。

社区作品 · 上海 CityWalk · 四天行程与地点链接

下载下来，亲手点一点

成品是一个独立的 HTML 文件。下载后用浏览器打开，即可使用该作品包含的节点详情和路径探索，无需安装 Archify。把 HTML 文件发给别人，交互也会一起保留；外部网站和地图链接需要网络。

打开上海 CityWalk 交互版 ↗ · 下载 HTML ↓

试试切换 D1–D4、点击地点卡片，或打开地图链接。行程中的时间和地点信息为作者创作时的记录。

社区与关注

- GitHub Trending 全球仓库周榜第一。 作者于 2026 年 9 月 1 日发布的榜单截图，筛选为所有语言、This week。
- 量子位报道与人物采访。 项目报道 · 开发者故事。
- 开发者社区推荐。 midudev 分享。

这里选列部分公开报道、分享与历史里程碑；排名日期及来源见链接。

预览

深浅主题、导出菜单与分享卡片

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

| 深色 | 浅色 |
| 深色主题 | 浅色主题 |

Export 菜单支持复制 PNG，并下载静态或动态格式：

导出菜单

路径解析后，Export → Route Share Card 会把真实路径下载为 1200×630 PNG，并保留完整拓扑上下文。

Route Share Card：突出 Users 到 API Server 的精确路径，同时保留完整架构作为上下文

完成 authored Upstream 或 Downstream reach 后，Export → Reach Share Card 会捕获这次阅读结果，但不冒充运行时影响分析。

MCO downstream Reach Share Card：展示从 Command Router 出发的已创作关系

在本地打开 examples/web-app.html，即可体验完整 Viewer。

快速开始

当前稳定版本： v3.2.0。详见版本历史。

1. 安装

Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt

更多安装方式与更新检查说明

显式、非交互地安装到 Cursor：

npx -y skills@latest add https://archify.si --skill archify --agent cursor --global --copy --yes

如果只想临时体验：

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

DeepSeek Harness（社区集成、显式启用）：运行 dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0；参见兼容范围、限制与安全说明。Agent 切换器只为 cursor、codex、claude-code 和 opencode 生成命令。

安装后的 Skill 包含一个低频、失败静默的发布检查，它最多只显示可选更新提醒，绝不会自行下载或安装更新。一次成功检查后，下次网络请求通常约在 24 小时（±20%）后发出；检查失败后，活跃使用可能在首次 6 小时、后续 24 小时退避到期时重试。请求只访问 https://archify.si/skill-updates/archify/stable.json。服务端会自然获得 IP、请求时间和常规 HTTP 元数据；检查器不会发送本地版本、Agent、项目数据、用户输入、账户/设备标识，也不会保存或回传 ETag。是否更新以及何时更新始终由你决定。如需完全关闭检查（包括网络请求和提醒状态写入），请在 Agent 环境中设置 ARCHIFY_UPDATE_CHECK_DISABLED=1。

获取更新

- 订阅新版本： 在本 GitHub 仓库顶部选择 Watch → Custom → Releases，订阅版本发布通知。点 Star 不会自动订阅更新。
- 查看更新内容： 版本说明。
- 使用 RSS 阅读器： 订阅版本更新源。

带有更新检查器的安装版本，也会在交付图时检查新的稳定版，并可显示提醒。不带检查器的旧安装需要先手动更新，才能获得这项功能。是否升级、何时升级由你决定，Archify 不会自动安装更新。

2. 直接从描述开始——不需要代码库

用 Archify 画出：Browser -> API -> Redis 缓存 -> PostgreSQL 回源。

需要源码证据时，打开仓库后改用：

分析这个仓库，然后使用 archify 生成一张高层运行时架构图。
只保留 8–12 个核心组件，突出一条主要路径，并标出外部依赖与信任边界。
辅助信息放进说明卡片，不要继续增加连线。

3. 在对话中细调

继续说：增加 Redis、把鉴权移到左侧、突出回滚路径。Archify 会保留 Typed Source，只修改相关部分。

选择合适的图表

十种图表、架构差异对比与示例

| 类型 | 最适合 | Prompt 中应包含 |
| Architecture | 组件、服务、存储和系统边界 | 范围、核心组件、主要路径 |
| Workflow | CI/CD、审批、工具调用、Runbook | 参与者、顺序、分支、异常 |
| Sequence | API 调用、缓存回源、鉴权、异步链路 | 调用方、被调用方、返回、时序 |
| Data Flow | 数据管线、血缘、PII、下游消费者 | 来源、转换、存储、边界 |
| Lifecycle | 状态、重试、等待、终态 | 状态、事件、重试与取消路径 |
| ERD | 数据库结构：表、字段、键、基数关系 | 表、每个字段及类型、主键/外键/唯一键、关系基数 |
| Class | 类、接口、关键成员与类型关系 | 类型、关键成员、继承与接口实现、组合与依赖 |
| Tree | 单一父级的层级结构：仓库、模块、能力拆解 | 根节点、层级、各分支包含的内容 |
| Timeline | 何时发生了什么：故障复盘、发布历史 | 带时区的时间点、事件、来源泳道，以及时间是真实观测还是示意 |
| Waterfall | 一次请求或 Agent 运行的耗时分布 | Span、开始时间与时长、嵌套关系，以及耗时是实测还是示意 |

做生产部署评审时，Architecture 可以按需启用 deployment-ownership 工程画像：负责人、单一区域归属、数据库私有边界或边界穿越机制缺失时会直接阻断。
它不会被静默开启，只校验作者写入的事实，不代表线上基础设施已经核验。可查看通过校验的部署证明。

做设计或 PR 评审时，Architecture Delta 生成已校验的 Before / Delta / After 和机器回执。精确选择任一作者变更，或播放一次有限 Review；全程只读，不推断影响、风险或合并安全。

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

Architecture Delta：展示作者明确写出的新增、删除、变化和移动

不知道选哪一种？打开交互式场景指南，或直接询问零依赖 CLI：

node archify/bin/archify.mjs guide "展示带 Redis 缓存未命中的 API 请求"
node archify/bin/archify.mjs guide "梳理 Kafka Topic、消费者组、重放和死信队列" --json

Workflow 用泳道保持主路径清晰：

Workflow 示例

Sequence 解释一次交互随时间如何推进：

Sequence 示例

Data Flow 突出数据移动和敏感边界：

Data Flow 示例

Lifecycle 区分正常进展、等待、重试和终态：

Lifecycle 示例

3.1 新增 ERD、Class、Tree、Timeline 和 Waterfall。

ERD 把表、每个字段与键，以及关系基数放在一起：

ERD 示例：订单管理库，customer、order、payment、inventory、product 和 order_item 表按业务域分组

Class 展示接口契约、关键成员，以及哪些类型依赖或实现它们：

Class 示例：OrderService 依赖 PaymentGateway 接口，由银行卡和钱包网关实现

Tree 展示单一父级的包含关系，例如能力拆解：

Tree 示例：支付平台拆解为订单、支付和运营能力

Timeline 把事件放在同一条按比例的时间轴上，每个来源一条泳道：

Timeline 示例：一次示意性的支付故障，发布、监控和响应事件位于同一时间轴

Waterfall 展示嵌套、重叠的 Span 中时间花在了哪里：

Waterfall 示例：一次结账请求的示意耗时，库存查询与折扣计算并发执行

打开这些示例：ERD · Class · Tree · Timeline · Waterfall。其中 Timeline 和 Waterfall 示例使用示意数据；只有来自日志或链路追踪的时间和耗时，才能当作真实数据。

Architecture 示例：Web App · Archify Pipeline · Grid 布局 · 桌面 Agent

为什么用 Archify

| 读懂结构 | 边看边讲 |
| 从代码或描述出发，整理关键组件、流程和关系。 | 点击节点、追踪路径、把任意视图分享成链接。 |
| 易于扩展 | 方便交付 |
| 保留可编辑源文件，也可基于开源代码和 HTML 成品扩展自己的交互与用途。 | 分享独立 HTML，或导出图片、视频与分享卡片。 |

这些体验背后的工程能力

- 用布局判断代替通用自动布局 —— Agent 根据故事选择层级、留白、线路和强调关系；共享的自动端点会确定性展开，不再让多支箭头堆在同一个中点。
- Typed JSON IR —— 每种 Renderer 模式都有 Schema 和可复现的源文件。
- 原子交付前校验 —— Schema、布局、HTML/SVG、线路和标签到其他路径的净空检查必须全部通过，Showcase 成品才会替换上一份可信结果。
- 失败也有结构化修复回执 —— validate --json 和 deliver --json 会返回稳定规则码、准确对象、测量证据和真正支持的修复旋钮，不再让 Agent 从 Node 堆栈或自由文本里猜。
- 保留最后好图的实时预览 —— 可选桌面循环只监听一个 JSON；只有最新候选通过全部门禁才刷新，半写入或无效保存时继续显示上一份验证成品。
- 交互不编造拓扑 —— 聚焦、上下游可达范围、精确路径、角色对比和故事都复用作者定义的节点与关系，也不把图上可达误报成真实运行时影响。
- 只在需要时附源码证据 —— 有证据的 Architecture 节点会显示 SRC n，并可打开由 Git 校验、固定到公开 commit 的文件与行号；普通成品不携带源码信息。
- 结果默认便携 —— 一个 HTML 文件即可分享；导出永远是完整原图，不携带临时 Viewer 状态。

Archify 不是通用绘图编辑器，也不是 Mermaid 主题；它负责把技术意图变成可交流的成品。

工作原理

生成、校验、预览与交付的技术细节

| 步骤 | 发生什么 |
| 生成 | Agent 根据描述创建 Typed JSON IR。 |
| 校验 | 内置 Validator 和布局规则检查源文件；失败时用机器可读 JSON 指出准确的局部修复。 |
| 预览（可选） | 仅 loopback 的桌面会话监听一个源文件，只刷新验证版本；失败时保留最后好图。 |
| 交付 | 在目标同目录生成并检查候选；只有通过门禁的结果才原子替换目标文件，随后可选用 --open 打开这个确切成品。 |
| 迭代 | Agent 修改源文件，不干扰无关结构。 |

仓库常用命令：

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "展示 CI/CD 检查、审批、部署和回滚"
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 不会携带 Preview Runtime。

deliver --open 适合一次性的本地交互交付。它默认关闭，并且只在验证成品原子提交后执行；系统无法打开时，交付仍保持成功，JSON 只写 stdout，stderr 会给出可手动打开的绝对路径。

失败时，validate --json 和 deliver --json 仍然只输出一个 JSON 对象。读取 diagnostics[]，只修改其中 subject 指向的对象，并使用 supportedFixes 列出的修复方式；不要整图重写，也不要突破 Skill 最多两轮的聚焦修复上限。确定性诊断仍不等于视觉复核。

动态和演示样式需要显式选择：

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

不设置 animation 时结果完全静态；classic 始终是默认视觉预设。设计评审、发布说明和技术文档可以显式选择 editorial，获得暖纸张与深墨色的编辑风格，同时保持几何完全不变。将 meta.locale 设为任意合法语言标签，可选择 、默认图例、无障碍文案和所有固定 Viewer UI。en、zh-CN、zh-TW、es、ko 与 ar 已内置，只需设置 meta.locale；meta.translations（规范消息键到译文字符串的映射）可逐键覆盖，其余文案保持所选语言。其他语言需在该字段中提供完整目录（参见 archify/examples/locales/），否则渲染器回退为英文并在 stderr 中说明。作者编写的标题、节点、关系和卡片不会被机器翻译。未带该字段的旧文件仍然有效，并默认使用英文。对于既未内置也未提供 meta.translations 的创作语言，应省略 meta.locale、保持 authored content 使用用户要求的语言，并主动告知用户固定 Viewer UI 与 回退为英文，因此该成品不属于完整本地化。

探索与分享

| 操作 | 控制方式 |
| 打开事实型 Diagram Guide | ? |
| 查找并聚焦语义节点 | / |
| 追踪作者定义的上游 / 下游可达范围 | 聚焦节点 → Upstream / Downstream |
| 探查有向路径并逐站检查 | R 或“路径” |
| 对比一种或两种语义角色 | L 或“透镜” |
| 打开实时全局雷达 | M 或“地图” |
| 进入 Presentation Stage | F |
| 选择视觉风格（S 循环）/ 切换主题 / 打开 Export | S / T / E |
| 缩放或复位 | + / - / 0 |

稳定链接可以恢复 #focus=<id>、#focus=<id>&reach=upstream|downstream、#relation=<id>、#route=~<target> 和 #lens=<kind>~<kind>。动态模式持续播放连线流动，直到读者暂停；语义预览仍有限运行。动效遵守 prefers-reduced-motion，并且不会进入标准导出。

完整生成与 Viewer 契约请查看 archify/SKILL.md。

安装方式

| 使用位置 | 安装位置或方法 | 能力 |
| Claude Code | ~/.claude/skills/ 或 .claude/skills/ | 完整 Renderer + Validation 工作流 |
| Codex CLI | ~/.agents/skills/ 或 .agents/skills/ | 完整 Renderer + Validation 工作流 |
| opencode | ~/.config/opencode/skills/、.opencode/skills/ 或 .agents/skills/ | 完整 Renderer + Validation 工作流 |
| Claude.ai | Settings → Capabilities → Skills 中上传 archify.zip | 取决于沙箱是否提供 Node.js |
| Project Knowledge | 把 archify.zip 上传到项目 | Prompt 驱动的 Architecture Fallback |
| Hermes Agent | 显式启用：hermes skills install skills-sh/tt-a1i/archify/archify -y | 社区 Skill-only；Node >=18；不是 Nous 官方产品。没有遥测。非切换器目标。详情。 |
| DeepSeek Harness | 显式启用：dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0；调用：Use the archify skill to map this repository's runtime architecture.；卸载：dsh plugin --profile web remove @tt-a1i/archify-dsh。 | 面向开发者预览版 @deepseek-ai/dsh@0.1.2-rc.1 的社区集成；Node ^22.19.0 \|\| >=24.0.0；不是 DeepSeek 官方产品。没有遥测；shell 文件不会自动进入 Web Produced Files，请返回精确工作区路径。详情。 |

参考与边界

- Schema 说明
- Skill 与 Renderer 契约
- 示例
- Agent 编图手册 · English
- 版本历史
- 路线图
- 自动生成的 Proof Lab

自动 Mermaid Parser、通用自动布局、托管分享服务和 WYSIWYG 编辑器目前都不在产品范围内。

社区交流

👋 欢迎加入 Archify 社区！

与其他用户和开发者交流、分享想法、提出功能建议、报告问题、讨论开发，并一起让 Archify 变得更好。

- 加入 Discord
- 微信群：扫描下方二维码。微信群二维码会定期失效；如二维码已过期，请通过 Discord 或 QQ 联系管理员获取最新二维码。
- QQ 群：1121948602

微信群 QQ 群

官方入口与第三方服务

- 开源项目： 当前源码及由其构建的安装包可按 Apache-2.0 协议使用；历史发行版保留原有许可。
- 官方网站： archify.si 目前提供项目介绍、示例和安装指引。
- 第三方服务： 是否收费、如何处理数据、提供什么支持，由第三方运营方决定。名称或域名相似不代表官方合作。

License

Apache-2.0 —— 可以自由使用、修改和分发。

历史 MIT 授权继续有效，见 NOTICE 和 LICENSE-MIT。第三方组件保留各自许可；软件许可不改变用户原创内容的权属，也不授予一般性的 Archify 商标使用权。

参与贡献

基于 Archify 做了独立包？提交到社区目录。详细步骤和 JSON 示例默认折叠，按需展开即可。

欢迎提交 Issue、Pull Request 和真实场景图。请先阅读贡献指南；遇到问题时使用可复现 Bug 表单，也可以通过社区 Showcase 表单提交已验证成品。

较大的功能或行为调整请先通过 Issue 对齐价值、兼容边界和非目标，再基于最新 main 开发。一个 PR 尽量只解决一个问题；核心代码和回归测试先行，生成物最后统一重建。Archify 坚持 Agent-first，优先完善稳定的机器可读诊断和现有权威合同，避免新增容易与 CLI 漂移的重复说明。 · LINUX DO

支持 Archify

如果 Archify 对你有帮助，欢迎支持项目的持续开发。谢谢你让这个项目继续走下去 ❤️

通过微信赞赏支持

使用微信扫描下方二维码，或保存图片后在微信中识别。

通过支付宝赞赏支持

使用支付宝扫描下方二维码，或保存图片后在支付宝中识别。

使用、分享、反馈问题和贡献改进，也都是对项目的支持。

贡献者

感谢每一位参与构建 Archify 的人。欢迎关注他们。 ❤️

Star History