他网名叫「也无风雨也雾晴」,本名涂少坤。他读的是专科,当过两年兵,后来专升本进了重庆邮电大学。找工作时,他在背调这一关因为学历被卡过,后来选择用开源作品证明自己。他做的 Archify,能把一句话变成一张可以点击的架构图。
Archify 免费,花钱的是背后的模型;要画得稳,用 API易的 claude-opus-5-5。
这篇教程的基本信息:
- 目标:在 Claude Code 里装好 Archify,用一句中文画出网站请求流程的可交互架构图,再用一句话改图。
- 大概耗时:20 到 30 分钟,不含注册和充值。
- 前置条件:会用 Claude Code 或 Cursor等,电脑上装了 Node.js(
npx要用),有一个浏览器,有一个 API易 账号。 - 难度:入门。不用写代码,也不用手改配置文件。

也无风雨也雾晴和他的 Archify:核心要点
| 要点 | 说明 |
| 作者 | 涂少坤,网名也无风雨也雾晴,专科、当兵、专升本 |
| Archify 是什么 | 开源免费的 Agent Skill,MIT 协议 |
| 钱花在哪 | 花在执行 Skill 的 Agent 所用的模型上 |
| 推荐模型 | API易 上的 claude-opus-5-5 |
| 成品 | 一个独立 HTML,浏览器打开就能点 |
涂少坤是谁:从专科、当兵到用开源证明自己
下面的经历,主要来自他本人 2026-07-15 在 X 上发的长帖。2018 年高考后,他读了专科,专业是计算机应用技术。他写道,第一年过得很颓废,后来去当兵,在部队待了两年。刚去时他体重大约 106 斤,很多训练做不动;后来分到通信专业,代表单位参加集团军通信比武,拿了第一。
退伍后,他回校专升本。那一批七十多人只招六个,他考了退伍批次第一,进了重庆邮电大学软件工程。毕业时他比同龄人大三岁,跟着网课学了一个多月前端,就出去找实习。之后他面字节飞书,两轮都过了,背调时因为专升本被卡。秋招面重庆懂车帝,HR 面他主动说了专升本,之后没有下文;一面面试官后来发来一句「不好意思」。那晚,他出去跑了五公里。
他没有把每次失败都算在学历头上。他自己写过,猿辅导四面的题没写出来,挂了也正常。后来在杭州西湖大学实习,HR 又问到学历,他说了一句「出身寒微不是耻辱」,那次过了。面 Manus 时,对方提到学历不占优势的人可以用作品或开源项目证明自己,他当时已经有这个想法。他的原话是:最开始做开源,目的没有多高尚,就是想在简历上多一点能证明自己的东西。Archify 的仓库创建于 2026-04-15。
量子位 2026 年 9 月的专访还写到他 16 岁辍学、学过修车、进过厂。这部分是专访的说法,他自己的长帖里没有写。他本人在 B 站也发了一条视频《从辍学进厂到登顶GitHub 热榜,AI 重塑了我的人生!》,2026-09-14 发布,地址:https://www.bilibili.com/video/BV1cGe56cEHo/。我们只核对了标题、日期、UP 主和标签,没有逐段看完全片。标题里的「登顶 GitHub」,对应的是他 2026-09-01 在 X 上发的一张截图:GitHub Trending 所有语言周榜第一。那是当时的截图,不代表现在的排名。
下面是这条视频的播放页。页面上显示 12.3 万次播放、1700 多次点赞。十几万播放,这条他自己发的视频已经挺火。

他的经历里,我们只想留下三句话:
- 学历改不了。他后来做的事,是把能力做成别人打开就能用的作品。
- 他没有把每次失败都推给学历。题没写出来,他就承认是自己没写出来。
- 热度不等于真的有人在用。他在意的,是有没有人在用他做的东西。
Archify 是什么?
按官方中文 README 的说法,Archify 是一个开源免费的 Agent Skill。你把想法、问题或计划说给 AI Agent,它会生成一个可以点击、可以分享的交互式 HTML。它不需要你先有代码仓库;如果你让 Agent 读仓库,它也能画出带源码依据的架构图,节点可以标 SRC,并固定到某一次提交。除了图,它还有一种产物叫 explainer:一页先给结论,再按问题拆成几个面板,里面可以有表格、步骤和图。
它也有明确不做的事。它不是通用绘图编辑器,也不是 Mermaid 主题;自动解析 Mermaid、通用自动布局、托管分享服务、所见即所得编辑器,目前都不在产品范围内。它不卖模型,也不签发 API Key,官方写明第三方收费套餐不代表 Archify。当前稳定版是 v3.2.0。skills.sh 的安装量徽章写着 130K+,这是项目自报的数字,我们没有实测。
项目方还做了一张宣传图。正中间是仓库 tt-a1i/archify,角标写着当周 GitHub Trending 第 1,下面一行是「一句话,生成可交互架构图」。图上印的名次和 Star 数都是这张图自己写的,只能当作当时的宣传,不代表现在还排第一。

