1C HBK BSL

Инструменты для разработки на платформе «1С:Предприятие» / BSL: расширение для VS Code и Cursor, CLI-линтер, форматтер, а также LSP- и MCP-серверы для локальных интеграций.

Что это

onec-hbk-bsl помогает держать BSL-код в порядке:

показывает диагностики в редакторе и CLI;
включает 180 публичных диагностических правил;
форматирует .bsl / .os;
даёт навигацию, hover, completion, rename и inlay hints через LSP;
умеет отдавать SARIF/JSON для CI;
предоставляет MCP-инструменты для локальных AI-ассистентов.

Проект не запускает Java-анализатор в рантайме. В репозитории выпускаются два связанных продукта: Toolkit (CLI, LSP, MCP и Python API) и расширение VS Code / Cursor со встроенным сервером.

При установке из PyPI требуется Python 3.12 или новее. Платформенные VSIX содержат готовый бинарный файл и не требуют системного Python. Актуальное состояние подтверждают CI, проверка безопасности и артефакты конкретного релиза.

Быстрый старт

VS Code / Cursor

Установите расширение mussolene.1c-hbk-bsl.
Откройте каталог с исходниками 1С.
Дождитесь запуска сервера: диагностики появятся в Problems, а форматирование и навигация заработают через LSP.

Поддерживаются VS Code / Cursor с API VS Code 1.91+ и платформенные сборки для macOS Apple Silicon, macOS Intel, Linux x64 и Windows x64.

Настройки редактора, команды и порядок поиска сервера описаны в руководстве по расширению.

CLI

uv tool install onec-hbk-bsl

onec-hbk-bsl check .
onec-hbk-bsl format . --check
onec-hbk-bsl check . --format sarif > bsl-results.sarif

Установка через pip:

pip install onec-hbk-bsl

Конфигурация

Основной файл проекта: onec-hbk-bsl.toml.

ignore = ["BSL012"]
exclude = ["vendor", "build", "*.gen.bsl"]
format = "text"
jobs = 0
insert-spaces = false
indent-size = 4
index-mode = "full"      # off | symbols | full
index-max-bytes = 0      # 0 = unlimited

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

Также поддерживается секция [tool."onec-hbk-bsl"] в pyproject.toml. Совместимый файл BSLLS называется .bsl-language-server.json. Поддерживаются режимы диагностик ON, OFF, ALL, ONLY, EXCEPT, включение правил по именам BSLLS и перечисленные в руководстве параметры. В одном каталоге TOML переопределяет соответствующие ключи JSON. Неподдерживаемые настройки диагностик сопровождаются предупреждением; полная совместимость со всеми возможностями BSLLS не заявляется. Основные правила разрешения настроек:

явный параметр → переменная окружения → конфигурация проекта → встроенное значение по умолчанию;
jobs = 0 включает адаптивное выполнение, а jobs = 1 — последовательное;
index-exclude управляет областью навигации и по умолчанию наследует exclude;
после изменения области индекса выполните onec-hbk-bsl index . --force.

Полное руководство по конфигурации и публичным интерфейсам: Toolkit.

Диагностики и подавления

BSL### — стабильный код правила для вывода, --select, --ignore, onec-hbk-bsl.toml и подавляющих комментариев noqa. Совместимые имена из существующих BSL-проектов, например LineLength, также принимаются, но в результатах всегда выводится код BSL###.

Все семейства подавляющих комментариев работают для одной строки и диапазона: маркер после кода действует на текущую строку, а маркер на отдельной строке открывает диапазон до noqa-enable, bsl-enable или совместимого BSLLS:…-on.

Пароль = "dev_only";  // noqa: BSL012

// bsl-disable: BSL002
// код без BSL002
// bsl-enable: BSL002

Полный перечень с RU/EN-описаниями, примерами и исключениями: опубликованный справочник диагностических правил.

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

Задача	Команда
Проверить проект	`onec-hbk-bsl check .`
Получить SARIF для CI	`onec-hbk-bsl check . --format sarif > bsl-results.sarif`
Создать или применить baseline-файл	`onec-hbk-bsl check . --update-baseline bsl-baseline.json` / `--baseline bsl-baseline.json`
Проверить форматирование	`onec-hbk-bsl format . --check`
Запустить LSP	`onec-hbk-bsl lsp`
Запустить локальный MCP	`onec-hbk-bsl mcp --stdio --workspace /path/to/project`
Проверить состояние индекса	`onec-hbk-bsl index . --status`
Пересобрать индекс	`onec-hbk-bsl index . --force`

Режимы индекса: off, symbols и full. Перед --clean остановите LSP и MCP.

Python и пакеты

from onec_hbk_bsl import check_files

