Local AI Toolkit

Как пользоваться из консоли

Оглавление · English version

На этой странице

Шаг 1. Как вообще запускать

Всё идёт через launcher — стабильную точку входа, которая не меняется при обновлении. Каталог версии внутри bin\versions\ меняется с каждым релизом, поэтому прописывать пути туда не надо ни в скриптах, ни в клиентах:

& "$env:LOCALAPPDATA\LocalAi\bin\launcher\localai-launcher.exe" run <команда>

Чтобы не повторять это каждый раз, заведите псевдоним на сессию:

function lai { & "$env:LOCALAPPDATA\LocalAi\bin\launcher\localai-launcher.exe" run @args }

Дальше в примерах — lai <команда>.

Шаг 2. Откуда запускать

Из любой папки. Команды, работающие с репозиторием, принимают --root:

lai localai repo status --root C:\work\myapp

Если --root не указан, берётся репозиторий, содержащий текущую папку. То есть можно и так:

cd C:\work\myapp
lai localai repo status

Worktree — это тот же репозиторий. Репозиторий опознаётся по общему git-каталогу, поэтому все его рабочие деревья, Claude, Codex и командная строка видят один и тот же индекс. Но --root для сборки указывайте то дерево, которое правите: overlay строится под конкретное состояние файлов.

Шаг 3. Подключить репозиторий

Индексация включается для каждого репозитория отдельно. Пока не попросите — не читается ничего.

lai localai repo status --root C:\work\myapp
NOT_CONFIGURED: C:\WORK\MYAPP\.GIT — предложите CodeSearch, LocalLm, общий брокер, поколения основной ветки, overlay веток, хуки, MCP для Claude и MCP для Codex.

Подключаем и ставим хуки:

lai localai sync --root C:\work\myapp
lai localai hooks install --root C:\work\myapp

Первая сборка читает репозиторий и показывает текущий проход индексации. localai repo status --follow сообщает фазу, GUID исходной операции, указанную и текущую рабочую копию, число завершённых проходов и их общее число. Если число чанков, скорость и оставшееся время известны, они относятся к текущему проходу. Эти показатели для всей операции остаются неизвестными. Чтобы запросить отмену работающей операции, используйте показанный GUID исходной операции: localai sync cancel --root <root> --operation <GUID>. Другой GUID отклоняется. Запрос отмены ещё не означает, что работа остановилась; продолжайте следить за статусом. Таймаут ожидания MCP также оставляет состояние выполнения неизвестным.

Хуки дальше держат индекс свежим сами: после коммита, checkout, merge и rebase. Чужие хуки не затираются — Local AI встраивается в цепочку и зовёт их первыми.

Проверяем:

lai codesearch status --root C:\work\myapp

Шаг 4. Пользоваться

Полный список команд — в таблице «Что доступно из командной строки». Ниже — как они выглядят в работе.

Найти код по смыслу

lai codesearch search --query "кто подписан на завершение задания брокера" --top 3

Вот что напечатал запуск 2026-09-06; номера строк и оценки сдвигаются вместе с кодом:

src\LocalAi.Broker.Core\DurableQueue.cs:1318-1323  [Method]  cos=0.616
  IBrokerQueue.CompleteAsync
  Task CompleteAsync( Guid jobId, string workerId, Guid leaseId, JsonElement body, …)
  chunk_id: cs1.AUAwZWNjOTAx…

src\LocalAi.Contracts\LocalRunObserver.cs:27-27  [Type]  cos=0.604
  BrokerJobPending
  public sealed record BrokerJobPending(bool Running): LocalRunStep
  chunk_id: cs1.AUAwZWNjOTAx…

Слова «подписка» в найденном коде нет — совпало по смыслу. cos показывает, насколько близко; chunk_id отдаётся в codesearch get-chunk, чтобы забрать фрагмент целиком:

lai codesearch get-chunk --id cs1.AUAwZWNjOTAx…

Навигация по найденному символу

Когда нужный участок кода найден, переходите по его связям вместо нового поиска. Нумерация строк и столбцов начинается с 1 и совпадает с результатами поиска и редактором. Используйте актуальную начальную строку из результата поиска; в примерах ниже для CompleteAsync указана строка 346:

lai localai semantic references --path src/LocalAi.Broker.Core/DurableQueue.cs --line 346 --column 1
lai localai semantic implementations --path src/LocalAi.Broker.Core/DurableQueue.cs --line 346 --column 1

Спросить про известные файлы

lai localai ask "Перечисли публичные члены этого класса, по одному в строке." src/CodeSearch.Core/Chunking/GenericTextChunker.cs

Для извлечения и классификации можно включить проверку плоского JSON-объекта: --profile Extraction (или Classification) и --schema contract.json. В MCP ask_local тот же JSON передаётся строкой в необязательном outputSchema. Например, для классификации переданного issue в bug или question:

{"schemaVersion":1,"fields":[{"name":"label","type":"String","allowedValues":["bug","question"]}]}
lai localai ask "Классифицируй issue." issue.txt --profile Classification --schema contract.json --json

Версия 1 — ограниченный контракт плоского объекта, не общий JSON Schema: до 64 полей с учётом регистра, типы String, Integer (знаковый Int64), Number, Boolean. required по умолчанию true; allowedValues задаёт точный список строк. Вложенные значения, null, лишние или повторные поля, Markdown-ограждения и текст вокруг JSON не проходят проверку. Схема ограничена 32 768 символами, ответ — 1 048 576. Неизвестные параметры схемы отклоняются до вызова модели. Отмена сохраняется.

Брокер проверяет каждую попытку, включая fallback. С --json при успехе добавляется data.validation, а отклонённый результат завершается с кодом 65, error.code=result_rejected и error.validation, без данных ответа. Без --json при успехе в stderr выводится validation: <статус>, а отклонённый результат завершается с кодом 65, выводит в stderr result_rejected: с результатом проверки и ничего не пишет в stdout. MCP возвращает {answer,validation} внутри границы untrusted-content. Статусы: Valid, Empty, InvalidJson, SchemaMismatch; разобранное value есть только при Valid. Отклонённый ответ не получает оценки экономии облачных токенов. Valid подтверждает структуру, а не правильность классификации или фактов — их нужно сверять с источником. Без схемы формат CLI/MCP сохраняется, а брокер фиксирует NotRequested. Для нового режима нужно обновить и клиент, и брокер. Полный перевод по-прежнему использует собственный валидатор; успешный ответ брокера его не заменяет.

