Один файл в вашем проекте записывает, какие именно версии пакетов он получил, вплоть до контрольной суммы их содержимого, чтобы коллега поставил те же байты. Одна папка на вашей машине держит эти байты по разу на компьютер, чтобы второй проект или день без сети не стоили ничего сверх.
Версию пакета определяют четыре вещи: его группа, имя, версия и [отпечаток](../glossary/index.xml#fingerprint) каждого файла внутри. Адрес, откуда её скачали, записан только для сведения. Поэтому зеркало, переехавший репозиторий или вендоренная копия никогда не меняют [лок-файл](../glossary/index.xml#lock-file): пока байты те же, пакет тот же.
Отпечаток — ещё и ворота целостности. Если источник отдаёт под известной версией другие байты, потому что тег перезаписали силой или зеркало подменили, vibe отказывает раньше, чем что-то запишет, и говорит, какой отпечаток ждал и какой увидел.
`vibe.lock` перечисляет каждый пакет разрешённого графа, прямой и транзитивный, с точной версией, отпечатком, [реестром](../glossary/index.xml#registry), откуда он пришёл, и способом, которым его разрешили. vibe пишет его при каждой установке и обновлении; вы его коммитите и никогда не правите. Свежий клон с лок-файлом ставит тот же самый граф, а пулл-реквест, который его меняет, показывает ровно то, что сдвинулось.
Лок-файл сохраняется, даже когда выведенное состояние удалено: `vibe clean` стирает дерево зависимостей и сгенерированные стартовые файлы, но лок не трогает, потому что лок — это записанное решение, а дерево — только его следствие.
Каждый пакет, который vibe скачивает для любого проекта, попадает в одно [хранилище](../glossary/index.xml#store) в вашем домашнем каталоге, `~/.vibe/cache/`, с ключом по идентичности пакета, а не по тому, откуда он пришёл. Версия, скачанная для одного проекта, доступна каждому другому проекту на машине, какие бы реестры они ни настроили, и хранилище никогда не очищается у вас за спиной: освободить место — это команда, которую запускаете вы.
Хранилище можно прогреть намеренно. `vibe cache add` скачивает пакет и всё, от чего он зависит, не касаясь ни одного проекта; так готовятся к перелёту и так машина получает руководство пакета для чтения без сети. `vibe cache list` показывает, что лежит в хранилище; `vibe cache check` сверяет каждую запись с её отпечатком.
`vibe cache clean` освобождает место: всё целиком, по возрасту или по пакету, и только когда вы скажете, что именно.
С `--offline` или с `VIBE_OFFLINE=1` в окружении vibe не касается сети вовсе. Подбор версий и скачивание обслуживаются из хранилища, локальных зеркал, собственного дерева зависимостей проекта и путевых источников. Всего, чего там нет, — жёсткая ошибка с именем недостающего пакета; vibe никогда молча не ставит частичный результат.
Версией в хранилище можно пользоваться, даже если её больше не перечисляет ни один реестр. Хранилище держит байты, которые проверили, когда они пришли; замолчавший реестр не делает их хуже.
Папка настроек, включая хранилище, — это `~/.vibe/` на любой платформе; переменная окружения `VIBE_SETTINGS` переносит всю папку, и так тесты и сборочные серверы держат приватную копию.
Хранилище и кэш клонов реестров — две разные папки: хранилище держит распакованные версии пакетов, кэш клонов под `~/.vibe/registries/` держит git-чекауты, которыми их скачивают. Очистка одной не очищает другую.