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.53

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.53
File	Size	Uploaded
onec_hbk_bsl_core-0.8.53.tar.gz	505.6 kB	Oct 8, 2026	Details

Built distribution (wheel)

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

Total release size: 1.1 MB

Release files / onec_hbk_bsl_core-0.8.53.tar.gz

Download URL	onec_hbk_bsl_core-0.8.53.tar.gz
Size	505.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`47923021150d06e66336f15b44677d2f759ba3756aef2c63407dca2efd0f8b19`
BLAKE2b-256 checksum How to use checksums	`9a64c376a7fae3756d80ded154f44817a9f2953dcd3b8aed9afc918740627c38`
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/d8b80a00f2e9b8fb89ba1ff4bebf38431630384b

Workflow

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

Artifact

Subject: onec_hbk_bsl_core-0.8.53.tar.gz
SHA-256 checksum: 47923021150d06e66336f15b44677d2f759ba3756aef2c63407dca2efd0f8b19 Verifying attestations

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

Download URL	onec_hbk_bsl_core-0.8.53-py3-none-any.whl
Size	548.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`00b57514174b91edef3558d14d64a486ba715e571a65598b7c903a365450b191`
BLAKE2b-256 checksum How to use checksums	`1245b62e4902ff55d603592cdd44c6cfca6c2a1a93c7881785e1cb8c7124f45d`
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/d8b80a00f2e9b8fb89ba1ff4bebf38431630384b

Workflow

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

Artifact

Subject: onec_hbk_bsl_core-0.8.53-py3-none-any.whl
SHA-256 checksum: 00b57514174b91edef3558d14d64a486ba715e571a65598b7c903a365450b191 Verifying attestations