企业官网建设流程全解析

1. 在 Cursor 里让 Archify 出图，先补上模型调用这条链路

在 Cursor 里让 Archify 画架构图，最常见的卡点不是提示词，而是模型通道没接上：模型列表为空、请求返回 401、导出按钮灰掉。先到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=archify_cursor_intro 拿 Key，把 Base URL 设为 https://taotoken.net/api，再回 Cursor 补上模型调用，Archify 才能把图编译出来并导出 1200×630 分享卡片。

很多人第一次用 Archify 是这样的：安装完了，在 Cursor 对话窗口里输入“读取当前仓库，画一张架构图”，结果 Archify 的 Skill 被调起来了，但里面调模型的那一步失败。表现可能是Model not found、401 Unauthorized、Request timed out，也可能更隐蔽：图能生成一半，验证步骤过不去，最后只留下一份残缺的 JSON IR 或者空白预览页。这个时候你以为是 Archify 的问题，其实是 Cursor 当前没有可用的模型供应商，或者模型名、Base URL、Key 三者没对齐。

这篇按“技术内容作者”的视角来写，目标很明确：在 Cursor 里用 TaoToken 给 Archify 补上模型调用，然后完整跑一遍 Archify 的生成、验证、预览、交付流程，最后导出 PNG、SVG、WebM，并重点复现 1200×630 分享卡片。文中的命令都在本地终端执行，Key 用YOUR_API_KEY占位，不要把真实 Key 写进公开仓库，也不要把这些配置直接塞进任何生产库连接脚本。

先理清角色：Archify 是装在 AI 编程助手里的 Agent Skill，负责把“系统描述”变成可交互的 HTML 架构图；TaoToken 在这里提供模型调用入口，让 Cursor 里的 Archify 有稳定的模型通道可用；Cursor 是宿主，负责读取仓库、调用 Skill、展示对话和文件。三者关系理顺之后，后面每一步都不会绕。

2. Archify 的产出到底是什么：IR JSON、单文件 HTML 和可交互系统图谱

Archify 和普通“让模型画一张图”的工具不一样。它不直接吐一张图片，也不把 Mermaid 代码丢进文档里让你自己祈祷布局引擎。它的工作流更像编译：

1. 模型先根据仓库内容产出一份类型化的 JSON 中间表示，也就是 IR；
2. Archify 引擎对 IR 做原子化验证，检查节点、边、代码路径、调用关系是否自洽；
3. 验证通过后，引擎确定性地编译成 HTML/SVG；
4. 你在浏览器里打开这份 HTML，搜索节点、追踪上下游、播放调用故事；
5. 需要交付时，再导出 PNG、SVG、WebM 动图或 1200×630 分享卡片。

这套流程最关键的是“验证”和“代码关联”。AI 画图最容易出的问题是拓扑幻觉：图里出现一个不存在的消息队列，或者多了一条从未实现的调用边。Archify 把图的内容先压成结构化 IR，再让引擎逐项检查。节点如果声称对应某个鉴权模块，就要能给出代码位置；边如果声称从网关调到订单服务，就要能解释路径。验证不过，模型拿到的是诊断清单，改完再验，直到通过才准交付。

Archify 支持五类图，技术内容作者常用的主要是前两类：

• 架构图：系统静态骨架，服务分层、模块依赖、入口出口；
• 工作流：一个业务流程从触发到结束怎么走；
• 时序图：一次调用在组件之间来回传消息的时间线；
• 数据流图：数据从哪来、经过什么加工、存到哪里；
• 生命周期图：对象或任务从创建到销毁的状态变化。

对写技术博客、做方案评审、整理 PR 说明来说，架构图和工作流最实用。拿不准选哪种时，按“你想回答什么问题”来挑：想知道系统由什么组成，选架构图；想知道一次请求怎么走，选时序图；想知道数据怎么流转，选数据流图。

Archify 生成的 HTML 不是截图，而是可交互页面。几十上百个服务的大图，输入名字可以直接定位节点；点中一个服务，能高亮“谁影响它”和“它影响谁”；指定起点和终点，可以把两点之间的调用路径亮出来；开发视角、运维视角、安全视角能切换不同着色和侧重点；演示模式下还能像放电影一样，逐步展示一次请求的完整生命周期。深色和浅色主题、四种视觉预设，让同一张图既能贴进文档，也能直接投到大屏。