它的工作方式用大白话说是这样:Agent 先写一份有固定格式的 JSON,再做校验,校验通过才交付 HTML。改图时只改相关部分,不会整张推倒重画。图上的上下游和路径都来自写进图里的关系,交互不会编造拓扑。所以「图上点得通」不等于「线上真的这样跑」。

Archify 十种图怎么选
| 图的类型 | 适合画什么 | 例子 |
|---|---|---|
| Architecture | 组件、服务、存储、系统边界 | 我们网站由哪些服务组成 |
| Workflow | 流程、审批、工具调用 | 报销从提交到打款怎么走 |
| Sequence | 一次调用的先后顺序 | 登录时前端、后端、数据库谁先谁后 |
| Data Flow | 数据怎么流动 | 订单数据从下单到报表怎么走 |
| Lifecycle | 状态、重试、终态 | 一个任务从排队到成功或失败 |
| ERD | 表和字段 | 用户表和订单表的关系 |
| Class | 类和接口 | 支付模块里有哪些类 |
| Tree | 单一父级的层级 | 公司部门结构 |
| Timeline | 时间轴 | 项目三个月的里程碑 |
| Waterfall | 一次请求的耗时 | 一个接口慢在哪一段 |
后五种是 3.1 版起新增的。要注意,Timeline 和 Waterfall 的官方示例有些是示意数据;只有数据来自日志或链路追踪时,图上的时间才能当作真实耗时。

