作者注：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 文档中心