最影响交付体验的是导出能力。Archify 可以一键导出 PNG、SVG、WebM 动图，以及 1200×630 标准分享卡片。1200×630 这个尺寸在社交平台、文章封面、分享预览里很常用，宽度和高度固定，标题、核心节点、关键链路必须在一屏内说清楚。后面我会给出一份可复现的 HTML 源文件结构，方便你理解分享卡片导出时到底发生了什么。

3. 在 Cursor 中接入 TaoToken：Base URL、Key 与模型名

回到 Cursor。Archify 自己是 Skill，不提供模型算力，它需要宿主里的模型通道。你要做的是把 Cursor 的模型供应商指向 TaoToken，并用 TaoToken 官网拿到的 Key 做认证。官网入口在这里：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=archify_cursor_model 。进入后先完成账号相关操作，创建 API Key，然后回到 Cursor 设置。

Cursor 不同版本的设置入口略有差异，但核心只有三件事：

• Base URL：https://taotoken.net/api
• API Key：YOUR_API_KEY
• Model：从 TaoToken 模型列表里选一个你已开通的模型 ID

如果你用的是环境变量方式，可以在本地终端先验证：

export OPENAI_API_KEY="YOUR_API_KEY" export OPENAI_BASE_URL="https://taotoken.net/api"

然后在 Cursor 里找到 OpenAI 兼容配置区域，把 API Key 和 Base URL 填进去。有些版本叫 “Override OpenAI Base URL”，有些版本叫 “Custom API Base”，名字不同，本质一样：不要让 Cursor 请求默认的 OpenAI 地址，而是请求 TaoToken 的地址。

下面是一份 JSON 示意配置，字段名可能随 Cursor 版本变化，重点看值：

{ "models": { "openai": { "apiKey": "YOUR_API_KEY", "baseUrl": "https://taotoken.net/api", "model": "YOUR_MODEL_ID" } } }

填完之后，不要急着让 Archify 画整仓库。先用最小请求测试模型通道是否通。你可以在 Cursor 对话里问一句：“当前模型 ID 是什么？只回答模型名，不要调用工具。”如果连这个都失败，先修模型接入，不要继续调 Archify。

模型名一定要和 TaoToken 控制台里看到的保持一致。很多 401 和 404 不是 Key 错了，而是模型名写成了别的平台的名称。TaoToken 的 Base URL 是https://taotoken.net/api，不要在末尾随手加/v1或去掉/api，除非你正在用的客户端文档明确要求这么拼。配置类问题优先以官网和控制台说明为准。

4. Claude Code、Codex、CC Switch 三件套：配置别串线

虽然这篇主线是 Cursor，但很多技术作者会同时用 Claude Code、Codex CLI 和 CC Switch 管理多套配置。这里把三套配置写清楚，避免把ANTHROPIC_*套到 Codex 上。

Claude Code 走settings.json或环境变量，使用ANTHROPIC_*系列。示例~/.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID" } }

如果你习惯在 shell 里临时加载，也可以写成：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="YOUR_MODEL_ID"

Claude Code 读取的是ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL这一套。这里的关键是 Base URL 同样指向 TaoToken 的https://taotoken.net/api，Key 用YOUR_API_KEY占位。

Codex 不走ANTHROPIC_*，它使用config.toml。不要因为 Claude Code 配置成功了，就把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN复制进 Codex，那样不会生效，还可能让你误判成 Key 无效。Codex 的~/.codex/config.toml可以这样写：

model = "YOUR_MODEL_ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

对应环境变量：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

注意env_key写的是环境变量名，不是 Key 本身。你真正导出的是TAOTOKEN_API_KEY，值才等于YOUR_API_KEY。

CC Switch 三件套可以理解为：Base URL、API Key、模型名。无论你切到哪套配置，先把这三项填对：

• Base URL：https://taotoken.net/api
• API Key：YOUR_API_KEY
• Model：YOUR_MODEL_ID

CC Switch 的价值在于切换方便，但不要让它变成混乱源。Claude Code 的配置留在 Claude Code 配置里，Codex 的配置留在config.toml里。两边可以共用同一个 TaoToken Key，但字段体系不要混用。再强调一次：Codex 用config.toml，不要写ANTHROPIC_*；Claude Code 用settings.json/ANTHROPIC_*。

5. 复现 Archify：从安装到 1200×630 分享卡片导出

模型通道通了之后，开始跑 Archify。安装命令：

npx skills add tt-a1i/archify -g