Ответ модели выводится в stdout. Отдельное сообщение об использовании токенов в stderr содержит идентификатор вызова, фактически использованные модели, длительность и одну оценку экономии токенов (либо дополнительных затрат). Внутренние значения INPUT и OUTPUT остаются в отчёте. Это версионированное сравнение контекста запроса runtime-request-context-v2, а не расход аккаунта: INPUT сравнивает явно указанный вход задачи после отбора и усечения с аргументами и доступным облачной модели ответом инструмента. Локальный ответ не получает зачёта за предполагаемую облачную генерацию; OUTPUT учитывает только генерацию запроса инструмента. Разница может быть отрицательной; сбой, непрошедший проверку или недоставленный результат не получает оценки экономии. Последующий облачный ответ и внешнее транспортное оформление исключены с обеих сторон. В методике cloud-comparison-v2 MCP считает имя инструмента и аргументы в JSON, декодированный текст ответа (включая строку отчёта) и JSON структурированного результата, разделённые переводами строк. JSON содержит символы Unicode вместо транспортного экранирования. Скрытые _meta запроса и результата исключены. Объём ответа в байтах и символах по-прежнему измеряется по полному сериализованному результату, включая метаданные. При нетекстовых блоках ответа оценка его токенов неизвестна: закодированные байты не считаются текстовыми токенами. CLI считает сериализованные аргументы и stdout, затем stderr, включая строку отчёта. Это явно заданные представления для сравнения, а не измерение контекста модели в конкретном клиенте: оформление клиента и удаление им повторов между текстом и структурированным результатом неизвестны.

Текст считает встроенный словарь microsoft-ml-tokenizers-2.0.0:o200k_base, проверенный по независимым эталонным значениям. Для изображений применяется openai-gpt-4o-tiles-v1 с высокой детализацией; для PDF сравниваются отрисованные страницы, а не загрузка PDF провайдеру. Совпадение этих профилей с облачной моделью аккаунта не предполагается. Повтор одного исходного блока внутри вызова учитывается один раз; разбор лога исключает перекрытия фрагментов. Разные срезы без точного расположения либо текстовое и графическое представления одного источника делают базу сравнения неизвестной, а не дают двойной зачёт. Поиск кода и документов не доказывает, сколько исходного контекста потребовалось бы облаку: уведомление показывает объём обмена и неизвестную экономию. Чтение полного файла ради хэша или попадания не даёт зачёта за весь файл. При нехватке данных остаётся «неизвестно» с причиной; для служебных операций и перевода только кода — «неприменимо».

По умолчанию используется Unknown: инструмент не знает историю облачного контекста. Укажите NotPresent явно, только если переданный вход задачи ещё не попадал в облако. История и необходимость контекста независимы. Для базы первого чтения текста или изображений дополнительно нужен contextBasis: "ExplicitTaskInput", _meta: {"localai/contextBasis":"ExplicitTaskInput"} либо CLI LOCALAI_CONTEXT_BASIS=ExplicitTaskInput. Это утверждение вызывающего, что ограниченный вход выбран как необходимый для задачи, а не автоматически доказанный минимум. Не задавайте его только потому, что файл открыт или передан инструменту. По умолчанию база — Unknown; необъявленный контекст, поиск и конфликтующие срезы не получают положительного зачёта. Для уже прочитанного исходника передайте sourceContext: "AlreadyPresent" поддерживаемому MCP-инструменту либо _meta: {"localai/sourceContext":"AlreadyPresent"} в запросе. Если это нельзя установить, используйте "Unknown". В CLI те же значения принимает LOCALAI_SOURCE_CONTEXT. Общего журнала облачного контекста между вызовами нет: при повторном чтении эту информацию передаёт вызывающая сторона. Сохраняются только числа, профили и сценарий, без текста исходника и ответа. Захват CLI ограничен 8 Ми символов на поток; при превышении размер ответа в токенах неизвестен. Совместимость существующих полей JSON сохранена: новый расчёт находится в каноническом отчёте и его строке, старые скалярные оценки конкретных команд сохраняют прежнее значение. Учёт ограничен 16 384 различными исходными блоками на вызов: для более длинного потока выводится source_evidence_limit, а частичный объём не выдаётся за полный.

Разобрать лог

lai localai triage build.log --question "почему упала сборка"

Читает файл лога любой длины. Перебирает модели, назначенные для разбора логов в каталоге маршрутизации, в порядке маршрута — сначала кандидаты, затем запасные, — и для каждой установленной пробно загружает её размеры контекста от наибольшего к наименьшему, не выше предела из log-triage.json, пока брокер не примет загрузку (по умолчанию — только если модель целиком загрузилась в видеопамять). Затем обрабатывает файл частями, рассчитанными на принятый контекст.

Заданный --question сохраняется в запросах к каждому фрагменту и при объединении ответов; он может запрашивать сводку успешных операций. Полный разбор лога по умолчанию сохраняет основание сравнения по всему источнику. Для пользовательского вопроса необходимый контекст задачи неизвестен: обработка всего лога не доказывает, какой контекст нужен этому вопросу. Переданный вызывающим sourceContext сохраняется.

При диагностическом разборе потоковый детектор независимо от модели считает строки с ошибками и число появлений каждого кода; повторяющиеся исходные строки не объединяются. Итоги сводок MSBuild показываются отдельно. Отчёт содержит хеш источника и исходные номера строк с ограниченными наборами диагностических сообщений и сводок. Ограничение числа показанных строк не уменьшает счётчики; строки, превышающие предел разбора, явно отмечают возможную неполноту подсчёта. Количество диагностических сообщений в ответе модели сверяется с источником. Неверное число, пропущенные ошибки или выдуманные коды отклоняют диагностический инвентарь модели: вместо него показывается детерминированный отчёт по источнику. Отсутствие распознаваемых сообщений об ошибках не означает, что сборка завершилась успешно.

Если задан пользовательский вопрос, при разборе фрагментов лога компилятора и объединении результатов модель получает инструкцию вернуть JSON-объект с полями inventory и requestedAnswer. При стандартном разборе без пользовательского вопроса сохраняется прежний JSON-объект из трёх полей без внешней оболочки. Строгий контракт из трёх полей, сверка с источником, исправление формата и детерминированное формирование отчёта применяются только к вложенному inventory; проверка по исходному логу остаётся обязательной. Ответ на заданный вопрос показывается отдельно с явной пометкой: он сгенерирован моделью, а его содержание не подтверждено сверкой с исходными сообщениями компилятора. Успешная проверка inventory не подтверждает этот ответ. Если ответа нет или он некорректен, явно указывается, что он недоступен. Исправление формата применяется только к inventory, не подменяя requestedAnswer.

Единственное внешнее ограждение JSON-кода можно убрать, затем выполняется та же сверка с источником. При неверном формате разрешена максимум одна ограниченная попытка через брокер: ей передаются компактные исходные счётчики с уже принятой моделью и контекстом. Неверные значения счётчиков не превращаются в успешную проверку. Отмена прекращает попытку; при сбое или превышении бюджета сохраняется детерминированный отчёт. Метаданные проверки содержат нормализацию, число попыток, первоначальные причины и причину сбоя исправления. Если задание не вернуло квитанцию, его время помечается неполным: известная сумма ожидания и выполнения не выдаётся за полное время попытки.

Работает и с потоком, так что лог можно не сохранять:

dotnet build 2>&1 | lai localai triage -

Прочитать картинку и перевести документ

lai localai read-image "Что за ошибка на скриншоте и в каком окне?" C:\shots\error.png
lai localai translate --in docs\notes.md --from Russian --to English --markdown --out docs\notes.en.md

read_image и localai read-image также принимают один PDF размером до 256 МиБ. Передайте его путь без других файлов и без --together. Страницы преобразуются в изображения и передаются модели по одной. В режиме OCR результат чтения каждой страницы возвращается полностью, в исходном порядке, под заголовком с её номером. В остальных режимах ответы по страницам сводятся. Консоль показывает текущую страницу и общее число страниц; итоговая строка содержит имя файла и число прочитанных страниц. Ограничения в восемь страниц для PDF нет.

