Пакет может встроиться в сборку: выполнить шаг, преобразовать этап или передать задачу агенту. Эта страница объясняет, как такие встраивания объявляются, как проект их включает и как увидеть, какие из них выполнились и почему.
[Жизненный цикл](../glossary/index.xml#lifecycle) открывает именованные *[точки расширения](../glossary/index.xml#extension-point)*, строки вида `family:name`. Семейство `phase:`, группа точек с общим префиксом, — это девять [фаз](../glossary/index.xml#phase). Семейство `slot:` называет места внутри фазы, куда стек или дисциплина ожидает что-то встроить. Семейство `compile:` — собственный конвейер компилятора стартовой полосы, где пакет может преобразовать текст, который прочитает агент. *[Вклад](../glossary/index.xml#contribution)* привязывает [обработчик](../glossary/index.xml#handler) к точке и объявляется в [манифесте](../glossary/index.xml#manifest) таблицей `[[extension]]`, в пакете или в самом проекте.
У вклада есть идентификатор, он же ключ, по которому проект выключает или заменяет вклад; один обработчик можно привязать несколько раз под разными идентификаторами с разной конфигурацией.
| Вид | Что выполняется |
| `builtin` | обработчик, вкомпилированный в vibe, например журнал |
| `script` | скрипт оболочки или PowerShell, который поставляет пакет; выбирается по платформе |
| `binary` | программа, которую доставляет пакет и собирает vibe при установке |
| `native` | динамическая библиотека, загружаемая в процесс через C ABI, из точной готовой сборки для платформы |
| `agent` | промпт: работа, переданная агенту-хозяину, или настроенному провайдеру модели, когда vibe запускает человек за терминалом |
Каждый обработчик получает один конверт контекста, версионированный JSON-документ, который называет проект, фазу, произведённые к этому моменту артефакты и конфигурацию вклада, и отвечает конвертом ответа, который может объявить новые артефакты. Конверт — это то, как фазы говорят друг с другом.
Нативный обработчик — динамическая библиотека ровно с четырьмя символами C; запрос и ответ пересекают эту границу как версионированный JSON, по одному семейству на библиотеку, а крейт `vibe-ext` даёт автору безопасные макросы, чтобы ни один `unsafe` не писался руками. Обработчик с закрытым исходным кодом поставляется готовой сборкой для каждой платформы; точная готовая сборка побеждает, объявленный исходник может собраться вместо неё, а отсутствие — отказ, а не пропуск. Преобразование `compile:` выполняется внутри регенерации полосы, поэтому им может быть только builtin или допущенный нативный обработчик, никогда скрипт, бинарник или агент. Вклад, которому нужен низкоуровневый ярус проходов, говорит об этом флагом `compiler_internals = true`, и ему всё равно нужна активация со стороны хозяина.
Установить пакет — значит согласиться на выполнение его вкладов: вклады зависимости в фазы и слоты активны, как только пакет установлен. Манифест потребителя может активировать вклад, который не включается сам, выключить вклад по идентификатору или [переопределить](../glossary/index.xml#override) его конфигурацию. Диалогов согласия во время выполнения нет; вместо них полная прозрачность.
Внутри одной точки вклады выполняются в фиксированном порядке: сначала встроенные привязки действующего пресета, затем вклады пакетов в порядке зависимостей, затем собственные вклады проекта; порядок выводится, а не обсуждается.
`vibe extensions` перечисляет каждый объявленный вклад в установленном мире с его точкой, обработчиком и происхождением; `--json` отдаёт то же сканеру. Всё, что вклад может сделать, объявлено, так что сканеру не нужно ничего выполнять, чтобы проверить проект. Каждый прогон перед стартом печатает вклады, которые выполнит, а сам прогон можно проследить проход за проходом флагом `--trace-compile` в `.vibe/trace/`.
`vibe tools` перечисляет бинарники и серверы, которые принесли установленные пакеты; это [реестр](../glossary/index.xml#registry) того, что может назвать вклад вида `binary`.
Вкладу вида `agent` нужен кто-то, кто выполнит его промпт. Под агентом-хозяином vibe откладывает задачу для этого агента и продолжает, когда объявленные результаты появились. За терминалом vibe может вызвать настроенного провайдера модели, и первый из них — любая конечная точка, совместимая с OpenAI; учётные данные провайдера он читает только тогда, когда несвежий агентный шаг действительно доходит до вызова. Каждая функция, которую улучшает модель, объявляет, выключена ли она, помогает или обязательна, и по умолчанию она выключена.
Вклад может нести селектор, который ограничивает его подходящими файлами или целями, так что форматер привязывается к исходникам одного языка, а не ко всему дереву.
Нативный обработчик пересекает границу из C и JSON, а не Rust ABI, так что библиотека, собранная другой версией тулчейна, всё равно загружается.
У включённой работы модели есть потолки на прогон по числу вызовов и токенов; шаг, который их превысил бы, останавливается, а не тратит.