安装完成后，在 Cursor 或 Claude Code 里描述需求。典型提示词可以这样写：

读取当前仓库，生成一张架构图。 要求： 1. 输出单文件 HTML； 2. 节点关联真实代码文件路径； 3. 标记入口网关、核心服务、数据库边界； 4. 验证通过后导出 1200×630 分享卡片； 5. 同时保留 PNG 和 SVG 导出选项。

Archify 会先生成 IR。一个简化的 IR 结构类似下面这样，实际字段以 Archify 版本为准：

{ "type": "architecture", "title": "TaoToken + Archify 模型调用链路", "nodes": [ {"id": "cursor", "label": "Cursor", "kind": "client", "source": "src/cursor.ts"}, {"id": "taotoken", "label": "TaoToken API", "kind": "gateway", "source": "config/model.json"}, {"id": "archify", "label": "Archify Engine", "kind": "engine", "source": "skills/archify"} ], "edges": [ {"from": "cursor", "to": "taotoken", "label": "chat/completions"}, {"from": "taotoken", "to": "archify", "label": "model response"} ] }

验证通过后，你会得到一个自包含的单文件 HTML。它零运行时依赖，双击就能打开，发给同事也能直接看。HTML 源文件大致结构如下：

<!doctype html> <html lang="zh-CN"> <head> <meta charset="utf-8"> <title>项目架构图 - Archify</title> <meta name="viewport" content="width=device-width, initial-scale=1"> </head> <body> <main id="archify" data-export-width="1200" data-export-height="630"> <section data-node-id="cursor" data-source="src/cursor.ts"> Cursor 宿主 </section> <section data-node-id="taotoken" data-source="config/model.json"> TaoToken API </section> <section data-node-id="archify" data-source="skills/archify"> Archify Engine </section> </main> </body> </html>

这份 HTML 里的data-export-width="1200"和data-export-height="630"就是分享卡片导出的关键。Archify 在预览页里读取这些元数据，再把画布按固定比例截取。导出时重点检查三件事：

第一，标题不要超过一行太长。1200×630 的分享卡片信息密度有限，主标题最好控制在 12 到 18 个汉字，副标题一句话说清版本或分支。

第二，核心节点必须落在安全区内。不要把关键服务放在最边缘，否则不同平台裁剪预览时容易被切掉。

第三，链路高亮要选对。分享卡片不是全量架构图，应该只突出这次要讲的调用路径，比如 Cursor → TaoToken → Archify 这条模型调用链。全量图适合放文档正文，分享卡片适合做导读。

导出操作一般在 HTML 预览页完成：打开生成的 HTML，进入导出菜单，选择 PNG、SVG、WebM 或分享卡片。PNG 适合贴文章，SVG 适合继续编辑，WebM 适合演示调用流动，1200×630 分享卡片适合做封面和转发预览。如果你要做 PR 评审，还可以让 Archify 生成 Before、Delta、After 三张视图，把这次变更动了哪些链路单独标出来。Delta 图放在评审材料里，比口述“这次改了订单服务到支付服务的调用”直观得多。

6. 常见排障：401、模型不存在、导出空白、验证失败

即便配置写对了，第一次跑也可能遇到问题。下面按症状排查。

401 Unauthorized：优先检查 Key 是否过期、是否复制完整、环境变量是否在当前终端生效。Cursor、Claude Code、Codex 可能各自读不同的环境变量，不要在 A 工具里配了 Key，却去 B 工具里测试。回到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=archify_troubleshoot 重新确认 Key 状态和控制台配置。

404 或路径错误：检查 Base URL。本文统一使用https://taotoken.net/api。有些客户端会自动在 Base URL 后拼接/v1，有些不会。不要盲目加路径，先看客户端文档或 TaoToken 控制台说明。如果同一台机器上多个工具共用配置，建议把 Cursor、Claude Code、Codex 分开管理，减少串线。

模型不存在：模型名必须与 TaoToken 控制台里可用的模型 ID 一致。复制模型名时不要带空格，不要用其他平台的模型别名。把YOUR_MODEL_ID替换成真实模型 ID 后再试。

导出空白：通常是预览页还没完全渲染就触发了导出。先等图稳定，再点导出。如果 WebM 动图导出失败，检查浏览器是否允许录屏或编码；PNG/SVG 导出对浏览器要求更低，可以先用 PNG 验证分享卡片尺寸。如果 1200×630 卡片被裁切，检查 HTML 里的data-export-width、data-export-height，以及标题和节点是否超出安全区。