Для выбора страниц PDF укажите --pages "1,3-5" (MCP: pages: "1,3-5"). Нумерация начинается с единицы, обе границы диапазона включены. Страницы читаются в порядке документа без повторов; заголовки и прогресс сохраняют исходные номера. В изображения преобразуются только выбранные страницы. Неверные диапазоны и номера за пределами документа отклоняются до вызова модели. Без параметра читаются все страницы.

lai localai read-image "Перепиши текст" manual.pdf --profile Ocr --pages "1,3-5"

Для OCR PDF добавьте --out transcript.txt (MCP: outPath), чтобы сохранить полный текст в UTF-8 и получить короткий ответ с путём к файлу. Выходная папка должна существовать. Имеющийся выходной файл заменяется атомарно после обработки всех выбранных страниц; ошибка или отмена сохраняет прежний файл. Исходный PDF нельзя указать как выходной файл. Текст не сокращается и не возвращается в ответ при ошибке записи. Содержимое файла остаётся недоверенными данными. Без выходного пути OCR возвращает текст в ответе, как раньше.

Для возобновления OCR PDF добавьте --checkpoint ocr-progress (MCP: checkpointDirectory). После прерывания повторите тот же запрос: готовые страницы загружаются с диска без повторного преобразования в изображения и вызова модели; обрабатываются только незавершённые страницы. Полностью готовый сеанс может записать текст в другой выходной файл без вызова модели. Контрольная точка хранит текст страниц и квитанции выполнения; одновременно её может изменять только один запуск. Для нового сеанса используйте пустую папку, а выходной файл располагайте вне неё. Изменения байтов PDF, выбранных страниц, вопроса, языка, заданной модели, каталога маршрутизации или сборки обработчика отклоняются: для них нужна новая папка. Каждая запись контрольной точки ограничена 4 МиБ; превышение вызывает ошибку без сокращения текста.

lai localai read-image "Перепиши текст" manual.pdf --profile Ocr --checkpoint ocr-progress --out transcript.txt

Страницы преобразуются в изображения с разрешением до 150 DPI, не более 4 миллионов пикселей на страницу. Для зашифрованного или повреждённого PDF выводится ошибка с путём к файлу; ввод пароля не поддерживается.

В замерах PDF-парсера и OCR отдельно проверены текстовый слой, повреждённые документы и ограничения растра; указаны границы выводов.

Поиск документов индексирует PDF, TXT, Markdown (.md, .markdown) и DOCX. Храните индекс вне папки-источника. Обрабатываются поддерживаемые файлы непосредственно в этой папке. Для PDF по умолчанию сохраняется OCR; остальные форматы читаются без модели.

lai localai documents index --source C:\Documents\Scans --index C:\Documents\SearchIndex
lai localai documents index --source C:\Documents\Text --index C:\Documents\TextIndex --pdf-mode TextLayer
lai localai documents search --index C:\Documents\SearchIndex --query "номер счёта" --limit 10 --json

Аналоги MCP: index_documents(sourceDirectory, indexDirectory, model?, pdfMode?) и search_documents(indexDirectory, query, limit?, sourceContext?). Поиск находит точную фразу без учёта регистра, возвращает не более одного фрагмента на единицу источника и не вызывает модель. Для PDF указаны файл, его версия SHA-256, номер страницы от единицы, нормализованная область всей страницы (0,0,1,1), способ извлечения и текст. Результаты OCR также содержат модель и отметку непроверенной точности. ocrOffset, matchLength и textOffset считаются в единицах UTF-16 внутри распознанного текста страницы; это не координаты слов в PDF. Пересказы и сгенерированные ответы не смешиваются с текстом. OCR может ошибаться и пропускать текст: отсутствие совпадения означает лишь отсутствие фразы в распознанном тексте индекса.

Явный --pdf-mode TextLayer (MCP pdfMode: "TextLayer") извлекает встроенный текст PDF через PdfPig 0.1.16. Автоматического перехода к OCR нет: страницы без извлечённого текста перечислены в emptyPages результата индексации. Для распознавания изображений обновите индекс с --pdf-mode Ocr. Слой может содержать скрытые символы или другой порядок чтения. Для этих форматов textKind различает ocr, pdf-text и plain-text; textVerification равен соответственно unverified, layout-unverified или source-text. Совпадение текстового слоя с видимой страницей не утверждается.

У результатов TXT/Markdown поля page, region, model и ocrOffset равны null. Диапазон startLine/endLine описывает строки фрагмента от единицы, а matchStartLine/matchEndLine — строки совпадения. matchOffset, textOffset и matchLength считаются в единицах UTF-16 внутри декодированного файла или извлечённого текста страницы PDF. Текст и окончания строк сохраняются. Поддерживаются UTF-8 и UTF-16/UTF-32 с BOM; повреждённые кодировки и нулевые символы отклоняются. Для текстового файла возвращается не более одного фрагмента.

Поиск DOCX читает абзацы основной части и абзацы в ячейках таблиц верхнего уровня. Соседние текстовые фрагменты объединяются, табуляция и явные переносы сохраняются. Выдаётся не более одного фрагмента на абзац с textKind: "docx-text" и textVerification: "layout-unverified". Поле docxSource содержит объявленную основную часть part, пространство имён namespaceUri для префикса w и точный xpath. Нумерация от единицы: paragraph считает непосредственные абзацы тела или ячейки; table, row и cell — непосредственные соседние элементы XML. Для абзаца тела поля таблицы равны null. При объединённых ячейках указаны позиции XML, а не видимые столбцы. SHA-256 файла привязывает ссылку к версии. Поля page, region, model, ocrOffset и номера строк равны null; смещения UTF-16 относятся к извлечённому абзацу. Страницы, нумерация, стили, скрытый текст и порядок чтения не отрисовываются и не проверяются; текст скрытых фрагментов может присутствовать в выдаче.

Извлечение DOCX частичное. Абзац с неподдерживаемым содержимым — например полями, рисунками, ссылками на сноски или отслеживаемыми исправлениями — пропускается целиком, чтобы не создавать ложных совпадений при склеивании текста через пропуск. Неподдерживаемые блоки, элементы управления содержимым и вложенные таблицы пропускаются. Колонтитулы, сноски, комментарии, стили, медиа и другие неиндексируемые части пакета перечислены в extractionNotices с точными именами частей и структурными адресами, когда они доступны. Внешние связи отмечаются и никогда не загружаются; отображаемый текст гиперссылки может быть прочитан. Для каждого файла выводятся первые 64 уведомления; additionalNotices суммирует оставшиеся по всем файлам. Уведомления есть и в индексации, и в поиске, даже без совпадений. Поиск показывает их только для источников, прошедших проверку актуальности. Отсутствие совпадения не означает отсутствия фразы во всём документе Word.

