Вы нашли пакет, которому должен следовать ваш проект. Эта страница добавляет его в проект, записывает точную версию и показывает, как проверить, что агент теперь будет его читать.
Агент выполняет `vibe install org.vibevm.world/wal`. vibe обходит [реестры](../glossary/index.xml#registry) проекта по порядку и спрашивает у первого, который знает пакет, его версии; без ограничения он берёт новейший стабильный выпуск. Он разрешает собственные зависимости пакета вместе с остальным графом проекта, скачивает всё, чего ещё нет в машинном [хранилище](../glossary/index.xml#store), и сверяет каждый [отпечаток](../glossary/index.xml#fingerprint). Потом печатает план: какие пакеты будут добавлены в каких версиях и какие файлы изменятся. Пока вы не подтвердили, ничего не записывается. После подтверждения vibe копирует пакеты в `vibevm/vibedeps/`, записывает требование в `vibe.toml` и пины в `vibe.lock` и пересобирает стартовые файлы. Затем агент запускает `vibe tree`, чтобы показать вам новый список чтения.
1. Установите по [координате](../glossary/index.xml#coordinate). Добавьте `@` и ограничение, чтобы попросить диапазон или точную версию:
2. Подтвердите план, когда спросят. `--assume-yes` отвечает «да» за скрипты и агентов.
3. Проверьте, что записано и что агент будет читать:
`vibe install org.vibevm.world/wal@^1.0` принимает любую 1.x; `@=1.0.0` — ровно одну; `--exact` записывает разрешённую версию в [манифест](../glossary/index.xml#manifest) точным пином вместо диапазона. Манифест хранит ограничение, о котором вы просили; [лок-файл](../glossary/index.xml#lock-file) хранит версию, которую вы получили.
Префикс вида, как в `flow:org.vibevm.world/wal`, необязателен; когда он есть, vibe его проверяет: если пакет оказывается другого вида, установка останавливается.
`vibe install` без имён пакетов ставит то, что манифест уже требует, в версиях, которые закрепил лок-файл. Когда ни манифест, ни лок не менялись с прошлой установки, vibe даже не запускает резолвер: лок-файл и есть ответ, а команда только проверяет, что дерево ему соответствует.
Установка пакета по имени разрешает весь граф заново, но каждая зависимость, которой изменение не касается, сохраняет закреплённую версию; только настоящий конфликт запускает полный пересчёт.
Пакет может объявить скрипт, который выполняется после его установки. Установить пакет — значит согласиться его запустить; скрипт работает внутри собственной папки пакета, и его последствия не отслеживаются. Прочитайте манифест пакета, которому не доверяете, прежде чем ставить его.
Уже установленный пакет не ставится второй раз: vibe говорит об этом и указывает на `vibe update`.
Публичный реестр, который на отсутствующий пакет отвечает ошибкой аутентификации, обходится стороной и не считается сбоем; добавьте `--auth-required` в скрипт, который должен заметить, что приватный реестр лежит.
Пакет, который приносит инструменты, записывается при установке и собирается по требованию: `vibe bin build` компилирует названные инструменты или все сразу из точно установленного пакета, а `vibe bin exec <name>` разрешает инструмент через лок-файл проекта до его папки и запускает, при необходимости сначала собрав. Установить пакет — значит согласиться на сборку, и vibe рассказывает, что собирается компилировать. Без сети сборка, которой нужны крейты из сети, падает так же, как падает Cargo, с ручным рецептом в подсказке. Когда вашему коду нужен поставленный крейт, ссылайтесь на него путём в папку пакета и держите `vibevm/vibedeps/` вне своего Cargo-workspace, потому что папка не может принадлежать двум workspace сразу.