XBSL (1C:Element)

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

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

Что внутри

Линтер с автоисправлениями – 190 правил в четырёх тирах: структура 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.