Повторный documents index обновляет индекс: неизменённые документы используются повторно, изменённые читаются заново, записи удалённых исчезают. Смена режима PDF отменяет повторное использование извлечённого текста. Индексы версий 1 и 2 доступны для поиска; обновление атомарно переводит хранилище в версию 3. Версия ответа CLI/MCP остаётся 1, поля добавляются; indexSchemaVersion обозначает версию хранилища. Перед выдачей поиск сверяет хеши и сообщает об изменённых, удалённых или недоступных источниках в excludedSources. После изменений обновите индекс; новые файлы появятся в поиске после обновления. Публикация атомарна, отмена сохраняет предыдущий снимок; прерванное новое распознавание повторяется при следующем запуске. Текст хранится локально в snapshot.json. Хеши страниц выявляют случайное повреждение, но не защищают от намеренной подмены тем, кто может перезаписать индекс.

Ограничения пилота: 32 файла, 128 страниц в PDF, 256 МиБ на PDF, 8 МиБ на другой файл, 1 ГиБ суммарно, 64 000 извлечённых символов на страницу PDF и 8 миллионов в индексе. Во фрагменте выдачи до 2000 символов, в поисковой фразе — от 1 до 256. Для индексации экономия токенов неприменима. Поиск сравнивает только текст единиц источника, представленных в выдаче, с полным запросом и ответом инструмента. Условная оценка может быть отрицательной и не отражает расход аккаунта. Весь корпус не засчитывается в экономию; прежние вызовы OCR не учитываются повторно. Для DOCX также действуют лимиты: 256 элементов архива, 8 МиБ на распакованную часть, 32 МиБ заявленного распакованного содержимого, 4096 непосредственных абзацев тела/ячеек и 64 000 символов на извлечённый абзац. Читаемый XML ограничен также фактически полученными байтами, 100 000 узлов чтения и глубиной 64 на часть. DTD, неоднозначные или небезопасные пути пакета и дубликаты отклоняются. Содержимое архива не записывается по путям источников. В результате индексации pages считает страницы PDF, paragraphs — извлечённые абзацы DOCX, docxDocuments — файлы DOCX. Отмена разбора PDF проверяется между страницами; жёсткий лимит времени процесса или изолированный лимит памяти не реализован.

Языки задаются названиями, а не кодами: --to Russian, не --to ru.

Проверки перевода отклоняют скопированную исходную прозу, если названия запрошенных языков различаются, в том числе копии с изменёнными пробелами, пунктуацией или добавленной подписью. Проверяется каждый фрагмент: перевод одного не разрешает копировать другой. Числовые записи должны сохранять написание и порядок, включая ячейки таблиц и повторы; локализация десятичного разделителя или перестановка консервативно отклоняется. Блоки кода сохраняются отдельно, цифры в названии модели в служебной подписи не считаются исходными числами. Непринятый результат запускает только предусмотренную каталогом цепочку запасных моделей. Если ни одна попытка не прошла, инструмент возвращает явную ошибку и не записывает файл перевода. Расход на отклонённые вызовы сохраняется в учёте, но успешный перевод им не засчитывается. Это детерминированные проверки, не подтверждение смысла или языка результата. Неизменённые имена и общие для языков слова также могут быть отклонены; при одинаковых названиях языков проверка копирования пропускается. Markdown только с блоками кода сохраняется без модели. Переводы документации используют те же проверки неизменённого текста и числовых записей.

Для возобновляемого перевода добавьте --checkpoint translation-progress (MCP translate_local: checkpointDirectory). После отмены или ошибки записи результата повторите тот же запрос. Фрагменты, прошедшие проверки структуры и содержимого, сохраняются атомарно и используются повторно; защищённые блоки кода копируются без изменений. Полностью готовый кеш не вызывает модель и не учитывает повторно старые токены или время. Структурная проверка не подтверждает правильность смысла или языка перевода.

Для нового сеанса нужна пустая папка. Изменение исходного текста, исходного/целевого языка, режима Markdown, каталога маршрутизации, сборки обработчика или языка интерфейса требует новой папки. Записи содержат переведённый текст и квитанции, ограничены 4 МиБ каждая; одновременно сеанс изменяет один запуск. Выходной файл должен находиться вне контрольной точки; ссылки на исходник или файлы контрольной точки отклоняются. Запись атомарно заменяет выходной файл, сохраняя прежний при отмене или ошибке.

lai localai translate --in manual.md --from English --to Russian --markdown --checkpoint translation-progress --out manual.ru.md

С --markdown документ, содержащий только ограждённые блоки кода и пробельные символы, возвращается без изменений, вызова модели и примечания о переводе. Расход локальных токенов равен нулю; оценка экономии облачных токенов неприменима. В --json успешный результат содержит reason: "no_translatable_text", modelCalls: 0 и null для модели, размещения и обеих оценок облачной экономии. Поля результатов с вызовом модели сохраняются.

Посмотреть состояние

lai localai repo status --root C:\work\myapp   # подключён ли репозиторий
lai codesearch status --root C:\work\myapp     # где индекс, ушла ли основная ветка дальше него
lai localai model status                       # какие модели стоят и загружены
lai localai policy show                        # политика размещения и обновлений
lai localai telemetry                          # сводка по локальным заданиям
lai localai doctor                             # что не так с установкой

lai localai diagnostics показывает полный манифест и подготовленные диагностические данные без сохранения пакета. lai localai diagnostics --out C:\support\localai.zip сохраняет то же содержимое в ZIP в существующем каталоге; имеющийся файл не перезаписывается. Добавьте --json для стандартного машинного конверта с полями saved, manifest и contents. Поддерживаются справка, отмена и отчёт о неприменимости экономии облачных токенов к административной операции. Сбор не вызывает модель и не обращается к сети, исходные данные не изменяются; обычный отчёт CLI об использовании всё же записывается. Пилот не добавляет MCP-инструмент и не меняет ответы существующих MCP-инструментов.

ZIP содержит manifest.json и пять JSON-проекций: версии сборщика/.NET/ОС и записанную версию установки, количество активных заданий по состояниям очереди, записанные состояния репозиториев и сборок индекса, распознанные категории ошибок брокера и количество записей по статусам метрик. Облачные INPUT и OUTPUT разделены; измеренные и оценочные значения имеют отдельные минимумы и максимумы, в том числе отрицательную экономию. Неизвестные и неприменимые значения учитываются отдельно. Суммарная экономия по вызовам и процессам не заявляется. Текущий вызов диагностики завершается после сбора и потому не входит в собственный снимок.

Запросы к моделям, документы, ответы, сырые журналы, тексты исключений, пути, названия репозиториев и моделей, идентификаторы заданий и вызовов, настройки и переменные среды исключены. Включить их отдельным параметром нельзя. Порядковые номера репозиториев действуют только внутри снимка. Коммит сборщика и каталог активной версии — сведения о версии установки, а не идентификаторы заданий и вызовов. Записи не подтверждают текущую работоспособность служб или актуальность индексов: файлы читаются независимо, со временем сбора и явными счётчиками отсутствующих, нечитаемых, неверных, перенаправленных ссылками и ограниченных источников. Ссылки не обходятся. Пилот собирает не более 1 024 активных заданий, 256 репозиториев, 2 048 сохранённых отчётов, 1 МиБ на исходный файл (для состояний и отчётов лимиты меньше) и 32 МиБ исходных байтов всего. Ограниченная выборка не обязательно содержит самые новые записи. Из двух ротаций журнала брокера берутся только распознанные категории; неизвестные обозначаются Other. Размеры и SHA-256 в манифесте относятся к точным подготовленным файлам ZIP, а не к закрытым исходным данным. Отмена или ошибка экспорта не публикует частичный ZIP.

