От автора: VibeHub Skill превращает разговорную речь в требование, которое агент может выполнить напрямую, и каждый раз добавляет не больше трёх релевантных терминов. В статье объясняется, как его установить, как использовать обе функции, куда на самом деле уходят токены и как подключить запросы к моделям через APIYI.
Сразу к сути: VibeHub отвечает за то, чтобы ваша формулировка стала точной, а токены уходят на модели, которые вызывает агент, а не на собственные запросы VibeHub.
При работе с агентом в Vibe Coding обычно бывает две ситуации. Первая: вы говорите «при наведении на эту кнопку цвет должен меняться, а при нажатии нужна обратная связь», агент понимает по-своему, и результат получается не тем. Вторая: в ответе агента появляются слова Tooltip, Hover, оптимистичное обновление — вы не понимаете, что это, и не знаете, что отвечать дальше. VibeHub Skill как раз решает эти две проблемы, и у него есть чёткая граница: за один раз он добавляет не больше трёх действительно релевантных терминов.
Он не станет читать вам курс по фронтенду. В README репозитория прямо сказано: он не предлагает учебную траекторию, план курса или локальные упражнения и не превращает простое требование в туториал.
После прочтения вы получите: одну фразу для установки, которую можно сразу отправить агенту; описание использования и границ каждой из двух функций; разницу между «этот Skill сам не запрашивает API-ключ» и «агент, в который его установили, всё равно расходует токены модели»; а также какие адреса использовать при подключении токенов агента к APIYI через OpenAI-совместимый интерфейс и нативный Anthropic.
Что такое VibeHub: справочник терминов Vibe Coding, который помогает агенту понимать разговорную речь
Сайт VibeHub — vibe-hub.org. На китайской главной странице он представлен как «справочник терминов Vibe Coding, который помогает простыми словами разобраться в терминах фронтенда, бэкенда и ИИ». В навигации есть разделы «Термины», «Практика», «Курсы», «Как избежать AI-стиля», «Обновления», «Skill» и «Чат сообщества». Автор — Oil; ссылки на его личный сайт и страницу GitHub — в материалах в конце статьи.
На сайте есть и статья о самом Vibe Coding: вы формулируете задачу для ИИ на естественном языке, ИИ пишет код, а затем по результатам запуска продолжаете итеративно улучшать решение. По-китайски это часто называют «атмосферным программированием» или «программированием по ощущениям». В статье есть фраза, которую стоит запомнить: то, что код запускается, ещё не значит, что он надёжен — перед релизом по-прежнему нужно проверять код, тесты и права доступа. Эта мысль справедлива и для всех воркфлоу агентов, о которых пойдёт речь ниже.
| Пункт | Описание | Что это даёт |
|---|---|---|
| Сайт | vibe-hub.org, визуальный справочник терминов (в оригинале на странице Skill: 360 визуализированных терминов) | Если встретился незнакомый термин, можно найти объяснение простыми словами |
| Репозиторий Skill | GitHub oil-oil/vibe-hub-skill, лицензия MIT |
Позволяет агенту автоматически применять правила терминологии в диалоге |
| Функция 1 | Нормализация формулировок: превращает разговорную просьбу в готовое к отправке требование | Меньше недопонимания со стороны агента |
| Функция 2 | Активные подсказки: за раз указывает не более 3 связанных терминов | Вы понимаете ответ и знаете, что сказать дальше |
| Границы расходов | Skill сам не настраивает аккаунт и API-ключ | Токены расходуются только на модель, которую вызывает агент |
Как VibeHub Skill и сайт VibeHub делят обязанности
Разделение обязанностей прямо описано в README репозитория: содержание терминов поддерживается на vibe-hub.org, а в репозитории остаются только правила формулирования и парсер терминов. То есть сайт отвечает за то, «что означает термин и какая картинка к нему идёт», а Skill — за то, «когда термин стоит упомянуть, как переписать вашу фразу и откуда взять ссылку».
В каталоге skills/vibehub/ репозитория лежат четыре файла: SKILL.md задаёт правила формулирования, agents/openai.yaml — конфигурация для хоста агента, scripts/vibehub.mjs — скрипт разбора терминов, vibehub.config.json — конфигурация парсера. Весь Skill не содержит логики вызова модели — именно это определяет, где расходуются токены, о чём пойдёт речь ниже.
Как за минуту установить VibeHub Skill
Для установки не нужно регистрировать аккаунт и вписывать какие-либо ключи. Судя по границам конфигурации в 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-ключ, потому что Skill запускает только собственный скрипт разбора терминов.
| Параметр конфигурации | Требование VibeHub Skill | Источник |
|---|---|---|
| Среда выполнения | Node.js 20 или выше | README репозитория |
| Сеть | Нужен доступ в интернет (запрос терминов на vibe-hub.org) | README репозитория |
| Аккаунт / API-ключ | Аккаунт и API-ключ не требуются | README репозитория |
| Лицензия | MIT | README репозитория |
| Формат команды разбора | node skills/vibehub/scripts/vibehub.mjs resolve плюс один или несколько --query, можно добавить --compact |
README репозитория |
Как отправляются запросы терминов VibeHub
Парсер не отправляет всю фразу запроса напрямую в поисковый интерфейс. Логика такая: Agent сначала по текущему контексту выдвигает кандидатов-термины, а затем одним пакетным запросом проверяет названия и ссылки. При высокой уверенности проверяется только один вариант, при неоднозначности сравниваются максимум три.
Правила работы со ссылками жёсткие: используется только url, который вернул парсер, — ничего не склеивается вручную и не подделывается; если совпадений нет, так прямо и говорится, без выдуманных терминов и ссылок. Поэтому все ссылки VibeHub, которые вы видите в ответе, — это то, что реально вернул интерфейс запросов.
🚀 Совет для быстрого старта: после установки VibeHub Agent на каждом шаге переписывания и объяснения обращается к большой языковой модели. Если хотите использовать один ключ в разных Agent’ах и видеть единый счёт, сначала зарегистрируйте аккаунт в APIYI 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, Skill объясняет только понятия, которые сильнее всего влияют на твоё следующее решение: не переводит слово за словом весь абзац и не устраивает лекцию по собственной инициативе.
Принципы работы из README сводятся к четырём: сначала дать результат, который можно сразу использовать, а потом объяснять термины; сохранять смысл, который вложил пользователь; за один раз не больше 1–3 терминов; если формулировка уже точная — не навязывать обучение. Последний пункт особенно практичный: если ты и так сказал всё понятно, Skill не станет лишний раз вмешиваться.
На каком шаге на самом деле расходуются токены VibeHub Skill
Вот где проще всего запутаться. VibeHub Skill сам не принимает API-ключ, и запрос терминов — это тоже не вызов большой языковой модели. Скрипт-парсер всего лишь отправляет один пакетный запрос на vibe-hub.org и получает обратно названия терминов и ссылки.
Токены по-настоящему расходует Agent, в которого установлен этот Skill. Переформулировать твою устную речь, объяснить термины простым языком, а потом собрать страницу — все эти три шага являются вызовами модели. Skill делает входные и выходные данные этих вызовов точнее, но расходы на себя не берёт, и сами вызовы никуда не исчезают.
Так что пополнять баланс и выбирать модель нужно для сервиса модели, который стоит за Agent, а не для открытия счёта на сайте VibeHub. В help-apiyi уже есть статья «Откуда берётся счёт за токены в длинных задачах Agent» — там подробно разбирается, как префиксный кэш влияет на счёт в длинных задачах, здесь повторяться не будем.
| Шаг | Кто выполняет | Вызывается ли большая языковая модель | Расходуются ли токены модели |
|---|---|---|---|
| Определение терминов-кандидатов | Agent | Да | Да |
| Пакетный запрос терминов и ссылок | скрипт-парсер VibeHub → vibe-hub.org | Нет | Нет |
| Переформулировка устного запроса | Agent | Да | Да |
| Объяснение терминов простым языком | Agent | Да | Да |
| Написание кода и правка страницы по запросу | Agent | Да | Да |
Вывод из схемы выше: запросы Agent к модели можно направить на APIYI apiyi.com — один ключ и один общий баланс одновременно покрывают и модели семейства Claude, и модели семейства GPT, а на стороне VibeHub ничего менять не нужно.
С помощью APIYI: смотрим модели, сверяем цены и направляем туда запросы Agent
APIYI — это API-шлюз, а не хостинг моделей. Один ключ и один общий баланс — и можно вызывать модели сразу нескольких провайдеров. Аккаунт регистрируется вручную; после регистрации даётся небольшой пробный лимит, а бесплатной маршрутизации моделей на платформе нет. Полный список моделей и цен — в общем каталоге моделей docs.apiyi.com/models, данные берутся из системного интерфейса ценообразования в реальном времени.
Эндпоинт выбирается по SDK, а не по модели
Когда направляете запросы Agent в APIYI, сначала посмотрите, какой SDK использует ваш Agent, и только потом заполняйте соответствующий адрес:
- Совместимость с 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. Если вы одновременно работаете с несколькими Agent — Claude Code, Codex и другими, — в руководстве help-apiyi «Пошаговая инструкция: один ключ подключает все Agent, единый вход в API-шлюз через открытый magpie» рассказано, как настроить единый доступ.
Цены популярных моделей для Vibe Coding (по сводной таблице)
Данные в таблице обновлены 13.11.2026, 12:57 (UTC+8). Цены указаны в долларах США за 1 млн токенов и взяты из исходной сводной таблицы моделей APIYI 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 токенов на ввод — $2/1M; свыше 272 000 токенов на ввод — $4/1M. - Для
gpt-6.1-solиgpt-6.1-terraрекомендуется использовать/v1/responses; вызовы инструментов тоже идут через Responses.
💡 Рекомендация по выбору: переписывание текста и объяснение терминов в VibeHub — это короткие диалоги, и к возможностям модели там высоких требований нет. А вот основные токены уходят на длинные задачи по написанию кода. Можно в APIYI apiyi.com с одним и тем же Key попробовать несколько моделей, сравнить результат и счёт на одном и том же запросе, а потом решить, какую использовать каждый день.
Если хотите, чтобы Agent сам разобрался, как подключаться, можно добавить в него набор навыков интеграции APIYI: npx skills add https://docs.apiyi.com. Описание набора навыков — в docs.apiyi.com/skill.md.
Границы конфиденциальности и рисков при использовании VibeHub
Риски стоит рассматривать на двух уровнях: первый — запросы терминов в VibeHub, второй — вызовы моделей самим агентом.
Уровень запросов терминов в VibeHub: согласно README репозитория, запрос термина отправляет только краткое описание, прошедшее программное обезличивание. Распространённые ключи, ссылки, адреса электронной почты, локальные пути и блоки кода удаляются перед отправкой; исходный код, данные клиентов и целые куски требований не передаются. На vibe-hub.org уходит лишь короткий термин вроде «состояние наведения кнопки».
Уровень агента и модели: контекст проекта, который агент уже прочитал, по-прежнему ограничен настройками конфиденциальности используемого вами продукта и провайдера модели. Обезличивание в VibeHub касается только его собственных запросов терминов и не распространяется на то, что агент отправляет модели.
- Не вставляйте API-ключ в диалог. Ключ должен быть записан в конфигурацию агента или переменные окружения, а не уходить модели как часть сообщения.
- APIYI позиционируется как API-шлюз. Это не пул аккаунтов и не инструмент для обхода авторизации — вызовы идут по обычной цепочке тарификации API.
- Перед релизом проверьте всё сами. Как сказано в статье про Vibe Coding, «работает» ещё не значит «надёжно»: код, тесты и права доступа всё равно нужно просмотреть самому.
Частые вопросы (FAQ)
Q1: Что такое VibeHub?
VibeHub (vibe-hub.org) — это иллюстрированный словарь терминов Vibe Coding, который поддерживает автор Oil и объясняет фронтенд, бэкенд и AI-термины простым человеческим языком. Если установить VibeHub Skill в агента, он будет переписывать вашу разговорную формулировку в точное требование и каждый раз указывать не более 3 связанных терминов.
Q2: Нужно ли заполнять API Key для VibeHub Skill?
Нет. В README репозитория прямо написано: «без настройки аккаунта или API Key», нужны только Node.js версии 20 и выше и доступ в интернет. Ключ нужен для большой языковой модели, которую вызывает ваш агент; этот ключ может быть токеном APIYI apiyi.com и к VibeHub отношения не имеет.
Q3: Чем VibeHub отличается от простого объяснения терминов агентом?
Если просто попросить агента объяснить, он может выдать много всего сразу или дать ссылки, которые сам же и составил. VibeHub ограничивает выдачу 1–3 терминами за раз, объяснение привязано к текущей задаче, а ссылки берутся только из url, который вернул парсер; если ничего не найдено, он так и скажет, а не станет выдумывать. Если формулировка уже точная, он не будет навязчиво добавлять разъяснения.
Q4: В каких случаях VibeHub подходит?
— Хочется описать эффект взаимодействия, но не можете вспомнить названия вроде Hover или Active;
— Не уверены, делать ли настройку в виде Switch с мгновенным применением или сохранять всё разом;
— В ответе агента встречаются непонятные понятия, и от них зависит, что вы напишете в следующей реплике.
Он не даёт учебных маршрутов и курсов; для системного обучения заходите в разделы курсов и упражнений на сайте.
Q5: После установки VibeHub как направить запросы модели агента в APIYI?
1. Вручную зарегистрируйте аккаунт на APIYI apiyi.com, получите API Key и небольшой пробный лимит;
2. В OpenAI-совместимом SDK в поле base_url укажите `https://api.apiyi.com/v1`;
3. В нативном SDK Anthropic укажите корневой домен `https://api.apiyi.com`, больше не добавляйте `/v1`.
На стороне VibeHub ничего менять не нужно.
Q6: Отправляет ли VibeHub мой код наружу?
Согласно README, при запросе терминов отправляется только обезличенное короткое описание; ключи, URL, адреса электронной почты, локальные пути и блоки кода удаляются перед отправкой, исходный код или целый текст требования не передаются. Однако контекст проекта, который видит агент, всё равно обрабатывается по правилам выбранного вами провайдера модели — этот момент нужно оценивать отдельно.
Q7: Какие у VibeHub ограничения?
Нужны интернет и Node.js версии 20 и выше; охват терминов ограничен тем, что собрано на vibe-hub.org, и при отсутствии совпадения он не станет ничего выдумывать; он отвечает только за формулировки и терминологию, не выбирает за вас план реализации и не гарантирует надёжность кода, который напишет агент.
VibeHub Skill: ключевые моменты
- Одной фразой: VibeHub делает разговорную речь точнее, а токены тратятся на модели, которые вызывает Agent.
- Два способа установки: отправить Agent сообщение с просьбой установить или выполнить
npx skills add oil-oil/vibe-hub-skill. - Функция первая: нормализация формулировок с сохранением исходного смысла — без самовольного добавления фреймворков и параметров.
- Функция вторая: проактивные подсказки — не более 3 действительно релевантных терминов за раз.
- Границы расходов: Skill не требует API-ключа, запрос терминов не вызывает большую языковую модель.
- Подключение к APIYI: для OpenAI-совместимого интерфейса используйте
/v1, для нативного Anthropic — корневой домен. - Уровни приватности: запросы терминов деперсонализируются, а контекст Agent по-прежнему идёт через выбранного вами провайдера модели.
Итог
VibeHub решает две проблемы Vibe Coding — «не могу точно сказать» и «не понимаю»:
- Делает разговорную речь точнее: например, «подвести мышь — меняется цвет, нажать — есть отклик» превращается в требование из трёх терминов — Hover, Active, Transition;
- Знает меру: за раз добавляется не больше 3 терминов, объяснение привязано к текущей задаче, без лекций;
- Разделяет расходы: сам Skill не требует ключа и не вызывает модели — токены уходят на три шага Agent: переформулировку, объяснение и написание кода.
Установка — одно сообщение. А вот что действительно нужно решить вам: какую модель подключает Agent и через какой эндпоинт идёт запрос. Можно взять один ключ в APIYI apiyi.com, сравнить несколько моделей из таблицы выше и направить запросы 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
-
Сводная таблица моделей APIYI: модели, эндпоинты, группы и цены
- Ссылка:
docs.apiyi.com/models -
Описание: данные обновлены 2026-11-13 12:57 (UTC+8), единица — доллары США за 1 млн токенов
-
Документация APIYI: точка входа и пакет навыков интеграции
- Ссылки:
docs.apiyi.com/llms.txt,docs.apiyi.com/skill.md - Описание: выбор эндпоинта, описание узлов и способы подключения агента
Автор: техническая команда APIYI
Для связи по техническим вопросам: будем рады обратной связи — свяжитесь с нами на главной странице сайта APIYI apiyi.com; дополнительные материалы по интеграции доступны в центре документации docs.apiyi.com