验证失败：这是 Archify 和普通画图工具最大的区别。节点缺少代码路径、边引用了不存在的节点、调用方向和 IR 声明不一致，都会导致验证不过。按诊断清单逐条修：能补source的补代码位置，不能补的就删掉幻觉节点，边对不上就改 IR。不要为了让图“好看”而保留不存在的服务。

另外，本文所有命令和配置都在本地执行。不要让 Agent 或 MCP 配置直连 Oracle、MySQL 等生产库，也不要把数据库密码、生产连接串写进模型上下文。架构图需要的是系统拓扑和代码关系，不是生产数据。

7. 什么时候用 Archify，什么时候用静态图或动画工具

Archify 不是唯一选择。AI 绘图 Skill 这条赛道里，还有偏静态发布图的工具，也有偏手绘动画的工具。三种路线对应三种需求。

如果你只是给技术文章配一张好看的静态图，要求风格多、导出快，不需要交互和验证，那么偏静态 SVG/PNG 的工具就够用。它们通常有多种视觉风格和 UML 模板，适合教程、PPT、公众号封面。

如果你要的是转发时一眼抓住注意力的动图，比如黑底手绘风、光点沿线流动、模块脉冲呼吸，那么偏动画的工具更合适。它的视觉冲击力强，适合文章头图和社群传播，但版式通常较窄，也不读取代码库。

Archify 的优势在“较真”场景：架构评审、PR 说明、重构方案、系统图谱维护。它读真实代码，节点能关联文件路径，拓扑要经过验证，变更可以出 Before/Delta/After。日常配图可以不用它；一旦要回答“这个服务挂了会影响谁”“这次重构动了哪条链路”“图上的模块到底对应哪个文件”，Archify 的价值就出来了。

对技术内容作者来说，最实用的组合是：日常文章配图用静态工具，需要演示调用流动时用动画工具，涉及真实系统架构和代码变更时用 Archify。三条路线不冲突，甚至可以组队。

8. 把模型通道、Archify 和分享卡片串成一条流水线

回到最初的问题：为什么在 Cursor 里让 Archify 画图，会卡在模型调用？因为 Archify 是 Skill，不是模型；它负责生成 IR、验证拓扑、编译 HTML，但推理和结构化描述需要宿主模型完成。宿主的 Base URL、Key、模型名没配好，Archify 就只能停在半路。

正确顺序是：

1. 到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=archify_final 获取 Key；
2. 把 Cursor 的 Base URL 设为https://taotoken.net/api；
3. 填入YOUR_API_KEY，选择YOUR_MODEL_ID；
4. 安装 Archify：npx skills add tt-a1i/archify -g；
5. 在 Cursor 里让 Archify 读取仓库、生成 IR、验证、编译 HTML；
6. 打开 HTML，检查节点搜索、上下游高亮、路由探测；
7. 导出 PNG、SVG、WebM 和 1200×630 分享卡片；
8. 代码变更后重新生成，必要时让 Archify 输出 Before/Delta/After。

如果你同时使用 Claude Code，就用settings.json和ANTHROPIC_*；如果使用 Codex，就用config.toml和TAOTOKEN_API_KEY；如果用 CC Switch，就管好 Base URL、API Key、模型名这三件套。不要把ANTHROPIC_*套到 Codex，也不要把生产库连接配置交给 Agent。

架构图不该是一张画完就过期的固定图片。它应该像代码一样被生成、验证、评审、迭代。Archify 把这件事做成了 Agent 原生的工作流，TaoToken 则把 Cursor 里的模型调用通道补齐。先跑通模型，再生成 HTML，最后导出 1200×630 分享卡片，这条流水线就能复现。

下一步按顺序走：

• 先开模型对话验证模型通道：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=archify_chat
• 需要长期在 Cursor、Claude Code 里用，看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=archify_coding_plan
• 创建并管理你的 API Key：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=archify_api_keys
• Claude Code 配置细节看官方文档：https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=archify_claude_code_doc

把 Key 换成YOUR_API_KEY，把 Base URL 固定为https://taotoken.net/api，然后在 Cursor 里对 Archify 说：“读取当前仓库，生成架构图，验证通过后导出 1200×630 分享卡片。”这次你应该拿到的不再是空白页，而是一份能搜索、能追链路、能投屏、能转发单文件 HTML。