Оценить ресурсы целевого компьютера

localai hardware plan --release <folder> [--disk <existing-path>] [--json] проверяет подпись манифеста релиза и сопоставляет указанные в нём размеры моделей с текущим model-routing.json и политикой размещения. Варианты модели и размера контекста оцениваются по свежим данным об объёме памяти GPU и доступной физической ОЗУ с консервативным запасом памяти. Перед использованием каждый вариант требует проверки preflight на этом компьютере; прежние или перенесённые подтверждения размещения не учитываются. Команда не загружает модели, не выполняет сетевые запросы и не изменяет политику размещения.

Каталог релиза должен содержать совместимые release-manifest.json и release-manifest.sig с подписью встроенного ключа релизов. Эта команда не читает и не проверяет ZIP. --disk задаёт существующий локальный каталог; по умолчанию используется LocalApplicationData. UNC-пути, пути устройств и подключённые сетевые диски отклоняются. JSON-конверт содержит plan, catalogSource, policySource, dependencies и пояснения. Отсутствующий или повреждённый файл политики сохраняет строгие настройки по умолчанию; fileFound/fileUsed показывают источник. Некорректный настроенный каталог моделей отклоняется. Для этой административной команды экономия облачных токенов неприменима.

Расчёт использует одну подходящую видеокарту с наибольшей памятью, без сложения памяти адаптеров. Общий механизм рекомендаций добавляет к базовой подписанной оценке 1 ГиБ запаса для среды выполнения и 256 КиБ на токен контекста. ОЗУ консервативно сопоставляется с той же оценкой полной модели. fits, exceeds и unknown — оценки; residencyProof всегда равен preflight-required. Неизвестные характеристики оборудования и неподписанные затраты модели/контекста остаются неизвестными. Записи Disabled/Never исключаются. Изменение политики требует явной команды localai policy set.

Проверка зависимостей определяет только наличие исполняемых файлов в локальных каталогах PATH; версии и работоспособность остаются непроверенными. Оценка места на диске — нижняя граница, включающая загрузки рекомендованных моделей (один раз на модель) и размер пакета из подписанного манифеста. Распакованные файлы среды выполнения, установщики зависимостей, индексы и запас для временных данных учтены не полностью. complete остаётся false, даже если для известного минимума места хватает. Уже имеющиеся модели не вычитаются из объёма загрузки; необязательные модели и модели с ручной установкой перечисляются, но не включаются в общий объём диска по умолчанию.

Подготовить и проверить переносимые офлайн-материалы

lai localai offline bundle --source C:\prepared --out E:\localai-offline --json
lai localai offline verify --bundle E:\localai-offline --manifest-sha256 <trusted-hash> --json

Источник должен содержать release-manifest.json, release-manifest.sig, localai-package.zip и offline-components.json. Подпись релиза проверяется встроенным ключом; размер и SHA-256 скопированного пакета должны совпасть с подписанным манифестом. ZIP здесь не распаковывается и не исследуется: содержимое пакета проверяет обычный установщик. Пути источника и результата должны быть локальными, родительская папка результата — существующей, а сама папка результата — новой. Загрузки и исполняемые файлы из комплекта не запускаются. Используйте опубликованный самодостаточный CLI: для этого этапа переноса глобальный .NET SDK не требуется.

Пример описания источника (замените заявленную версию и подготовьте указанный файл):

{
  "schemaVersion": 1,
  "components": [
    {
      "kind": "dependency",
      "id": "dependency.ollama",
      "version": "user-verified-version",
      "files": ["dependencies/ollama/OllamaSetup.exe"]
    }
  ]
}

kind принимает dependency, model или runtime. Идентификаторы зависимостей взяты из существующего каталога: dependency.git, dependency.ollama, dependency.github-cli, dependency.dotnet-sdk-10, dependency.nodejs-20, dependency.scip-typescript, dependency.python-3-12 и dependency.scip-python. ID модели — точный включённый тег из текущего model-routing.json. Компонент среды выполнения использует ID localai и подписанную версию релиза; в нём можно перечислить дополнительные файлы, например LocalAi.Installer.exe. Три подписанных файла релиза включаются всегда. Для каждого компонента нужны метка версии и явный список файлов: маски и рекурсивный обход каталогов не поддерживаются. Версии и принадлежность файлов компонентам заявляются составителем и не доказывают совместимость. Артефакты моделей должны быть заранее получены обычным разрешённым способом; команда не вызывает Ollama, не импортирует хранилище моделей и не копирует автоматически состояние брокера и подтверждения размещения.

Комплект сохраняет относительные пути и добавляет offline-manifest.json. Копируются только перечисленные файлы; все зависимости каталога и включённые модели получают статус included или missing. Общие файлы компонентов копируются и считаются один раз. transferredBytes считает перечисленные материалы, totalBundleBytes также включает сам манифест. Это нижние границы объёма переноса/хранения, а не размер установленной среды: распаковка, рабочие нагрузки SDK, импорт моделей, индексы и временное место не учтены. Ограничения: 8 МиБ описания, 8 192 файла материалов и 1 ТиБ их суммарного размера. Результат публикуется переносом готового промежуточного каталога; ошибка или отмена не публикует неполный комплект.

Сохраните выданный manifestSha256 отдельно в доверенном месте. Манифест не является новой подписью издателя: хеш, скопированный вместе с изменённым описанием, не подтверждает доверие. offline verify сначала требует этот независимый хеш, затем сверяет каждый файл и подписанные данные/хеш пакета среды выполнения. Отсутствующие, лишние, изменённые файлы, ссылки, небезопасные пути и коллизии регистра отклоняются. Результат относится к байтам, прочитанным в этом вызове, и не разрешает последующий запуск изменённого файла. Обе команды используют стандартный JSON-конверт и административный отчёт об облачных INPUT/OUTPUT (неприменимо).

Отсутствующие компоненты остаются явно указанными даже при успешной проверке целостности. completeForInstallation остаётся false, installationState — installation-unverified. Проверка на чистом компьютере без сети ещё предстоит в #612. Эти команды обеспечивают воспроизводимый состав переноса и контроль целостности байтов; готовность полного офлайн-окружения к установке и работе ими не подтверждается.

Составить план офлайн-окружения и оценить известные затраты места

lai localai offline plan --bundle E:\localai-offline --manifest-sha256 <trusted-hash> --disk C:\prepared --json

Команда только читает данные: повторно проверяет комплект и показывает порядок действий — зависимости каталога, обычный установщик среды, импорт моделей, отдельная настройка каталога Ollama и preflight через брокер. Учитываются все зависимости и включённые модели текущего каталога, даже если их записи отсутствуют в манифесте. Это проверка состава каталога, а не рекомендация установить все необязательные компоненты. Версии уже установленных зависимостей не определяются. Инструкции для включённых зависимостей и граф моделей проверяются теми же средствами, что отдельные команды применения. Неподдерживаемые инструкции и некорректные графы моделей остаются явно указанными. План не запускает установщики или модели, не копирует модели, не меняет настройки и не выполняет последовательность действий. --mode apply здесь не поддерживается.

