XBSL (1C:Element)

Инструментарий для 1С:Элемент: линтер с автоправками, LSP-сервер, поиск по документации, создание метаданных и перевод на английские написания. Плюс MCP-сервер и расширение VS Code на том же движке.

XBSL – это инструментарий для проектов 1С:Элемент. Такой проект пишут парами файлов: Имя.yaml описывает элемент, Имя.xbsl держит код. Сама платформа проверяет код один раз – серверной компиляцией при деплое, и ждать её долго. XBSL отвечает на исходниках сразу, ещё до деплоя. Поставляется он движком на Python и расширением VS Code поверх этого движка.

Что внутри

Линтер с автоисправлениями – 280 правил в четырех тирах: структура yaml, соглашения по тексту и типографике, структура кода и семантика, проверяемая по данным платформы и самому проекту (плагин может добавить свои правила поверх).
LSP-сервер – живая диагностика, переход к определению и автодополнение для любого редактора с поддержкой LSP.
Создание метаданных – создание объектов, реквизитов, маршрутов и форм без ручного написания yaml.
Перевод проекта на английские написания – словарь проекта, покрытие и проверка в CI. Остаток предлагает внешний переводчик, Yandex или Google.
Поиск по документации – локальный полнотекстовый индекс, собранный из вашего дистрибутива 1С:Элемент.
MCP-сервер – проверка исходников, поиск по документации и каждая операция создания метаданных. Всё это доступно ИИ-агенту как инструменты.
Веб-панель – локальная страница с находками проекта: настройки правил по тирам, фильтры и открытие файла в редакторе.
Расширение VS Code (издатель keyfire, идентификатор расширения keyfire.xbsl) – подсветка синтаксиса, диагностика по всему проекту, конструктор форм, дерево метаданных, панель документации платформы, отладка и кнопка деплоя – всё на том же движке.

Куда дальше

Быстрый старт – поставить пакет, сгенерировать данные о языке из своего дистрибутива, выполнить первую проверку.
Проверка исходников – ключи запуска, на что опираются глубокие правила, список принятых замечаний для старой кодовой базы, CI.
Правила – полный список проверок линтера с уровнями важности и областью действия.
Создание метаданных – объекты, реквизиты, маршруты и формы движком вместо ручного yaml; шаблоны кода.
Перевод проекта – словарь, покрытие, машинный перевод остатка, проверка в CI.
Серверы и плагины – сервер LSP, сервер MCP, веб-панель и свои правила, данные и уровни.
Данные платформы – сгенерированные наборы, индекс документации, сравнение двух версий платформы.
Команды – все команды и опции, собрано из самого инструмента.
Визуальный конструктор – панель формы, палитра, панель свойств и следование за курсором.
Панель документации – справка платформы внутри редактора: содержание, поиск, страница по символу.
Руководство – карта всего перечисленного.
README на GitHub – краткий обзор проекта и команды для быстрого старта.
Участие в разработке – как добавить правило или обновить данные о языке.

Рядом

Инструментарий 1С:Элемент состоит из двух половин: одна проверяет, вторая доставляет. Третий инструмент делает то же самое на соседней платформе.

Elemctl – доставка того, что проверил линтер: сборка из исходников, загрузка, применение. Он же проверяет, что стенд действительно поднялся на новой сборке. Команда XBSL: деплой на стенд в расширении VS Code зовёт именно его.
EDT-Bridge – то же самое на платформе 1С:Предприятие: мост MCP внутрь 1С:EDT. Через него агент читает конфигурацию, правит модули и формы, собирает расширения и отлаживается.

Данные о языке (ключевые слова, каталог типов stdlib, метамодель конфигурации) генерируются из вашего дистрибутива 1С:Элемент и не поставляются с проектом – см. Данные о языке в руководстве.

Не аффилировано с 1С. “1C:Element”, “1C:Fresh” и связанные наименования – товарные знаки соответствующих правообладателей – см. NOTICE.