onec-hbk-bsl: линтер и MCP для BSL
1C HBK BSL (onec-hbk-bsl)
CLI-линтер и форматтер BSL со 180 диагностиками, LSP-сервером для VS Code и Cursor и MCP-инструментами для локальных ИИ-ассистентов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Команда format переписывает файлы .bsl и .os в рабочей области
- Локальный MCP и LSP выполняются в контексте проекта, включая приватный код
Установка
Ручная установка
uv tool install onec-hbk-bslУстановка CLI через uv.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет onec-hbk-bsl проверяет BSL-код по 180 публичным диагностическим правилам, форматирует файлы .bsl и .os, умеет отдавать результат в SARIF или JSON для CI и поддерживает baseline-файлы, чтобы фиксировать только новые замечания. LSP-сервер дает навигацию, hover, completion, rename и inlay hints, расширение для VS Code и Cursor подключает этот сервер автоматически. Отдельная команда onec-hbk-bsl mcp поднимает локальный MCP-сервер по stdio, который дает ИИ-ассистенту те же диагностики и структуру кода. Проект не запускает Java-анализатор, вся логика на Python, есть готовые платформенные сборки VSIX без системного Python.
Для кого. Для 1С-разработчиков, которым нужен быстрый локальный линтер и форматтер BSL с интеграцией в CI и в ИИ-ассистента, без Java-стека.
Подходит, если
- Нужны диагностики и форматирование BSL прямо в VS Code или Cursor
- Нужен SARIF или JSON отчет проверки кода для CI
- Нужен MCP или LSP, который дает ИИ-ассистенту доступ к диагностикам и навигации по BSL-коду
Не подходит, если
- Нужен полноценный анализ конфигурации 1С с метаданными за пределами файлов BSL: проект работает с текущей рабочей областью, а не с базой
- Установка из PyPI, а не VSIX, и нет Python 3.12 или новее
- Нужен централизованный справочник платформы, для этого в экосистеме есть отдельный onec-context-mcp
Пример запроса к агенту
Проверь BSL-код в текущей папке и покажи все замечания уровня ошибки в формате SARIFОграничения
Установка из PyPI требует Python 3.12 или новее, платформенные VSIX для VS Code и Cursor этого не требуют. Проект анализирует только текущую рабочую область, централизованную справку по платформе дает отдельный проект onec-context-mcp того же автора. RU/EN-описания части диагностик адаптированы из документации BSL Language Server с указанием лицензии в third-party notices.
Как отключить. Удалите расширение mussolene.1c-hbk-bsl из редактора или удалите пакет командой pip uninstall onec-hbk-bsl и уберите его из конфигурации MCP-клиента.
Проверка безопасности
- Команда format переписывает файлы .bsl и .os в рабочей области
- Локальный MCP и LSP выполняются в контексте проекта, включая приватный код
Коротко о README
README описывает два связанных продукта: Toolkit (CLI, LSP, MCP, Python API) и расширение VS Code / Cursor. Дает быстрый старт для обоих, таблицу конфигурации onec-hbk-bsl.toml, объяснение диагностических кодов BSL### и подавляющих комментариев, таблицу основных команд включая lsp и mcp, пример Python API, таблицу двух PyPI-пакетов и место проекта в экосистеме рядом с onec-context-mcp, onec-context-toolkit и 1c-develop того же автора. Указано, что часть описаний диагностик адаптирована из BSL Language Server. Лицензия MIT.
Частые вопросы
Нужен ли системный Python, если ставить расширение в VS Code?
Нет, платформенные VSIX для macOS, Linux и Windows содержат готовый бинарный файл.
Как подавить одно предупреждение в коде?
Комментарием // noqa: BSL012 после строки или парой // bsl-disable / // bsl-enable для диапазона.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything