1. 为什么我放弃了手画架构图改用 Cursor Archify如果你维护过一个超过 20 个模块的后端仓库大概经历过这种循环需求评审前夜打开 draw.io 拖了半小时方框连线刚理顺产品说“再加一个 Redis 缓存层鉴权挪到网关左边”。于是你重新挪框、重排箭头改完发现 Mermaid 里那段A -- B的箭头又和别的线打架了。让 AI 直接吐一张 SVG 看着很爽但需求一改整张图就得重画——因为 AI 给你的是一张“死图”没有中间结构改一个节点等于重来一遍。Archify 这个开源项目解决的就是这件事。它是一个 Agent Skill装进 Cursor、Claude Code、Codex CLI 或 OpenCode 之后让 Agent 读你的代码仓库或系统描述先生成一份 Typed JSON IR中间表示再由 Archify 校验布局和关系最后确定性地编译成一份自包含的 HTML 文件。打开就能搜索节点、追踪调用路径、切换主题需要时导出图片。它不提供新模型也没有拖拽画布核心思路是把“画图”拆成“理解 → 结构化 → 编译”三步让迭代只改 JSON 里相关的对象而不是重排整张图。这篇走的是接入配置视角先在 Cursor 里把模型通道换成 TaoToken 的 Key 和 Base URL再装 Archify最后在对话里让它画图。配通之后Cursor 消耗 TaoToken 的额度驱动 Archify你就能在本地拿到可交互的 HTML 架构图。适合已经在用 Cursor、想让 Agent 帮忙维护架构图的开发者也适合想先跑通一条链路再决定要不要深入的人。2. 前置准备TaoToken 的 Key 与 Base URL 怎么拿Archify 本身不绑定模型它靠 Cursor 里的 Agent 来理解代码和生成 JSON IR。所以第一步是把 Cursor 的模型通道配好。我这边用的是 TaoToken 的统一入口一个 Key 可以走 Anthropic 和 OpenAI 两种协议省得在多个平台之间来回切。先到官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台在 API Keys 页面创建一个新 Key。建议按用途命名比如cursor-archify方便后面区分额度消耗。创建完立刻复制页面刷新后就看不到完整 Key 了。Base URL 用这个https://taotoken.net/api注意这里不要加 UTM 参数API 地址保持干净。Cursor 里填的是 Base URL不是完整的 chat completions 路径具体拼接由 Cursor 自己处理。如果你还没想好要用哪个模型可以先在模型对话页面试一下确认 Key 能正常出结果再去配 Cursor。模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite长期用 Cursor 写代码、跑 Agent 的话可以看一下 Coding Plan额度模型和按量计费不太一样适合高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite3. 在 Cursor 里替换模型通道并安装 Archify3.1 配置 Cursor 的模型设置打开 Cursor进入 Settings → Models。在 OpenAI 或 Anthropic 区域把 API Key 换成刚才创建的 TaoToken KeyBase URL 填https://taotoken.net/api。如果你用的是 Anthropic 协议Cursor 里对应的字段是 Anthropic API Key 和自定义 Base URLOpenAI 协议同理。这里有个容易踩的坑Cursor 不同版本对自定义 Base URL 的入口位置不太一样。有的版本在 Models 页面底部有 “Override OpenAI Base URL”有的版本需要开启 “Use custom API endpoint”。找不到的话在设置里搜 “base url” 基本能定位到。配置完成后先在 Cursor 的 Chat 里发一句简单的话比如“回复 ok”确认模型能正常响应。如果报 401多半是 Key 复制时带了空格如果报 404检查 Base URL 是不是多写了/v1或结尾斜杠。3.2 安装 Archify SkillArchify 的安装走 skills 命令。全局安装一条命令npx skills add tt-a1i/archify -g只想临时体验、不写入全局 Skill 目录的话可以指定 agentnpx skills use tt-a1i/archifyarchify --agent codex装完后在 Archify 目录下跑一次自检node bin/archify.mjs doctor这个命令会检查运行环境、依赖和 Skill 注册状态。返回正常就说明装好了。如果提示找不到bin/archify.mjs确认你是在 Archify 的项目根目录执行的而不是在别的路径下。3.3 关键参数对照配置项填写内容说明API KeyTaoToken 控制台创建按用途命名便于区分额度Base URLhttps://taotoken.net/api不加 UTM不加/v1协议Anthropic 或 OpenAI按 Cursor 版本选择对应入口Skill 安装npx skills add tt-a1i/archify -g全局安装所有项目可用自检命令node bin/archify.mjs doctor在 Archify 目录执行4. 验证请求让 Cursor 用 Archify 画一张缓存回源图配置和安装都完成后回到 Cursor 的 Chat直接描述你要的图。比如使用 Archify 画出 Browser - API - Redis - PostgreSQL 的缓存回源过程保留 6 到 8 个核心组件突出一条主要路径标出外部依赖。Agent 会先理解这段描述生成一份 Typed JSON IR然后 Archify 校验这份结构化源文件确认连线没有穿过无关节点、关系标签没有压住其他线路最后编译成 HTML 和 SVG。成功的话你会在项目目录下看到生成的 HTML 文件。用浏览器打开可以搜索节点、点击节点追踪路径、切换主题。如果要求附带源码证据架构节点还能关联到固定 Git Commit 下的文件与行号读图时能回到代码核对。判断接入是否成功看两个信号一是node bin/archify.mjs doctor返回正常二是生成的 HTML 在浏览器里渲染无误、节点可交互。两个都满足说明 Cursor 已经通过 TaoToken 的额度在驱动 Archify 了。如果你想让 Agent 读现有仓库而不是纯描述可以在对话里指定仓库路径让它去读核心组件、主调用链、外部依赖和系统边界。Archify 支持五种图表类型Architecture系统结构、Workflow请求/审批/CI/CD 流程、SequenceAPI 调用链、缓存穿透、Data Flow数据管道/ETL、Lifecycle状态机/订单生命周期。按你要讲的问题选类型出图会更准。5. 本篇常见错排查报 401 UnauthorizedKey 复制不完整或带了空格。重新在控制台复制一次粘贴后检查首尾。如果 Key 被删除或过期也会报 401。报 404 Not FoundBase URL 写错了。确认是https://taotoken.net/api不要加/v1不要加结尾斜杠也不要带 UTM 参数。Cursor 里模型列表为空自定义 Base URL 开启后Cursor 可能不会自动拉取模型列表。手动在模型名称里填你要用的模型 ID或者切回默认通道确认网络正常后再切回来。node bin/archify.mjs doctor报模块找不到确认在 Archify 项目根目录执行且 Node.js 版本符合要求。用node -v看一下版本太低的话升级。生成的 HTML 打开是空白检查浏览器控制台有没有报错。常见原因是 JSON IR 校验没通过但 Agent 没提示回到 Cursor 对话里让 Agent 重新生成或者手动跑一次校验命令看诊断输出。Agent 不调用 Archify确认 Skill 已全局安装且在对话里明确说了“使用 Archify”。有些 Agent 需要显式触发词才会加载 Skill。额度消耗异常快Archify 生成 JSON IR 和校验会消耗 token大仓库分析更明显。可以在 TaoToken 控制台看用量明细必要时换更省的模型或缩小分析范围。6. 配通之后这套组合适合怎么用接入配通只是起点。实际用下来Archify 的价值在“出图之后”需求变了Agent 只改 JSON 里相关的对象不用重排整张图交付前跑固定校验确认连线没穿节点、标签没压线关系能回到 JSON 源文件核对。它省下来的主要是反复改图、重新排图和核对关系的时间。如果你只是临时画一张简单流程图Mermaid 更省事需要盯着画布逐个调元素draw.io 更顺手。但如果你想让 Coding Agent 根据代码仓库起图后面还要反复改、查关系甚至对比一次 PR 前后的架构变化那 Archify 这条路值得配通。需要提醒的是Archify 的校验器检查的是格式、几何和已写入的关系代码分析有没有漏掉组件或调用链它无法证明。涉及真实项目时仍需要熟悉系统的人做最终确认。大单体仓库1000 文件里模型识别准确率会下滑JSON 里的节点命名来自模型理解而非人类共识这些边界心里有数就行。配通过程中如果卡在 Key 或 Base URL 上先去 API Keys 页面确认 Key 状态再对照接入文档检查字段https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite长期用 Cursor 跑 Agent 的话Coding Plan 的额度模型更适合高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteArchify 项目地址https://github.com/tt-a1i/archify Cursor 配 TaoToken：用 Archify 把代码仓库画成可交互架构图
1. 为什么我放弃了手画架构图改用 Cursor Archify如果你维护过一个超过 20 个模块的后端仓库大概经历过这种循环需求评审前夜打开 draw.io 拖了半小时方框连线刚理顺产品说“再加一个 Redis 缓存层鉴权挪到网关左边”。于是你重新挪框、重排箭头改完发现 Mermaid 里那段A -- B的箭头又和别的线打架了。让 AI 直接吐一张 SVG 看着很爽但需求一改整张图就得重画——因为 AI 给你的是一张“死图”没有中间结构改一个节点等于重来一遍。Archify 这个开源项目解决的就是这件事。它是一个 Agent Skill装进 Cursor、Claude Code、Codex CLI 或 OpenCode 之后让 Agent 读你的代码仓库或系统描述先生成一份 Typed JSON IR中间表示再由 Archify 校验布局和关系最后确定性地编译成一份自包含的 HTML 文件。打开就能搜索节点、追踪调用路径、切换主题需要时导出图片。它不提供新模型也没有拖拽画布核心思路是把“画图”拆成“理解 → 结构化 → 编译”三步让迭代只改 JSON 里相关的对象而不是重排整张图。这篇走的是接入配置视角先在 Cursor 里把模型通道换成 TaoToken 的 Key 和 Base URL再装 Archify最后在对话里让它画图。配通之后Cursor 消耗 TaoToken 的额度驱动 Archify你就能在本地拿到可交互的 HTML 架构图。适合已经在用 Cursor、想让 Agent 帮忙维护架构图的开发者也适合想先跑通一条链路再决定要不要深入的人。2. 前置准备TaoToken 的 Key 与 Base URL 怎么拿Archify 本身不绑定模型它靠 Cursor 里的 Agent 来理解代码和生成 JSON IR。所以第一步是把 Cursor 的模型通道配好。我这边用的是 TaoToken 的统一入口一个 Key 可以走 Anthropic 和 OpenAI 两种协议省得在多个平台之间来回切。先到官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台在 API Keys 页面创建一个新 Key。建议按用途命名比如cursor-archify方便后面区分额度消耗。创建完立刻复制页面刷新后就看不到完整 Key 了。Base URL 用这个https://taotoken.net/api注意这里不要加 UTM 参数API 地址保持干净。Cursor 里填的是 Base URL不是完整的 chat completions 路径具体拼接由 Cursor 自己处理。如果你还没想好要用哪个模型可以先在模型对话页面试一下确认 Key 能正常出结果再去配 Cursor。模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite长期用 Cursor 写代码、跑 Agent 的话可以看一下 Coding Plan额度模型和按量计费不太一样适合高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite3. 在 Cursor 里替换模型通道并安装 Archify3.1 配置 Cursor 的模型设置打开 Cursor进入 Settings → Models。在 OpenAI 或 Anthropic 区域把 API Key 换成刚才创建的 TaoToken KeyBase URL 填https://taotoken.net/api。如果你用的是 Anthropic 协议Cursor 里对应的字段是 Anthropic API Key 和自定义 Base URLOpenAI 协议同理。这里有个容易踩的坑Cursor 不同版本对自定义 Base URL 的入口位置不太一样。有的版本在 Models 页面底部有 “Override OpenAI Base URL”有的版本需要开启 “Use custom API endpoint”。找不到的话在设置里搜 “base url” 基本能定位到。配置完成后先在 Cursor 的 Chat 里发一句简单的话比如“回复 ok”确认模型能正常响应。如果报 401多半是 Key 复制时带了空格如果报 404检查 Base URL 是不是多写了/v1或结尾斜杠。3.2 安装 Archify SkillArchify 的安装走 skills 命令。全局安装一条命令npx skills add tt-a1i/archify -g只想临时体验、不写入全局 Skill 目录的话可以指定 agentnpx skills use tt-a1i/archifyarchify --agent codex装完后在 Archify 目录下跑一次自检node bin/archify.mjs doctor这个命令会检查运行环境、依赖和 Skill 注册状态。返回正常就说明装好了。如果提示找不到bin/archify.mjs确认你是在 Archify 的项目根目录执行的而不是在别的路径下。3.3 关键参数对照配置项填写内容说明API KeyTaoToken 控制台创建按用途命名便于区分额度Base URLhttps://taotoken.net/api不加 UTM不加/v1协议Anthropic 或 OpenAI按 Cursor 版本选择对应入口Skill 安装npx skills add tt-a1i/archify -g全局安装所有项目可用自检命令node bin/archify.mjs doctor在 Archify 目录执行4. 验证请求让 Cursor 用 Archify 画一张缓存回源图配置和安装都完成后回到 Cursor 的 Chat直接描述你要的图。比如使用 Archify 画出 Browser - API - Redis - PostgreSQL 的缓存回源过程保留 6 到 8 个核心组件突出一条主要路径标出外部依赖。Agent 会先理解这段描述生成一份 Typed JSON IR然后 Archify 校验这份结构化源文件确认连线没有穿过无关节点、关系标签没有压住其他线路最后编译成 HTML 和 SVG。成功的话你会在项目目录下看到生成的 HTML 文件。用浏览器打开可以搜索节点、点击节点追踪路径、切换主题。如果要求附带源码证据架构节点还能关联到固定 Git Commit 下的文件与行号读图时能回到代码核对。判断接入是否成功看两个信号一是node bin/archify.mjs doctor返回正常二是生成的 HTML 在浏览器里渲染无误、节点可交互。两个都满足说明 Cursor 已经通过 TaoToken 的额度在驱动 Archify 了。如果你想让 Agent 读现有仓库而不是纯描述可以在对话里指定仓库路径让它去读核心组件、主调用链、外部依赖和系统边界。Archify 支持五种图表类型Architecture系统结构、Workflow请求/审批/CI/CD 流程、SequenceAPI 调用链、缓存穿透、Data Flow数据管道/ETL、Lifecycle状态机/订单生命周期。按你要讲的问题选类型出图会更准。5. 本篇常见错排查报 401 UnauthorizedKey 复制不完整或带了空格。重新在控制台复制一次粘贴后检查首尾。如果 Key 被删除或过期也会报 401。报 404 Not FoundBase URL 写错了。确认是https://taotoken.net/api不要加/v1不要加结尾斜杠也不要带 UTM 参数。Cursor 里模型列表为空自定义 Base URL 开启后Cursor 可能不会自动拉取模型列表。手动在模型名称里填你要用的模型 ID或者切回默认通道确认网络正常后再切回来。node bin/archify.mjs doctor报模块找不到确认在 Archify 项目根目录执行且 Node.js 版本符合要求。用node -v看一下版本太低的话升级。生成的 HTML 打开是空白检查浏览器控制台有没有报错。常见原因是 JSON IR 校验没通过但 Agent 没提示回到 Cursor 对话里让 Agent 重新生成或者手动跑一次校验命令看诊断输出。Agent 不调用 Archify确认 Skill 已全局安装且在对话里明确说了“使用 Archify”。有些 Agent 需要显式触发词才会加载 Skill。额度消耗异常快Archify 生成 JSON IR 和校验会消耗 token大仓库分析更明显。可以在 TaoToken 控制台看用量明细必要时换更省的模型或缩小分析范围。6. 配通之后这套组合适合怎么用接入配通只是起点。实际用下来Archify 的价值在“出图之后”需求变了Agent 只改 JSON 里相关的对象不用重排整张图交付前跑固定校验确认连线没穿节点、标签没压线关系能回到 JSON 源文件核对。它省下来的主要是反复改图、重新排图和核对关系的时间。如果你只是临时画一张简单流程图Mermaid 更省事需要盯着画布逐个调元素draw.io 更顺手。但如果你想让 Coding Agent 根据代码仓库起图后面还要反复改、查关系甚至对比一次 PR 前后的架构变化那 Archify 这条路值得配通。需要提醒的是Archify 的校验器检查的是格式、几何和已写入的关系代码分析有没有漏掉组件或调用链它无法证明。涉及真实项目时仍需要熟悉系统的人做最终确认。大单体仓库1000 文件里模型识别准确率会下滑JSON 里的节点命名来自模型理解而非人类共识这些边界心里有数就行。配通过程中如果卡在 Key 或 Base URL 上先去 API Keys 页面确认 Key 状态再对照接入文档检查字段https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite长期用 Cursor 跑 Agent 的话Coding Plan 的额度模型更适合高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteArchify 项目地址https://github.com/tt-a1i/archify