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.85+ и платформенные сборки для 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. Основные правила разрешения настроек:

явный параметр → переменная окружения → конфигурация проекта → встроенное значение по умолчанию;
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.

Лицензия

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

onec_hbk_bsl_core-0.8.50.tar.gz (489.5 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

onec_hbk_bsl_core-0.8.50-py3-none-any.whl (533.7 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file onec_hbk_bsl_core-0.8.50.tar.gz.

File metadata

Download URL: onec_hbk_bsl_core-0.8.50.tar.gz
Upload date: Aug 26, 2026
Size: 489.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for onec_hbk_bsl_core-0.8.50.tar.gz
Algorithm	Hash digest
SHA256	`ca7377fee835ab8be3d6722affaa65cf42560b414d8cb6ca06aa71d7faafce51`
MD5	`70d88f615cf50df8067237e974c3f4be`
BLAKE2b-256	`951141d294abc67dbacf41110000ee04fb153b04b57e97c2e10e87b4f41a7fea`

See more details on using hashes here.

Provenance

The following attestation bundles were made for onec_hbk_bsl_core-0.8.50.tar.gz:

Publisher: release.yml on mussolene/1c_hbk_bsl

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: onec_hbk_bsl_core-0.8.50.tar.gz
- Subject digest: ca7377fee835ab8be3d6722affaa65cf42560b414d8cb6ca06aa71d7faafce51
- Sigstore transparency entry: 2604252590
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: mussolene/1c_hbk_bsl@708992104f01770e5c66f9617e4aecffebe0b152
- Branch / Tag: refs/tags/v0.8.50
- Owner: https://github.com/mussolene
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@708992104f01770e5c66f9617e4aecffebe0b152
- Trigger Event: push