--disk должен указывать существующий локальный каталог без ссылок, junction и точек монтирования других томов. Отчёт рассматривает размещение на одном томе: это не резервирование места и не проверка установки на нескольких дисках. Отдельно показаны файлы среды, размер распаковки ZIP, уникальные файлы моделей, наибольшая временная копия зависимости при последовательной установке, сохраняемые материалы npm и две копии деинсталлятора из комплекта. Размер распаковки берётся из доверенного ZIP после ограниченных проверок центральных/локальных заголовков и состава архива тем же парсером, что использует обычный установщик. Это не заменяет распаковку, проверку метаданных пакета и Authenticode.

Консервативная известная часть дополнительного места считается так:

файлы среды + уникальные файлы моделей
  + сохраняемые материалы npm
  + 2 * LocalAi.Installer.exe из комплекта (если он указан в компоненте runtime)
  + max(2 * сжатый пакет среды + размер распаковки ZIP,
        размер распаковки ZIP + наибольшая временная копия зависимости с проверенной инструкцией)

Две сжатые копии учитывают подготовку через обычный источник из каталога и проверяющий компонент; распакованная временная копия учитывается дополнительно к установленным файлам и сохраняется на время выполнения выбранных зависимостей. Импорт публикует временный каталог моделей переименованием, поэтому общий файл данных и промежуточная копия моделей не считаются дважды. Объём самого переносимого комплекта отдельно выдаёт offline bundle. Размеры отсутствующих/некорректных материалов, установленных зависимостей и их временных файлов, резервных копий старой версии/лаунчера, индексов, кешей и накладные расходы файловой системы остаются явно неизвестными. Если свободного места меньше известной оценки, возвращается below-known-budget; если его не удалось определить — unknown; если хватает — всё равно incomplete. readyForInstallation и complete для диска остаются false. Успешный JSON-конверт означает, что план составлен, а не что окружение готово. Выбранные шаги можно выполнить командой offline execute ниже; приёмка на чистом компьютере без сети остаётся задачей #612. Учёт облачных INPUT/OUTPUT административный (неприменимо).

Применить зависимость из комплекта или импортировать файлы моделей

lai localai offline install-dependency --bundle E:\localai-offline --manifest-sha256 <trusted-hash> --component dependency.ollama --json
lai localai offline import-models --bundle E:\localai-offline --manifest-sha256 <trusted-hash> --out C:\localai-models --json

Обе команды по умолчанию используют --mode plan; для выполнения показанной операции добавьте --mode apply. Каждый вызов заново проверяет весь комплект по отдельно сохранённому доверенному хешу манифеста. Используйте опубликованный самодостаточный CLI. Обе команды выдают административный отчёт об облачных INPUT/OUTPUT (неприменимо) и не вызывают модели.

Для установки зависимости нужен offline-actions.json в источнике. Перед сборкой комплекта явно добавьте его в files компонента runtime. Например:

{
  "schemaVersion": 1,
  "actions": [{
    "component": "dependency.ollama",
    "kind": "exe",
    "installer": "dependencies/ollama/OllamaSetup.exe",
    "arguments": []
  }]
}

Пустой список аргументов здесь — пример интерактивного запуска, а не проверенный сценарий тихой установки. Укажите документированные производителем аргументы для подготовленного полного офлайн-установщика. Установщик и сопутствующие файлы должны принадлежать записи этой зависимости в манифесте и находиться в одном каталоге с уникальными именами. Вложенные каталоги не поддерживаются. Команда запускает один EXE или MSI в Windows: выбранные файлы копируются и хешируются в защищённой временной папке, а открытые дескрипторы предотвращают их замену во время выполнения. MSI запускается системным msiexec с /i, /qn, /norestart; дополнительные аргументы допустимы только в виде PROPERTY=value с именем свойства в верхнем регистре. Перехода к скриптам, менеджерам пакетов или сетевой загрузке в команде EXE/MSI нет. Для закреплённых SCIP-пакетов из кеша npm используется отдельная команда offline install-npm ниже. Хеш манифеста подтверждает доверенные инструкции и байты, а не издателя и заявленную версию. Внешний установщик может обращаться к сети или внести частичные изменения; сетевая изоляция, установленная версия и работоспособность здесь не подтверждаются. Local AI не откатывает такие изменения автоматически.

Коды установщика 0, 3010 и 1641 дают state=completed; последние два устанавливают rebootRequired=true. Другие ошибки возвращают ненулевой код CLI и ok=false, сохраняя подробности результата. Отмена и таймаут получают состояния cancelled и timed-out. Если остановку подтвердить не удалось, возвращается termination-unconfirmed, а retainedDirectory указывает сохранённые файлы установщика. Перед повторным запуском или удалением файлов выясните состояние процесса. Команда не повышает привилегии.

Компоненты моделей должны перечислять полный граф манифеста Ollama версии схемы 2 и файлов данных: models/manifests/<host>/<namespace>/<model>/<tag> и models/blobs/sha256-<digest>. Хеши и размеры конфигурации и слоёв должны совпадать с описанием комплекта; лишние файлы, включая подтверждения размещения, отклоняются. Допустимы только включённые теги каталога. Для коротких имён используются registry.ollama.ai/library и latest. Поддерживаемые пути Windows допускают сегменты длиной 1–80 символов из латинских букв ASCII, цифр, подчёркиваний, точек и дефисов, начиная с буквы, цифры или подчёркивания. Порты в имени хоста и теги с digest не поддерживаются. Размер описания действий и каждого манифеста модели ограничен 1 МиБ.

Для импорта нужна новая локальная папка вне комплекта с существующим родительским каталогом. Проверенные файлы копируются во временную папку, затем публикуются переносом каталога; существующие хранилища не объединяются и не заменяются. OLLAMA_MODELS, активная среда выполнения и политика не меняются. Отдельно настройте каталог моделей Ollama и выполните существующий preflight через брокер на целевом компьютере; запуск бэкенда/моделей и подтверждение размещения выполняются отдельно. Сценарий зависимостей в мастере Windows не изменён. Установка на чистом компьютере без сети и предустановленного SDK остаётся отдельной приёмочной проверкой.

Выполнить выбранные офлайн-шаги с журналом

lai localai offline execute --bundle E:\localai-offline --manifest-sha256 <trusted-hash> --request C:\prepared\request.json --out C:\prepared\run-01 --json

По умолчанию --mode plan проверяет выбор без создания папки запуска и применения изменений. Для выполнения в Windows добавьте --mode apply. Пример request.json (не более 1 МиБ):

{
  "schemaVersion": 1,
  "dependencies": ["dependency.ollama"],
  "installRuntime": true,
  "modelsOutput": "C:\\localai-models"
}

Выберите только необходимые зависимости EXE/MSI из каталога. Запросы схемы 1 сохраняют прежнее поведение; для включения npm в тот же запуск с журналом используйте схему 2 и явный массив npm. Например, запрос только для SCIP TypeScript:

{
  "schemaVersion": 2,
  "dependencies": [],
  "installRuntime": false,
  "modelsOutput": null,
  "npm": [{
    "component": "dependency.scip-typescript",
    "node": "C:\\Program Files\\nodejs\\node.exe",
    "npmCli": "C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npm-cli.js",
    "output": "C:\\localai-scip-typescript"
  }]
}

