Toolkit¶

Toolkit — это Python-пакет и автономный исполняемый файл onec-hbk-bsl. Он подходит для локальных проверок, CI, интеграции с редакторами и агентами.

Установка¶

Для CLI, форматтера и Language Server:

pip install onec-hbk-bsl-core

Для полного набора, включая MCP:

pip install onec-hbk-bsl

Требуется Python 3.12+. В GitHub Releases также публикуются автономные бинарники для macOS, Linux и Windows.

Основные команды¶

Задача	Команда
Проверить проект	`onec-hbk-bsl check .`
Исправить безопасные нарушения	`onec-hbk-bsl check . --fix`
Отформатировать файлы	`onec-hbk-bsl format .`
Показать правила	`onec-hbk-bsl rules`
Создать конфигурацию	`onec-hbk-bsl init`
Запустить Language Server	`onec-hbk-bsl lsp`
Запустить локальный MCP-сервер	`onec-hbk-bsl mcp`
Управлять индексом	`onec-hbk-bsl index --status`

Используйте onec-hbk-bsl <команда> --help для полного списка параметров.

Конфигурация проекта¶

Создайте onec-hbk-bsl.toml в корне проекта:

select = ["BSL012", "BSL236"]
ignore = ["BSL002"]
exclude = ["vendor", "*.gen.bsl"]

[per-file-ignores]
"legacy/*.bsl" = ["BSL011"]

В select и ignore принимаются коды BSL### и совместимые псевдонимы. Форматы подавления для конкретного правила приведены в каталоге диагностик.

Отчёты и CI¶

onec-hbk-bsl check . --format sarif > onec-hbk-bsl.sarif
onec-hbk-bsl check . --jobs 4
onec-hbk-bsl check . --baseline baseline.json
onec-hbk-bsl check . --diff --since origin/main

Доступны форматы text, json и sarif. Для постепенного внедрения можно использовать baseline, проверку diff и --exit-zero.

Language Server и MCP¶

Language Server предоставляет диагностики, форматирование, definition, references, rename, hover, completion, signature help, folding, code actions, inlay hints и semantic tokens. Обычно его запускает расширение VS Code / Cursor.

Локальный MCP-сервер открывает агентам диагностику, навигацию и безопасный план переименования в пределах указанного workspace. Запускайте его только для доверенных локальных клиентов.

Поддерживаемые входы¶

исходные файлы .bsl и .os;
выгрузка конфигурации из Конфигуратора в файлы;
проекты с onec-hbk-bsl.toml;
Python 3.12, 3.13 и 3.14.