diagnostics = check_files(["src/Модуль.bsl"], jobs=1)
for diagnostic in diagnostics:
    print(diagnostic.code, diagnostic.file, diagnostic.line)

Публикуются два PyPI-дистрибутива:

Пакет	Назначение
`onec-hbk-bsl-core`	CLI, форматтер, диагностики, Python API и LSP без MCP-зависимостей
`onec-hbk-bsl`	Полный совместимый пакет поверх `onec-hbk-bsl-core[mcp]` той же версии

Место в экосистеме

onec-hbk-bsl отвечает за анализ и безопасное изменение кода в текущей рабочей области. Централизованную справку предоставляет onec-context-mcp, контекстные пакеты конкретной версии проекта собирает onec-context-toolkit, а воспроизводимой средой выполнения управляет 1c-develop.

Эти проекты дополняют друг друга, но не требуются для установки Toolkit или расширения.

Документация

Полная документация публикуется на mussolene.github.io/1c_hbk_bsl. Она поддерживает русский и английский языки, системную светлую/тёмную тему, полнотекстовый поиск и прямые страницы всех 180 правил.

Toolkit — установка, CLI, конфигурация, CI, LSP и MCP.
Расширение VS Code / Cursor — установка, возможности, настройки и устранение проблем.
Диагностические правила — 180 карточек с описаниями, примерами и подавлениями.
Security policy и third-party notices — безопасность, лицензии и происхождение данных.

RU/EN-описания диагностик адаптированы из документационного корпуса BSL Language Server и распространяются с сохранением указанной в сторонних уведомлениях лицензии.

Разработка

git clone https://github.com/mussolene/1c_hbk_bsl
cd 1c_hbk_bsl
make install
make lint
make test

Для локальной сборки VSIX используйте make vsix.

Приоритеты оптимизации, продуктовые доработки и условия сохранения совместимости: карта развития.

Лицензия

Metadata

Release files for onec-hbk-bsl-core 0.8.52

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for onec-hbk-bsl-core 0.8.52
File	Size	Uploaded
onec_hbk_bsl_core-0.8.52.tar.gz	506.9 kB	Oct 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for onec-hbk-bsl-core 0.8.52
File	Interpreter	ABI	Platform	Reset
onec_hbk_bsl_core-0.8.52-py3-none-any.whl 549.8 kB Oct 8, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / onec_hbk_bsl_core-0.8.52.tar.gz

Download URL	onec_hbk_bsl_core-0.8.52.tar.gz
Size	506.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`9773659ad1c88d4020d5338ed4d18ecb24c5b7f134cc240e1f506855063aa114`
BLAKE2b-256 checksum How to use checksums	`52b0c03b902962f0fd792c210dc39a0d43342475e4dfad54a994803e2914f61b`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mussolene/1c_hbk_bsl
Publishing commit: github.com/mussolene/1c_hbk_bsl/tree/b6fd878e45ef70d1c3ea53149b45c8acd6a6f1af

Workflow

Publishing configuration: github.com/mussolene/1c_hbk_bsl/blob/b6fd878e45ef70d1c3ea53149b45c8acd6a6f1af/.github/workflows/release.yml
Publishing logs: github.com/mussolene/1c_hbk_bsl/actions/runs/37812402314/attempts/1

Artifact

Subject: onec_hbk_bsl_core-0.8.52.tar.gz
SHA-256 checksum: 9773659ad1c88d4020d5338ed4d18ecb24c5b7f134cc240e1f506855063aa114 Verifying attestations

Release files / onec_hbk_bsl_core-0.8.52-py3-none-any.whl

Download URL	onec_hbk_bsl_core-0.8.52-py3-none-any.whl
Size	549.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d5cd07365de5bbe74dd2ad71febce69517abc0cb256f4bf1c0bb2ea7dcb3c01b`
BLAKE2b-256 checksum How to use checksums	`d6b3fa88d54b2fd845d6bf19ab68959c420165c8dcbaee9af75bdfd13f6d72a3`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/mussolene/1c_hbk_bsl
Publishing commit: github.com/mussolene/1c_hbk_bsl/tree/b6fd878e45ef70d1c3ea53149b45c8acd6a6f1af

Workflow

Publishing configuration: github.com/mussolene/1c_hbk_bsl/blob/b6fd878e45ef70d1c3ea53149b45c8acd6a6f1af/.github/workflows/release.yml
Publishing logs: github.com/mussolene/1c_hbk_bsl/actions/runs/37812402314/attempts/1

Artifact

Subject: onec_hbk_bsl_core-0.8.52-py3-none-any.whl
SHA-256 checksum: d5cd07365de5bbe74dd2ad71febce69517abc0cb256f4bf1c0bb2ea7dcb3c01b Verifying attestations