Схема 2 заставляет старые версии отклонить запрос целиком, а не молча пропустить выбор npm. Node/npm должны существовать уже при планировании: отсутствующий набор инструментов так не устанавливается. Для каждого npm-компонента действуют правила закреплённого кеша ниже и нужна своя новая папка. Повторный выбор компонента и пересечения папок журнала, моделей и npm отклоняются до изменений. План содержит dependencyOrder: выбранные EXE/MSI и npm выполняются в порядке каталога независимо от порядка массивов, затем следуют среда и модели. Намерение запустить npm и его результат записываются в тот же журнал; ошибка или неподтверждённое завершение останавливают последующие шаги. Сохранённые файлы указаны в steps[].retainedDirectory. Настройка PATH включается отдельно, как описано ниже; совместимость инструментов и функциональная проверка остаются отдельными требованиями.

Для регистрации выбранных инструментов укажите "schemaVersion": 3 и добавьте "registerPaths": true в тот же запрос. Нужен хотя бы один выбор среды или npm; прежние схемы отклоняют эту опцию. По умолчанию значение false сохраняет поведение существующих запросов. userPath в плане показывает исходный и предлагаемый пользовательский PATH и выбранные каталоги: папку launcher среды, каталог Node каждого npm-компонента и его node_modules/.bin. Исполняемый файл Node должен называться node.exe. Имена каталогов с разделителями PATH, кавычками, знаком процента или переносами строк отклоняются. Существующие записи сохраняют порядок; повторяющиеся каталоги не добавляются.

Шаг configuration:user-path выполняется после успеха всех выбранных установок и импорта; намерение записывается на диск до изменения. Проверяется наличие каталогов и файлов launcher/npm без ссылок, затем соответствие пользовательского PATH снимку в плане выполнения. Недостающие записи добавляются, сохранённое значение читается повторно. Обнаруженное параллельное изменение останавливает шаг; обновление реестра Windows не является атомарным сравнением и записью. Ошибки записи и контрольного чтения отражаются в steps[].detail, оставляют шаг в списке ожидающих и не вызывают повтора или отката. После такой ошибки PATH уже мог измениться. Ранее установленные файлы сохраняются. Системный PATH и окружение работающих процессов не меняются. Перед использованием команд откройте новый сеанс; более ранние записи PATH могут по-прежнему выбирать другую версию Node/SCIP. Проверка совместимости и preflight через брокер остаются обязательными; readyForUse=false сохраняется.

Для привязки импортированных моделей к запускам Ollama через брокер укажите "schemaVersion": 4, "configureModels": true и непустой modelsOutput. Нужна выбранная установка среды либо уже существующий корневой каталог среды. По умолчанию опция выключена; схемы 1–3 её отклоняют. modelSetup в плане указывает импортируемый каталог, ollama-launch.json и хеш прежнего файла. После импорта шаг configuration:ollama-model-root находит Ollama через проверку установленного приложения из установщика: запись реестра, разрешённый каталог и идентичность исполняемого файла. Поиск через PATH не используется. Намерение фиксируется в журнале до проверки и записи. Если проверенная Ollama не найдена, обнаружено параллельное изменение записи, не удалась запись или контрольное чтение, дальнейшие шаги останавливаются, а настройка остаётся ожидающей. Импортированные файлы сохраняются. Запись публикуется переносом временного файла после сброса на диск; проверки до и после не являются атомарным сравнением и записью относительно других процессов.

Схема 2 файла ollama-launch.json хранит явно выбранный каталог моделей. При будущем запуске Ollama через брокер проверяется наличие локального каталога без ссылок, а OLLAMA_MODELS задаётся только дочернему процессу. Недоступный каталог запрещает запуск вместо перехода к стандартному хранилищу. Обновление установщиком сохраняет настроенный каталог. Пользовательское и системное значения OLLAMA_MODELS, а также уже работающий сервер не меняются. Нужна среда с поддержкой этой схемы записи; старые версии её отклоняют. Перед использованием настроенного запуска самостоятельно остановите работающую Ollama, затем выполните существующий preflight моделей через брокер целевого компьютера. Эта опция не останавливает и не запускает сервер, не вызывает модели и не переносит подтверждения размещения. Запись каталога не подтверждает совместимость моделей или готовность среды.

Для добавления записи удаления Windows текущего пользователя укажите "schemaVersion": 4, "registerUninstall": true и "installRuntime": true. Компонент среды в комплекте должен явно включать автономный LocalAi.Installer.exe этого выпуска в корне комплекта. Его размер и SHA-256 покрываются независимо доверенным хешем комплекта. До запуска зависимостей файл копируется в защищённый временный каталог, повторно проверяется и удерживается до завершения. Применимые требования Authenticode сохраняются. Раздел uninstall плана показывает хеш, назначение, ключ реестра и прежнюю запись. Существующая запись другого каталога установки приводит к отказу.

После активации среды шаг configuration:uninstall записывает намерение, копирует удерживаемый установщик в installer/uninstall/LocalAi.Installer.exe и добавляет Local AI Toolkit в список установленных приложений Windows текущего пользователя. Интерфейс установщика не открывается. Сравнение прежней записи и контрольное чтение реестра и файла выявляют изменения и ошибки, но не образуют атомарную транзакцию. Ошибка останавливает следующие шаги; частичные изменения среды, файла или реестра могут сохраниться без автоматического отката. Функциональная приёмка удаления остаётся отдельной задачей. План диска учитывает обе копии установщика и сохраняемые файлы проекта, lockfile и кеша npm. Размер установленного дерева npm, создаваемых файлов и временных данных сторонних установщиков остаётся неизвестным; полная готовность диска не подтверждается.

Для проверки выбранных импортированных моделей на целевой установке укажите "schemaVersion": 5 и "preflight": [{ "model": "<bundled-model-tag>", "contextTokens": 8192 }], заменив заполнитель и контекст парой из текущего каталога и подписанного манифеста выпуска. Нужны installRuntime=true, configureModels=true и импорт каждой выбранной модели. Прежние схемы запроса отклоняют эту опцию. План показывает выбранные пары без запуска процессов.

После импорта и настройки каталога каждый шаг preflight:<model>:<context> записывает намерение, удерживает проверенный launcher и аренду активной версии, запрашивает состояние моделей и preflight через брокер. Отсутствующая модель или незавершённое скачивание останавливают выполнение; этот путь никогда не скачивает модель. Каталог целевой среды передаётся общему брокеру явно, а её политика размещения читается без изменения. Для этого model status и model preflight принимают последнюю пару --runtime-root <dir>: абсолютный путь к существующему локальному каталогу без ссылок. model pull эту опцию отклоняет.

Успешные шаги сохраняют proof (модель, контекст, каталог, байты модели/VRAM и время проверки) и residencyPolicy; отказ или некорректный ответ не становятся подтверждением. Частичное размещение или CPU допустимы только при соответствующей политике целевой среды. Ошибка останавливает следующие проверки и настройку PATH. Исходный план сохраняет требования до выполнения; подтверждения в шагах показывают выполненное. Остальные пары модель/контекст не проверены. Уже работающая Ollama не перезапускается: успешная проверка размещения не доказывает источник модели или используемый каталог. Подтверждение источника/каталога, полные данные о зависимостях и диске и офлайн-приёмка на чистом компьютере остаются необходимыми; readyForUse=false сохраняется.

