作者注：VibeHub Skill 把口語改成 Agent 能直接執行的需求，每次最多補 3 個相關術語。本文說明它怎麼安裝、兩個功能怎麼用、Token 實際花在哪裏，以及模型請求怎樣接到 API易。
先說結論：VibeHub 負責把你的口語改準，Token 花在 Agent 調用的模型上，不花在 VibeHub 自己的查詢上。
用 Agent 做 Vibe Coding 時，常見的情況有兩種。第一種是你說「這個按鈕鼠標放上去變個色，點下去也要有一下反饋」，Agent 理解偏了，做出來的東西對不上。第二種是 Agent 的回覆裏冒出 Tooltip、Hover、樂觀更新這些詞，你看不懂，也不知道下一句該怎麼回。VibeHub Skill 處理的就是這兩個問題，而且有一條明確的邊界：每次最多隻補 3 個真正相關的術語。
它不會給你開一門前端課。 倉庫 README 寫明，它不提供學習路線、課程計劃或本地練習，也不會把一句簡單需求擴展成教程。
讀完本文你會得到：一句可以直接發給 Agent 的安裝話；兩個功能各自的用法和邊界；「這個 Skill 自己不收 API Key」與「裝上它的 Agent 仍在消耗模型 Token」的區別；以及把 Agent 的 Token 接到 API易 時，OpenAI 兼容和 Anthropic 原生各用哪個地址。
VibeHub 是什麼：給 Agent 聽懂口語用的 Vibe Coding 術語圖鑑
VibeHub 的站點是 vibe-hub.org，中文首頁的定位是「Vibe Coding 術語圖鑑，用大白話找準前端、後端、AI 術語」。導航欄有術語、練習、課程、防止 AI 味兒、更新、Skill、交流羣幾個入口。作者是 Oil，個人站和 GitHub 主頁見文末參考資料。
站內對 Vibe Coding 本身也有詞條：用自然語言向 AI 表達需求，由 AI 編寫代碼，再根據運行結果持續迭代，中文裏也常被叫作氛圍編程、憑感覺編程。詞條裏有一句值得記住：能運行不等於可靠，上線前仍要檢查代碼、測試和權限。這句話同樣適用於後面提到的所有 Agent 工作流。
| 要點 | 說明 | 對你的價值 |
|---|---|---|
| 網站 | vibe-hub.org，可視化術語圖鑑（Skill 介紹頁原文：360 個可視化術語） | 遇到陌生概念可以查大白話解釋 |
| Skill 倉庫 | GitHub oil-oil/vibe-hub-skill，MIT 許可 |
讓 Agent 在對話中自動使用術語規則 |
| 功能一 | 規範表達：把口語改寫成可直接發送的需求 | 減少 Agent 理解偏差 |
| 功能二 | 主動提示：每次最多點出 3 個相關術語 | 看得懂回覆，知道下一步怎麼說 |
| 費用邊界 | Skill 自己不配置賬號和 API Key | Token 只花在 Agent 調用的模型上 |
VibeHub Skill 和 VibeHub 網站的分工
兩者的分工在倉庫 README 裏寫得很清楚：術語內容由 vibe-hub.org 維護，倉庫只保留表達規則和術語解析器。 也就是說，網站負責「這個詞是什麼意思、配什麼圖」，Skill 負責「什麼時候該提這個詞、怎麼改寫你的話、鏈接從哪來」。
倉庫 skills/vibehub/ 目錄下有四個文件：SKILL.md 定義表達規則，agents/openai.yaml 是給 Agent 宿主的配置，scripts/vibehub.mjs 是術語解析腳本，vibehub.config.json 是解析器配置。整個 Skill 不包含模型調用邏輯，這一點決定了後面講的 Token 歸屬。
如何一分鐘安裝 VibeHub Skill
安裝不需要註冊賬號，也不需要填寫任何 Key。按 README 的配置邊界，只需要滿足兩個前提：本機有 Node.js 20 或更高版本，並且可以聯網。
VibeHub Skill 兩種安裝方式
- 方式一：直接發給 Agent 一句話（Skill 介紹頁原文）：
https://github.com/oil-oil/vibe-hub-skill 幫我安裝這個倉庫裏的 skills/vibehub Skill。 - 方式二：用 skills 命令安裝（倉庫 README 原文）：
npx skills add oil-oil/vibe-hub-skill - 安裝之後：由 Agent 宿主重新加載 Skill，新對話裏就能生效。
第一種適合不想碰終端的人，把整句粘進 Agent 的對話框即可，Agent 會自己完成拉取和放置。第二種適合習慣命令行的用戶，結果相同。兩種方式都不會讓你填 API Key，因爲這個 Skill 運行的只是自帶的術語解析腳本。
| 配置項 | VibeHub Skill 的要求 | 來源 |
|---|---|---|
| 運行環境 | Node.js 20 或更高版本 | 倉庫 README 原文 |
| 網絡 | 需要聯網（查詢 vibe-hub.org 術語） | 倉庫 README 原文 |
| 賬號 / API Key | 無賬號或 API Key 配置 | 倉庫 README 原文 |
| 許可 | MIT | 倉庫 README 原文 |
| 解析命令形態 | node skills/vibehub/scripts/vibehub.mjs resolve，加一個或多個 --query，可加 --compact |
倉庫 README 原文 |
VibeHub 術語查詢是怎麼發出去的
解析器不會把整句需求直接丟給搜索接口。它的流程是：Agent 先按當前語境推斷候選術語，再用一次批量查詢驗證名稱和鏈接。高置信度時只查一個，有歧義時最多比較三個。
鏈接規則很嚴格：只使用解析器返回的 url，不自行拼接、不僞造；沒有匹配就直接說明，不編造術語和鏈接。所以你在回覆裏看到的 VibeHub 鏈接，都是查詢接口真實返回的。
🚀 快速上手建議：裝好 VibeHub 之後，Agent 每一輪改寫和解釋都會調用一次大模型。如果你想在不同 Agent 之間共用一個 Key、統一看賬單，可以先在 API易 apiyi.com 註冊賬號，用註冊後的少量試用額度跑通流程。
VibeHub 兩個功能：把口語改準，最多補 3 個術語
Skill 介紹頁把能力歸納爲 2 個核心功能。下面各用介紹頁裏的那一個例子說明，不額外擴展。
功能一：VibeHub 把口語改成 Agent 能直接執行的需求
原話是：「這個按鈕鼠標放上去變個色，點下去也要有一下反饋。」
改寫結果是：「爲按鈕補充 Hover 狀態和 Active 狀態，並使用 Transition 讓狀態變化更自然。」三個術語在頁面裏分別鏈接到 vibe-hub.org 的 /hover、/active、/transition 詞條。
這一步的關鍵在於保留原意。Skill 不會擅自增加框架、參數或實現方案，比如不會替你決定顏色值、動畫時長或者換一個 UI 庫。你拿到的是一句可以直接發給 Agent 的需求，意思和你原來想說的一樣，只是用詞換成了 Agent 更不容易誤解的說法。
功能二：VibeHub 主動點出你需要知道的術語
原話是：「這個設置我想改了就馬上生效，不想再點一次保存。」
Skill 會提示 Switch：它適合只有開和關兩種狀態、修改後立即生效的場景；如果要先改多項再統一確認，就不該這樣設計。這句解釋緊跟你當前的任務，告訴你什麼時候用、什麼時候別用，而不是給出百科定義。
主動提示有三條規則（Skill 介紹頁原文）：
- 術語第一次出現時鏈接到 VibeHub；
- 解釋緊跟當前任務，不講百科定義；
- 每次最多提示 3 個真正相關的術語。
| 對比維度 | 功能一：規範表達 | 功能二：主動提示 |
|---|---|---|
| 觸發時機 | 你的需求表達模糊 | 你的需求背後有一個你沒說出的設計概念 |
| 輸出內容 | 一句可直接發送的改寫需求 | 1 到 3 個術語 + 貼着任務的解釋 |
| 示例術語 | Hover、Active、Transition | Switch |
| 不會做的事 | 擅自增加框架、參數或實現方案 | 講百科定義、逐個講完術語表 |
| 你下一步 | 確認後直接發給 Agent | 判斷方案是否合適，再決定怎麼說 |
看不懂 Agent 回覆時，用 VibeHub 只解釋關鍵概念
Agent 回覆裏突然冒出 Tooltip、樂觀更新這類詞，你可以把原話貼出來。按 README 的說法，它只解釋最影響你下一步判斷的概念，不逐詞翻譯整段，也不自動開課。
README 裏的工作原則可以概括爲四條：先給可以直接使用的結果，再解釋術語；保留用戶原意；每次最多 1 到 3 個術語；表達已經準確就不要硬加教學。最後一條很實用，如果你本來就說得很清楚，它就不會多插話。
VibeHub Skill 的 Token 到底花在哪一步
這是最容易搞混的地方。VibeHub Skill 自己不接收 API Key，術語查詢也不是調用大模型。 解析腳本只是向 vibe-hub.org 發一次批量查詢，拿回術語名稱和鏈接。
真正消耗 Token 的是裝了這個 Skill 的 Agent。改寫你的口語、用大白話解釋術語、接着把頁面做出來，這三步都是模型調用。Skill 讓這些調用的輸入輸出更準確，但不會替你承擔費用，調用本身也不會消失。
| 步驟 | 誰在執行 | 是否調用大模型 | 是否消耗模型 Token |
|---|---|---|---|
| 推斷候選術語 | Agent | 是 | 是 |
| 批量查詢術語和鏈接 | VibeHub 解析腳本 → vibe-hub.org | 否 | 否 |
| 改寫口語需求 | Agent | 是 | 是 |
| 用大白話解釋術語 | Agent | 是 | 是 |
| 按需求寫代碼、改頁面 | Agent | 是 | 是 |
所以要充值、要選模型，對象是 Agent 背後的模型服務，不是給 VibeHub 網站開戶。help-apiyi 已有一篇《Agent 長任務的 Token 賬單從哪來》，專門拆解長任務裏前綴緩存怎麼影響賬單，這裏不再展開。
上圖對應的結論是：Agent 的模型請求可以指向 API易 apiyi.com，一個 Key 和同一份餘額同時覆蓋 Claude 系和 GPT 系模型，VibeHub 這一側不需要任何改動。
用 API易 查模型、對價格，把 Agent 的請求指過去
API易（APIYI）是 API 網關，不是模型託管方。一個密鑰、同一份餘額就能調用多家廠商的模型。賬號需要人工註冊，註冊後有少量試用額度，平臺沒有免費模型路由。完整的模型和價格在模型總表 docs.apiyi.com/models，數據來源爲系統實時定價接口。
端點按 SDK 選，不按模型選
把 Agent 的請求指向 API易 時，先看你的 Agent 用的是哪套 SDK，再填對應地址：
- OpenAI 兼容：base_url 填
https://api.apiyi.com/v1。Chat Completions 走/v1/chat/completions，Responses 走/v1/responses。 - Anthropic 原生：base_url 填根域名
https://api.apiyi.com，不要再加/v1，否則會拼成/v1/v1/messages並返回 404。Messages 端點是/v1/messages。 - 節點選擇：
api.apiyi.com是默認節點；b.apiyi.com用於備用與企業場景；api-cf.apiyi.com僅支持文本，超時上限約 100 秒，不適合長任務。
文檔還建議 OpenAI GPT-5 及以後的模型優先走 Responses。如果你同時在用 Claude Code、Codex 等多個 Agent，help-apiyi 的《手把手教程：一個 Key 接上所有 Agent，用開源 magpie 統一接入 API 網關》講了統一接入的做法。
Vibe Coding 常用模型價格（總表原文）
下表數據更新於 2026-11-13 12:57 （UTC+8），單位爲美元每 100 萬 tokens，來自 API易 apiyi.com 模型總表原文。充值按 1:7 固定匯率；分組的實際折後價以登錄後的控制檯爲準，本批模型的「低至」列爲「—」。
| 模型 ID | 輸入 | 輸出 | 緩存讀 | 端點 | 分組 |
|---|---|---|---|---|---|
claude-opus-5-5 |
$4 | $20 | $0.2 | chat、messages | ClaudeCode、Claude_Reverse、Claude_Enterprise、Default、SVIP |
claude-sonnet-5-5 |
$2 | $10 | $0.1 | chat、messages | ClaudeCode、Claude_Reverse、Claude_Enterprise、Default、SVIP |
claude-fable-5-2 |
$8 | $40 | $0.2 | chat、messages | ClaudeCode、Claude_Enterprise、Default、SVIP |
gpt-6.1-sol † |
$2 | $10 | $0.1 | responses（推薦）、chat | CodexResponses、Codex_Reverse、Default、SVIP |
gpt-6.1-terra |
$1 | $5 | $0.05 | responses（推薦）、chat | CodexResponses、Codex_Reverse、Default、SVIP |
幾點補充，按 ID 分開說明：
claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-2各有一個同價的-thinking版本。claude-fable-5-2在總表裏的分組沒有 Claude_Reverse，選分組時注意，不要套用前兩個 Claude 型號的分組。gpt-6.1-sol帶 †，是階梯計價。總表原文：0 到 272,000 tokens 輸入 $2/1M；超過 272,000 tokens 輸入 $4/1M。gpt-6.1-sol和gpt-6.1-terra推薦走/v1/responses，工具調用也走 Responses。
💡 選擇建議：VibeHub 的改寫和術語解釋都是短對話，對模型能力要求不高；真正喫 Token 的是後面寫代碼的長任務。可以在 API易 apiyi.com 用同一個 Key 分別試幾種型號，比較同一需求下的效果和賬單，再決定日常用哪個。
如果想讓 Agent 自己讀懂接入方式，可以把 API易 的接入技能包裝進 Agent：npx skills add https://docs.apiyi.com，技能包說明在 docs.apiyi.com/skill.md。
使用 VibeHub 時的隱私與風險邊界
風險要分兩層看，一層是 VibeHub 的術語查詢，另一層是 Agent 本身的模型調用。
VibeHub 術語查詢這一層：按倉庫 README，術語查詢只發送經過程序脫敏的簡短描述。常見的密鑰、網址、郵箱、本地路徑和代碼塊會在發送前移除，不發送源代碼、客戶信息或整段需求。發給 vibe-hub.org 的只是類似「按鈕懸停狀態」這樣的短術語。
Agent 和模型這一層：Agent 已經讀到的項目上下文，仍然受你使用的產品和模型服務商的隱私設置約束。VibeHub 的脫敏只管它自己發出的術語查詢，管不到 Agent 發給模型的內容。
- 不要把 API Key 貼進對話。Key 應該寫進 Agent 的配置或環境變量，而不是作爲聊天內容發給模型。
- API易 的定位是 API 網關。它不是號池，也不是繞過登錄的工具，調用走的是正常的 API 計費鏈路。
- 上線前自己檢查。正如 Vibe Coding 詞條所說，能運行不等於可靠，代碼、測試和權限仍需要你過一遍。
常見問題 FAQ
Q1：VibeHub 是什麼？
VibeHub（vibe-hub.org）是作者 Oil 維護的 Vibe Coding 術語圖鑑，用大白話解釋前端、後端、AI 術語。配套的 VibeHub Skill 裝進 Agent 後，會把你的口語改寫成準確的需求，並每次最多點出 3 個相關術語。
Q2：VibeHub Skill 需要填 API Key 嗎？
不需要。倉庫 README 原文寫明「無賬號或 API Key 配置」，只需要 Node.js 20 及以上版本和聯網環境。需要 Key 的是你的 Agent 所調用的大模型，那個 Key 可以使用 API易 apiyi.com 的令牌，和 VibeHub 無關。
Q3：VibeHub 和直接讓 Agent 解釋術語有什麼區別？
直接讓 Agent 解釋，它可能一口氣講很多，也可能給出自拼的鏈接。VibeHub 規定每次最多 1 到 3 個術語，解釋緊貼當前任務，鏈接只用解析器返回的 url，查不到就說明，不編造。表達已經準確時，它也不會硬加講解。
Q4：VibeHub 適合哪些場景？
– 想描述交互效果，但說不出 Hover、Active 這類名稱；
– 不確定一個設置該做成即時生效的 Switch，還是統一保存；
– Agent 回覆裏有看不懂的概念，影響你下一句怎麼回。
它不提供學習路線和課程，想系統學習可以去網站的課程和練習入口。
Q5：裝了 VibeHub 後，Agent 的模型請求怎麼接到 API易？
1. 在 API易 apiyi.com 人工註冊賬號，拿到 API Key 和少量試用額度；
2. OpenAI 兼容 SDK 的 base_url 填 `https://api.apiyi.com/v1`；
3. Anthropic 原生 SDK 填根域名 `https://api.apiyi.com`，不要再加 `/v1`。
VibeHub 這一側不用改任何配置。
Q6：VibeHub 會把我的代碼發出去嗎？
按 README，術語查詢只發送脫敏後的短描述，密鑰、網址、郵箱、本地路徑和代碼塊會在發送前移除，不發送源代碼或整段需求。不過 Agent 看到的項目上下文仍會按你選的模型服務商的規則處理，這部分需要單獨評估。
Q7：VibeHub 有哪些限制？
它需要聯網和 Node.js 20 以上版本；術語範圍以 vibe-hub.org 收錄爲準，沒有匹配的詞不會硬編；它只管表達和術語，不會替你決定實現方案，也不保證 Agent 寫出的代碼可靠。
VibeHub Skill 核心要點 Key Takeaways
- 一句話定位：VibeHub 把口語改準，Token 花在 Agent 調用的模型上。
- 兩種安裝：發安裝話給 Agent，或運行
npx skills add oil-oil/vibe-hub-skill。 - 功能一：規範表達，保留原意，不擅自增加框架或參數。
- 功能二：主動提示，每次最多 3 個真正相關的術語。
- 費用邊界：Skill 無需 API Key，術語查詢不調用大模型。
- 接入 API易：OpenAI 兼容用
/v1，Anthropic 原生用根域名。 - 隱私分層：術語查詢會脫敏，Agent 的上下文仍走你選的模型服務商。
總結
VibeHub 解決的是 Vibe Coding 裏「說不準」和「看不懂」這兩件事：
- 把口語改準：比如「鼠標放上去變色、點下去有反饋」，會改寫成 Hover、Active、Transition 三個術語組成的需求；
- 點到爲止：每次最多補 3 個術語，解釋緊貼當前任務，不開課；
- 分清費用：Skill 本身不收 Key、不調模型，Token 都花在 Agent 的改寫、解釋和寫代碼這三步上。
安裝只需要一句話。真正需要你決定的，是 Agent 背後接哪個模型、走哪個端點。可以在 API易 apiyi.com 用一個 Key 對比上文表格里的幾個型號，再把 Agent 的請求指過去。型號與價格以平臺型號列表爲準。
📚 參考資料
- VibeHub 官網：Vibe Coding 術語圖鑑
- 鏈接：
vibe-hub.org -
說明：術語、練習、課程入口，Vibe Coding 詞條在
vibe-hub.org/vibe-coding -
VibeHub Skill 介紹頁：兩個核心功能與安裝話原文
- 鏈接：
vibe-hub.org/vibehub-skill -
說明：規範表達與主動提示的示例出處
-
GitHub – vibe-hub-skill：Skill 倉庫
- 鏈接：
github.com/oil-oil/vibe-hub-skill -
說明：README 與 SKILL.md，包含查詢方式、隱私與配置邊界
-
作者 Oil：個人站與 GitHub
- 鏈接：
oiloil.org、github.com/oil-oil -
說明：VibeHub 作者主頁
-
API易 模型總表：型號、端點、分組與價格
- 鏈接：
docs.apiyi.com/models -
說明：數據更新於 2026-11-13 12:57 （UTC+8），單位美元每 100 萬 tokens
-
API易 文檔入口與接入技能包
- 鏈接：
docs.apiyi.com/llms.txt、docs.apiyi.com/skill.md - 說明：端點選擇、節點說明和 Agent 接入方式
作者：APIYI 技術團隊
技術交流：歡迎在 API易 apiyi.com 網站首頁聯繫我們，更多接入資料可訪問 docs.apiyi.com 文檔中心
