| |

也無風雨也霧晴:從輟學進廠到登頂 GitHub熱榜,做出 Archify,一句話就能畫成可交互架構圖(5 步上手)

他網名叫「也無風雨也霧晴」,本名塗少坤。他讀的是專科,當過兩年兵,後來專升本進了重慶郵電大學。找工作時,他在背調這一關因爲學歷被卡過,後來選擇用開源作品證明自己。他做的 Archify,能把一句話變成一張可以點擊的架構圖。

Archify 免費,花錢的是背後的模型;要畫得穩,用 API易的 claude-opus-5-5。

這篇教程的基本信息:

  • 目標:在 Claude Code 裏裝好 Archify,用一句中文畫出網站請求流程的可交互架構圖,再用一句話改圖。
  • 大概耗時:20 到 30 分鐘,不含註冊和充值。
  • 前置條件:會用 Claude Code 或 Cursor等,電腦上裝了 Node.js(npx 要用),有一個瀏覽器,有一個 API易 賬號。
  • 難度:入門。不用寫代碼,也不用手改配置文件。

archify-tu-shaokun-interactive-architecture-diagram-claude-opus-5-5-zh-hant-image-0


也無風雨也霧晴和他的 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 多次點贊。十幾萬播放,這條他自己發的視頻已經挺火。

也無風雨也霧晴的 B 站視頻播放頁,顯示 12.3 萬次播放

他的經歷裏,我們只想留下三句話:

  • 學歷改不了。他後來做的事,是把能力做成別人打開就能用的作品。
  • 他沒有把每次失敗都推給學歷。題沒寫出來,他就承認是自己沒寫出來。
  • 熱度不等於真的有人在用。他在意的,是有沒有人在用他做的東西。

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 數都是這張圖自己寫的,只能當作當時的宣傳,不代表現在還排第一。

Archify 宣傳圖,倉庫卡片寫着當週 GitHub Trending 第 1

它的工作方式用大白話說是這樣:Agent 先寫一份有固定格式的 JSON,再做校驗,校驗通過才交付 HTML。改圖時只改相關部分,不會整張推倒重畫。圖上的上下游和路徑都來自寫進圖裏的關係,交互不會編造拓撲。所以「圖上點得通」不等於「線上真的這樣跑」。

archify-tu-shaokun-interactive-architecture-diagram-claude-opus-5-5-zh-hant-image-1

Archify 十種圖怎麼選

圖的類型 適合畫什麼 例子
Architecture 組件、服務、存儲、系統邊界 我們網站由哪些服務組成
Workflow 流程、審批、工具調用 報銷從提交到打款怎麼走
Sequence 一次調用的先後順序 登錄時前端、後端、數據庫誰先誰後
Data Flow 數據怎麼流動 訂單數據從下單到報表怎麼走
Lifecycle 狀態、重試、終態 一個任務從排隊到成功或失敗
ERD 表和字段 用戶表和訂單表的關係
Class 類和接口 支付模塊裏有哪些類
Tree 單一父級的層級 公司部門結構
Timeline 時間軸 項目三個月的里程碑
Waterfall 一次請求的耗時 一個接口慢在哪一段

後五種是 3.1 版起新增的。要注意,Timeline 和 Waterfall 的官方示例有些是示意數據;只有數據來自日誌或鏈路追蹤時,圖上的時間才能當作真實耗時。

archify-tu-shaokun-interactive-architecture-diagram-claude-opus-5-5-zh-hant-image-2

Archify 5 步用法一覽

  1. 給 Agent 配好模型。本文用 API易 的 claude-opus-5-5 接進 Claude Code。
  2. 用一條命令安裝 Archify。
  3. 對 Agent 說一句人話,描述你要畫的東西。
  4. 在瀏覽器裏打開生成的 HTML。
  5. 繼續對話改圖,滿意後導出圖片或 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 爲準。


參考資料

  1. Archify 官方倉庫(中文 README):功能、安裝和範圍說明
  2. 鏈接:github.com/tt-a1i/archify
  3. 說明:本文的功能和版本信息以此爲準
  4. Archify 官網:項目主頁
  5. 鏈接:archify.si
  6. 作者 X 長帖(2026-07-15):作者本人講述的經歷
  7. 鏈接:x.com/t20000622yy/status/2077425261856096720
  8. 作者 B 站視頻:《從輟學進廠到登頂GitHub 熱榜,AI 重塑了我的人生!》,作者本人發佈
  9. 鏈接:www.bilibili.com/video/BV1cGe56cEHo/
  10. 作者 B 站項目演示:《一覺醒來我做的開源項目衝上了 GitHub Trending 全球第一》
  11. 鏈接:www.bilibili.com/video/BV16MhA6pEMb/
  12. 量子位 2026 年 9 月報道:項目報道和開發者故事,正文僅引用一句並已標註來源
  13. API易 公開價格接口:本文撰寫當天查詢
  14. 鏈接:api.apiyi.com/api/pricing

延伸閱讀

Similar Posts