Необязательные компоненты автоматически не добавляются. Пустой массив зависимостей, installRuntime=false или modelsOutput=null исключают соответствующие шаги, но хотя бы один шаг, включая выбор npm, должен остаться. Зависимости выполняются в порядке каталога, затем идут активация среды и импорт всех включённых в комплект моделей, разрешённых каталогом. Правила для инструкций установки и моделей выше сохраняются. Все переданные пути должны быть локальными. Для моделей и журнала нужны новые отдельные папки с существующими родительскими каталогами, вне комплекта и установленной среды. Запуски из существующих папок не возобновляются.

До запуска любой зависимости выбранная среда проходит обычную полную проверку подписанного пакета, метаданных и, когда требуется, Authenticode в защищённом временном каталоге. Проверенные файлы сохраняются на время выполнения. Активация использует стандартную установку Local AI текущего пользователя, может остановить работающие инструменты и изменить активную версию. PATH меняется только по явной опции схемы 3 выше. Регистрация удаления в Windows включается описанной выше опцией; остальные настройки мастера выполняются отдельно. Каталог моделей настраивается по отдельной опции выше; пользовательское и системное значения OLLAMA_MODELS не меняются.

Папка запуска содержит plan.json, journal-*.json и, если запись удалась, result.json. Намерение выполнить каждый шаг записывается на диск до изменения системы. Ошибка, отмена, таймаут, запрос перезагрузки, неподтверждённое завершение процесса или ошибка записи журнала останавливают последующие шаги. При перезагрузке или неопределённом результате журнал остаётся незавершённым; шаги с неизвестным результатом сохраняют статус Running. Результат содержит выполненные шаги, ожидающие идентификаторы, исход установки среды и сохранённые файлы зависимости в steps[].retainedDirectory. Перед повтором или удалением этих файлов выясните состояние процесса и установки. Автоматического повтора, возобновления или отката всего запуска нет; частичные изменения могут сохраниться. recordingComplete=false означает, что записи могут быть неполными.

Коды CLI: 0 для плана или выполненных выбранных шагов, 130 при отмене, 75 при таймауте или перезагрузке, 74 при ошибке записи и 70 при ошибке или неопределённом результате выполнения. Эти ненулевые результаты возвращают ok=false с подробностями. Некорректные запросы дают 2 или 65; существующий выходной путь — 73. Даже state=applied возвращает readyForUse=false: версии и предпосылки зависимостей, полные требования к диску и работа без сети не подтверждены. Явно выберите настройку каталога моделей и preflight на целевой среде либо выполните их отдельно. Модели вызывает только выбранный шаг preflight; подтверждения размещения с компьютера подготовки не переносятся. Команда не добавляет сетевую загрузку или повышение привилегий. Внешние установщики производителей могут обращаться к сети. Учёт облачных INPUT/OUTPUT административный (неприменимо).

Установить закреплённые SCIP-пакеты из офлайн-кеша npm

lai localai offline install-npm --bundle E:\localai-offline --manifest-sha256 <trusted-hash> --component dependency.scip-typescript --node "C:\Program Files\nodejs\node.exe" --npm-cli "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js" --out C:\localai-scip-typescript --json

По умолчанию используется --mode plan; --mode apply устанавливает в Windows в новый локальный каталог с существующим родителем, вне комплекта. Существующие каталоги установки, глобальные пакеты и PATH сохраняются. Явно укажите существующие локальные Node/npm: команда не подтверждает их происхождение или версии. Node должен быть совместим с выбранным пакетом. Модели не вызываются, учёт облачных INPUT/OUTPUT административный (неприменимо).

Поддерживаются только закреплённые текущим каталогом пакеты dependency.scip-typescript и dependency.scip-python. В записи каждой зависимости перечислите файлы:

npm/<component-id>/package.json
npm/<component-id>/package-lock.json
npm/<component-id>/cache/_cacache/<каждый подготовленный файл кеша>

Укажите каждый файл кеша явно: манифест не раскрывает шаблоны. Не включайте node_modules, журналы или .npmrc. Версия компонента должна совпадать с каталогом. В package.json допустимы только name, version, private и dependencies; dependencies должен содержать ровно выбранный пакет с точной версией без диапазона. Для TypeScript это {"@sourcegraph/scip-typescript":"0.4.0"}, для Python — {"@sourcegraph/scip-python":"0.6.6"}. Нужен lockfile версии 3 с совпадающими корневыми зависимостями и версией пакета. Для записей пакетов нужны HTTPS-адреса registry.npmjs.org и значения целостности SHA-512. Ссылки Git/file, workspaces и произвольные наборы пакетов не поддерживаются.

Подготовьте проект и кеш на компьютере с сетью в новой папке: из неё запустите Node с npm-cli.js и аргументами install --ignore-scripts --global=false --no-audit --no-fund --logs-max=0 --cache ./cache --registry=https://registry.npmjs.org. Для подготовки используйте рабочую папку, а не --prefix. В переносимый комплект включите только объявленные файлы проекта, lockfile и кеша.

При применении весь комплект заново проверяется по доверенному хешу; выбранные материалы копируются в защищённый временный каталог. Через Node выполняется npm ci --offline --ignore-scripts --global=false --no-audit --no-fund с отдельным кешем, разными пустыми пользовательским/глобальным конфигами и явной рабочей папкой. Отсутствующий кеш вызывает ошибку без перехода к сети. При успехе проверяются имя и версия установленного пакета; для Python применяется существующее исправление Windows с проверкой закреплённых хешей. Готовый каталог переносится в новое назначение. Команды пакетов находятся в node_modules/.bin; настройка PATH и функциональные проверки выполняются отдельно. Каталог также сохраняет свой кеш.

При ошибке npm, отмене или таймауте временная папка сохраняется для диагностики; путь указан в result.retainedDirectory. Состояние termination-unconfirmed означает, что npm может ещё работать: выясните его состояние перед повтором или удалением файлов. При ошибке выходной каталог не публикуется. Даже успех сохраняет readyForUse=false. Флаги офлайн-режима не заменяют проверку межсетевого экрана, наличие кеша не подтверждает работоспособность, а оценка установленного и временного объёма остаётся неполной. offline plan распознаёт такие материалы и размер их временной копии, отдельно указывая необходимость Node/npm и каталога назначения. Эту же операцию можно выбрать в запросе схемы 2 для offline execute, чтобы записать её выполнение в общий журнал.

Когда что-то отказало

Отказ — это не поломка, а сообщение. Три частых:

Что видно Что это значит Что делать
No overlay matches this worktree правки сохранены, индекс отстал lai localai sync --root <repo>
NOT_CONFIGURED репозиторий не подключён lai localai sync --root <repo> и hooks install
The model backend is unavailable бэкенд моделей отказал в партии; сборка ждёт и продолжает сама обычно ничего — если сборка всё же остановилась, повторить lai localai sync --root <repo>: посчитанное сохранено в чекпойнте

← Как пользоваться с облачным агентом · Оглавление · На каком языке он отвечает →