Local AI Toolkit

Что доступно из командной строки

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

Список команд: localai --help или codesearch --help. Синтаксис отдельной команды: localai repo status --help или codesearch help search. help, --help или -h перед словами команды, а также --help или -h в любом месте после них выводят справку в stdout и завершаются успешно; лишние или неизвестные слова после ведущего help отклоняются. localai prune и localai update также понимают /? как запрос своего синтаксиса и печатают его в stderr с кодом выхода 2. Язык справки определяется сохранённым выбором или LOCALAI_LANGUAGE (en / ru). Контракты JSON сохранены: --json запрашивает машинный ответ вместо текстовой справки.

Набор не совпадает с MCP: часть инструментов существует только здесь, часть — только там.

Команда Что делает
codesearch search --query "…" тот же поиск по смыслу и имени
codesearch get-chunk --id … забрать фрагмент целиком
codesearch status где лежит индекс, отстал ли, подключён ли репозиторий
codesearch scan что вообще попадёт в индекс
codesearch index / overlay собрать индекс вручную, вне управления Local AI
codesearch evaluate --cases … прогнать корпус оценки качества поиска
localai semantic definition / references / implementations / relationships навигация по объявлениям
localai semantic impact --path src/Type.cs --line 12 --json прямые ссылки и входящие связи C# из индекса
localai ask "…" <file> … механическая работа по файлам
localai triage <log> разобрать лог
localai read-image "…" <file> прочитать изображения или один PDF
localai documents index / search собрать индекс OCR для PDF или найти фразу со ссылкой на источник
localai translate --in <file> --from … --to … перевести
localai sync собрать или обновить индекс
localai hooks install поставить хуки, чтобы индекс обновлялся сам
localai repo status подключён ли репозиторий
localai doctor что не так с установкой, только чтение
localai diagnostics просмотреть записанные диагностические данные или сохранить их в ZIP
localai hardware plan оценить модели и контекст по подписанным данным релиза и этому компьютеру
localai model status / pull / preflight модели: список установленных, загрузка, предварительная проверка
localai policy show / set политика размещения модели в памяти
localai prune убрать устаревшие поколения и overlay, архив очереди, старую телеметрию, записи брошенных репозиториев и старые версии
localai telemetry сводка по локальным заданиям
localai update обновить установку

localai sync --root <worktree> подготавливает только указанную рабочую копию, в том числе при изменении общей базы. Для обслуживания всех связанных копий явно укажите --all-worktrees; указанная копия будет первой. --base-only не строит overlay. SYNC_BASE сообщает о повторном использовании базы; SYNC_PLAN показывает явную область, число рабочих копий и их порядок, а WORKTREE_PLAN — переиспользуемые и пересобираемые overlay. ACTIVE_READY показывает, когда указанная копия может читать новое поколение, отдельно от итоговой длительности синхронизации. Остальные копии читают прежнее поколение до готовности своих overlay. С --all-worktrees обслуживание продолжается в том же процессе; не запускайте вторую синхронизацию одновременно. Перед запуском проверяется верхняя оценка общего объёма работы: база и все выбранные проходы рабочих копий. Прерванный запуск сохраняет готовые копии доступными и допускает повторный запуск. Таймаут ожидания MCP оставляет состояние выполнения неизвестным: следите через localai repo status --follow.

codesearch evaluate --cases … перед поиском сопоставляет эталонные имена C# с их объявлениями в исходниках. Части [1/6] и [2/6] относятся к одному эталону. Необязательные поля signature и namespace уточняют неоднозначные имена; если сигнатура всё ещё подходит к нескольким объявлениям, оценщик отклоняет такой эталон. Для эталона только с путём по-прежнему подходит любой результат из указанного файла. Меняется подсчёт метрик оценки; ранжирование поиска и калиброванный порог остаются прежними.

Корпус оценки может содержать необязательный список excludedPaths: пути к файлам относительно корня репозитория и префиксы каталогов, заканчивающиеся на /. Это буквальные пути без glob-шаблонов; оба вида разделителей принимаются. Если файл --cases находится внутри репозитория, он исключается автоматически; остальные эталонные материалы нужно перечислить явно. Исключения применяются до векторного и лексического ранжирования. Обычный поиск по-прежнему включает тесты.

Пути исключения не должны выходить за пределы репозитория или охватывать объявленный эталонный результат. Отчёт сохраняет коммит и дерево исходников, хеш незакоммиченного содержимого отдельно от коммита и дерева индекса, а также поколение и модель индекса, SHA-256 корпуса, уточнённые аннотации, параметры поиска и фактические исключения. Изменение снимка исходников, поколения индекса или аннотаций во время оценки прерывает запуск. Для воспроизведения запуска с незакоммиченными изменениями нужно также сохранить сами исходные файлы: одного хеша для их восстановления недостаточно.

Сохранённый базовый прогон с фильтрацией кандидатов показывает Recall@10 72.2%, Precision@5 13.3% и долю ложноположительных срабатываний 100% на шести запросах без ответа. Для каждого из 18 запросов с ответом размечена одна цель, поэтому потолок Precision@5 составляет 20%. Эти показатели описывают корпус из 24 проверок, а не общее качество продукта; пороги остаются прежними. Одновременная работа других заданий брокера и недоступная телеметрия очереди и размещения моделей в памяти не позволяют использовать длительности этого прогона как изолированный тест производительности. Независимые корпуса собраны в закрытой задаче #601; их базовый прогон — в разделе «Независимые корпуса для проверки качества».

Чего нет в консоли. lsp_open_document и lsp_close_document принимают текст несохранённого буфера — а в командной строке этого буфера просто нет, отдавать нечего.

Чего нет в MCP. Семь команд намеренно оставлены только Вам. Причины три:

Это уже делается само — звать не надо.

Это обновление продукта, и запускают его вручную.

Это сведения для Вас, в удобном для чтения виде.

Агенту они не нужны в таком виде — у него на каждый свой вызов есть отчётная строка, а про индекс отвечает index_status. А человеку нужна общая картина:


← Что доступно облачному агенту · Оглавление · Поиск по коду — не текстовый поиск →