Документацию пакетов, которыми вы пользуетесь, включая приватные, можно читать на собственной машине, ничего никуда не отправляя. Эта страница скачивает руководство на вашу машину и открывает читалку в браузере.
Агент выполняет `vibe cache add org.vibevm.core/vibevm-docs`. Пакет документации никогда не ставится в проект; он прогревается в машинное [хранилище](../glossary/index.xml#store) вместе с пакетами, которые описывает, чтобы каждое правило, которое он цитирует, разрешалось без сети. Затем агент выполняет `vibe doc serve`: vibe запускает маленький веб-сервер, который слушает только на вашей машине, отрисовывает каждую страницу из хранилища по запросу и печатает адрес. Пока вы читаете, из интернета ничего не скачивается, и ни одна страница не покидает машину.
1. Прогрейте хранилище. Внутри проекта источник — его [реестры](../glossary/index.xml#registry); вне проекта — реестры всей машины:
2. Запустите читалку и откройте напечатанный адрес в браузере. Остановите её через Ctrl+C:
3. Выберите язык переключателем на любой странице. Там, где у страницы нет перевода, читалка показывает язык самого руководства и говорит об этом.
Та же читалка показывает документацию пакетов из приватного реестра или только с вашей машины: что лежит в хранилище, то она и отрисовывает. Это и есть задуманный путь для проприетарной документации, и потому читалка никогда не обращается к публичному сайту.
Выпущенный `vibe` несёт интерфейс читалки внутри бинарника. `vibe`, собранный из исходников, несёт простую запасную оболочку; `vibe doc shell install` скачивает полный интерфейс для своей версии из ассетов выпуска в `~/.vibe/opt/`, проверив размер и отпечаток, и только по вашей просьбе. Без него читалка работает, просто скромнее, а `vibe doc serve --print-shell` говорит, какую из двух оболочек она держит.
Прогрев пакета документации прогревает и его [предметы](../glossary/index.xml#subject), так что правила, которые цитирует страница, разрешаются без сети.
Внутри проекта, чей локальный реестр держит пакет прямо в дереве, `vibe cache add --offline` прогревает его без сети. Язык читалки берётся из `[i18n].preferred` проекта или из флага при запуске.
На сайте та же страница живёт под `/doc/`: язык идёт следующим сегментом пути, а у языка источника префикса нет. Адрес с номером версии показывает текущее содержимое этой версии, потому что версию могут опубликовать заново, а реестр не хранит прошлых публикаций.
Читалку может встроить плагин редактора через iframe; тогда плагин передаёт при запуске собственный origin, и читалка принимает фреймы только из него.
Агент читает то же хранилище: `vibe explain "spec://org.vibevm.core/vibevm-docs-ru/start/what-vibevm-is"` печатает страницу или блок текстом.