Archify 5 步用法一览
- 给 Agent 配好模型。本文用 API易 的 claude-opus-5-5 接进 Claude Code。
- 用一条命令安装 Archify。
- 对 Agent 说一句人话,描述你要画的东西。
- 在浏览器里打开生成的 HTML。
- 继续对话改图,满意后导出图片或 PDF。
Archify 快速上手:接上 claude-opus-5-5 画第一张可交互架构图
第 1 步:为 Archify 准备 API易 令牌
先说清楚 Token 花在哪。Archify 仓库本身不收模型费,真正消耗 Token 的是正在执行这个 Skill 的 Agent:读仓库、写 JSON、校验失败后返工,都走你给 Agent 配的模型。所以你要准备的是模型额度,不是 Archify 会员。
打开 API易 控制台,新建一个令牌,可用模型选 claude-opus-5-5,然后把令牌复制下来。如果你还没买额度、想先试一下 Opus,可以看文末延伸阅读里的试用说明。
做完你应该看到:令牌列表里多出一条新令牌,可用模型里有 claude-opus-5-5,令牌字符串已经复制好。
第 2 步:把令牌接进 Claude Code(按 magpie 教程做)
接 Key 的点击步骤,本文不再重复写。请按这篇已发布的图文教程操作:手把手教程:一个 Key 接上所有 Agent,用开源 magpie 统一接入 API 网关(以 Claude Code、Codex、Pi、Hermes 为例)。
照着做时,只要记住两个值。第一,Claude Code 用的 Anthropic 兼容地址是 https://api.apiyi.com,末尾不要加 /v1。第二,模型名写 claude-opus-5-5,一个字都不能错,写错会报 model not found。Codex 这一类工具走的是 OpenAI 兼容地址 https://api.apiyi.com/v1,本文主线不展开。如果你用的是 Cursor,并且走它自己的订阅,那就不一定会用到 API易 的令牌。用 Archify 并不要求一定用 API易。
按那篇教程做完,再回来装 Archify。
做完你应该看到:在 Claude Code 里问一句「你好」,它能正常回复,没有报 401,也没有报 model not found。
第 3 步:安装 Archify Skill
打开终端,只需要跑这一条官方命令:
npx skills add tt-a1i/archify -g
-g 表示全局安装,装好后在哪个项目目录里都能用。主线支持的 Agent 有 Cursor、Claude Code、Codex CLI、OpenCode,本文只讲 Claude Code。装完之后,请关掉当前的 Claude Code 会话,重新开一个。
做完你应该看到:命令执行结束,没有红色报错。在新会话里问「你能用 Archify 吗」,Claude Code 能认出这个 Skill。
第 4 步:用 Archify 一句话画出网站请求流程
把官方示例原样发给 Claude Code:
用 Archify 画出一个网站的请求流程:浏览器请求 API,API 优先读取 Redis,缓存未命中时查询 PostgreSQL 并回填缓存。
接下来,Claude Code 会先写 JSON,再做校验,最后生成 HTML 文件。如果它只在对话里贴出代码、没有保存成文件,就补一句「把 HTML 保存到当前目录」。找到这个 .html 文件,双击或拖进浏览器打开。
做完你应该看到:浏览器里出现一张图,上面有浏览器、API、Redis、PostgreSQL 几个节点,节点之间有连线;点一下节点,可以看到它的上下游关系。
第 5 步:一句话改 Archify 架构图并导出
不用重新描述整张图,接着说一句就行:
添加鉴权,并突出缓存未命中的路径,切换成浅色主题。
Archify 只改相关部分,不会推倒重画。改完后,你可以在四种样式里切换,浅色和深色都有;也可以导出 PNG、WebP、JPG 长图,或者打印成 PDF。把 HTML 直接发给同事,对方打开后也能交互;图里如果有外部网站或地图链接,打开时需要联网。
做完你应该看到:同一张图里多了鉴权相关的节点,缓存未命中的那条路径被高亮,整体变成浅色。
🎯 技术建议:第一次用时,先拿官方这句示例跑通,再换成你自己的业务描述。这样一旦出问题,你能分清是环境没配好,还是描述太复杂。
Archify 背后的模型花多少钱
下面是我们在本文撰写当天,从 API易 公开价格接口查到的数字。换算口径是倍率 1 等于每百万 tokens 2 美元。实际价格以 API易控制台价格页当天显示为准,不同分组的成交价可能不同。
| 模型 | 输入 | 输出 | 缓存读 | 缓存写 | 什么时候用 |
|---|---|---|---|---|---|
| claude-opus-5-5 | 4 美元 | 20 美元 | 0.20 美元 | 5 美元 | 复杂图、要读仓库、长 HTML |
| claude-sonnet-5-5 | 2 美元 | 10 美元 | 0.10 美元 | 2.50 美元 | 小示意图、简单改动 |
单位都是每百万 tokens。另外还有 claude-opus-5-5-thinking,倍率相同。画一张图要花多少钱,我们没有实测,所以这里不给数字。一次出图消耗多少 Token,取决于图有多大、要不要读仓库,以及校验失败后返工了几轮。
什么时候不必用 Opus 5.5
官方没有说必须用 Claude Opus 5.5。推荐 Opus 是我们自己的建议:Archify 要写结构化 JSON 和很长的 HTML,有时还要读整个仓库,旗舰编码模型更不容易在格式上出错。下面两种情况,换成更便宜的模型,比如 claude-sonnet-5-5,通常就够了:
- 只画三四个框的小示意图,关系简单,没有要读的仓库。
- JSON 已经写好,只是换个样式、再导出一次。
到了图变大、要读仓库或者反复校验失败的时候,再切回 Opus。两个模型怎么搭配,延伸阅读里有一篇专门对比的文章。
Archify 排错表
| 现象 | 常见原因 | 怎么处理 |
|---|---|---|
| 装完后 Agent 说不认识 Archify | 还在旧会话里;没加 -g;Node.js 没装好 |
重开 Claude Code;确认用 -g 重新安装;终端跑 node -v 看能否输出版本 |
| HTML 打不开或是空白 | 只贴了代码没存文件;文件不完整;外链要联网 | 让 Agent 把 HTML 保存成文件;用浏览器直接打开;检查网络 |
| 提示校验失败 | 描述太复杂或关系有矛盾 | 官方会给出能定位问题的修复说明,最多聚焦修两轮;还不行就拆成两张图,或把描述写得更具体 |
| model not found | 模型名写错;地址后面多加了 /v1 |
模型名改成 claude-opus-5-5;Anthropic 地址去掉末尾的 /v1 |
| 401 或提示额度不足 | 令牌复制错、已禁用,或余额用完 | 回 API易 控制台检查令牌状态和余额;重新复制令牌,再按 magpie 教程更新 |
Archify 常见问题
Q1:Archify 要不要钱?
Archify 本身免费,采用 MIT 协议开源。要花钱的是 Agent 背后的模型 Token。你给 Claude Code 配了哪个模型,就按那个模型的价格计费。
Q2:必须用 Opus,或者必须用 API易 吗?
都不是必须的。官方没有指定模型,推荐 claude-opus-5-5 是我们的建议,图小的时候用 Sonnet 也可以。Archify 官方也没有接入 API易;如果你用 Cursor 自带的订阅,可能完全用不到 API易 的令牌。
Q3:没有代码仓库也能用 Archify 吗?
能。直接用中文描述就行。有仓库的话,可以让 Agent 先读仓库,再画出带源码依据的图,节点上会标 SRC。这种情况下 Token 消耗会更多。
Q4:把 HTML 发给别人,还能点吗?
能。它是一个独立的 HTML 文件,交互功能都在文件里。只有图里的外部网站和地图链接需要联网才能打开。
Q5:图上点得通,是不是说明线上系统真的这样跑?
不是。图上的路径都来自你写进去的关系,它不会替你核实线上系统。Waterfall 这类图里的耗时,也只有在数据来自日志或链路追踪时才可信。
总结:也无风雨也雾晴的 Archify 给我们留下什么
涂少坤没法改变自己的学历,于是把能力做成了一个别人装上就能用的工具。动手部分的要点如下:
- Archify 是什么:开源免费的 Agent Skill,一句话生成可交互的 HTML 图。
- 钱花在哪:花在 Agent 背后的模型上,不用买 Archify 会员。
- 怎么接 Key:在 API易 新建令牌,模型选 claude-opus-5-5,按 magpie 教程接进 Claude Code,地址不要带
/v1。 - 怎么装:只跑
npx skills add tt-a1i/archify -g这一条命令。 - 怎么用:说一句人话出图,再说一句话改图,然后导出 PNG 或 PDF。
- 省钱技巧:小图和重新导出用 Sonnet,复杂图再用 Opus。
想马上动手的话,可以在 API易 apiyi.com 控制台新建一个令牌,先用官方那句示例跑通第一张图。
本文的信息来自几类不同的来源,可信程度也不一样:
| 信息 | 来源 | 说明 |
|---|---|---|
| 功能、版本、十种图、安装量 130K+ | 官方 README | 项目自报 |
| 周榜第一 | 作者 2026-09-01 在 X 上发的截图 | 当时的截图,不是实时排名 |
| 专科、当兵、专升本、求职经历 | 作者 2026-07-15 的 X 长帖 | 作者本人的说法 |
| 16 岁辍学、修车、进厂 | 量子位 2026 年 9 月专访 | 媒体整理 |
| 模型价格 | API易 公开价格接口,本文撰写当天查询 | 以控制台价格页当天显示为准 |
可选:更新检查和仓库命令(普通读者不用看)
Archify 不会自动安装新版本。想收到更新提醒,可以在 GitHub 仓库页面依次点 Watch → Custom → Releases。安装后的 Skill 有一个低频更新检查,检查失败也不会报错,只会提醒,不会自己下载。它只访问 `archify.si/skill-updates/archify/stable.json`,不会上传本地版本、项目内容、用户输入或密钥。如果想关掉,可以设置环境变量 `ARCHIFY_UPDATE_CHECK_DISABLED=1`。
仓库里还有 `node bin/archify.mjs` 一类的命令,主要给贡献者调试用。普通读者不用跑,具体用法以仓库 README 为准。
参考资料
- Archify 官方仓库(中文 README):功能、安装和范围说明
- 链接:
github.com/tt-a1i/archify - 说明:本文的功能和版本信息以此为准
- Archify 官网:项目主页
- 链接:
archify.si - 作者 X 长帖(2026-07-15):作者本人讲述的经历
- 链接:
x.com/t20000622yy/status/2077425261856096720 - 作者 B 站视频:《从辍学进厂到登顶GitHub 热榜,AI 重塑了我的人生!》,作者本人发布
- 链接:
www.bilibili.com/video/BV1cGe56cEHo/ - 作者 B 站项目演示:《一觉醒来我做的开源项目冲上了 GitHub Trending 全球第一》
- 链接:
www.bilibili.com/video/BV16MhA6pEMb/ - 量子位 2026 年 9 月报道:项目报道和开发者故事,正文仅引用一句并已标注来源
- API易 公开价格接口:本文撰写当天查询
- 链接:
api.apiyi.com/api/pricing
