Справочник БСП

Почти любая современная типовая конфигурация 1С — Бухгалтерия, Управление торговлей, ERP и десятки других — собрана на общем фундаменте: Библиотеке стандартных подсистем (БСП). Это готовые механизмы от фирмы «1С» на все случаи жизни — работа с файлами, печать, контактная информация, права доступа, обмен данными, версионирование объектов, заметки и напоминания и так далее, всего около шестидесяти подсистем. Стандарты 1С прямо требуют: бери готовое из библиотеки, не изобретай своё.

Проблема в том, что БСП огромна — тысячи готовых процедур и функций, все их не удержать в голове. Документация живёт на портале ИТС по подписке, разбита по версиям. А ИИ-ассистент без опоры на неё в лучшем случае фантазирует: придумывает правдоподобно звучащие методы, которых нет, или предлагает написать с нуля то, что в библиотеке давно есть. Разработчик тратит время не на саму задачу, а на то, чтобы проверить, существует ли вообще функция, которую ему предложил ассистент.

Справочник БСП закрывает этот пробел — это встроенный поисковик по официальной документации БСП, который отвечает не «на глаз», а по канону. Спросите словами — «как отправить файл по почте средствами БСП» — и получите реальную функцию с параметрами и пометкой «сервер» или «клиент», а не правдоподобную выдумку.

Какую боль решает

• Ассистент перестаёт выдумывать методы БСП. Вместо правдоподобной галлюцинации — реальная функция из официальной документации, с настоящей сигнатурой и параметрами.
• Не нужно держать в голове тысячи функций. Разработчик описывает задачу словами, а не вспоминает точное имя процедуры и порядок аргументов.
• Меньше «велосипедов». Стандарты 1С требуют использовать готовое из БСП вместо самописных решений. Найти штатный механизм за секунды — и быстрее, и проще проходит код-ревью, чем защищать своё изобретение.
• Учёт версий. В разных версиях БСП API отличается. Справочник хранит документацию по конкретным версиям и отвечает применительно к той, что стоит в базе клиента.
• Доступ к платной документации ИТС без личного логина в ассистенте. Тексты документации выгружаются под нашей подпиской на этапе сборки — клиент получает уже готовый индекс.

Как это работает

В основе — тот же принцип, что и в семантическом поиске по вашей конфигурации: запрос переводится не в точное совпадение слов, а в смысловой вектор, и сопоставляется с описаниями методов и подсистем БСП. Поэтому работает даже размытая формулировка. Спрашиваете «как отправить файл по почте» или «какая подсистема отвечает за работу с производственным календарём» — и получаете кандидатов из реального канона библиотеки, а не из общих представлений нейросети о том, как «обычно бывает в 1С». Не нужно заранее знать точное имя функции или подсистемы — достаточно описать задачу своими словами.

Дальше — точная карточка найденного (или прямо названного) метода: как он называется, в каком модуле вызывается, синтаксис, список параметров с типами и описанием, возвращаемое значение, пример вызова. И отдельно, крупно — доступность: работает метод на сервере, на толстом клиенте или во внешнем соединении. Устаревшие методы тоже помечены. Эта пометка «сервер/клиент» — не формальность: вызов серверного метода оттуда, где сервер недоступен, и наоборот — одна из самых частых причин ошибок в коде 1С, которую иначе ловишь только на исполнении. Справочник закрывает этот вопрос ещё на этапе, когда ассистент только пишет код.

Если нужно не искать, а осмотреться в целой подсистеме — есть перечень всего её экспортного (публичного) API: какие процедуры и функции она отдаёт наружу. А по самой подсистеме — отдельная карточка: назначение, категория, признаки (работает ли в модели сервиса, в локальном режиме, для внешних пользователей, насколько тесная интеграция) и от каких других подсистем она зависит. Это удобно, когда вопрос ещё на уровне «а вообще какую подсистему брать под эту задачу и что она за собой потянет».

Тяжёлая часть — выгрузка документации из ИТС и расчёт смысловых векторов — сделана заранее, на нашей стороне, под нашей подпиской. Клиенту не нужно заводить свой логин в ИТС и не нужна видеокарта для этого модуля: готовый индекс для нужной версии БСП скачивается в приложении и сразу работает. Это отличает справочник БСП от индексации собственной конфигурации, где расчёт смысловых отпечатков идёт на видеокарте клиента.

Разведку по БСП ведёт не только сам ассистент по прямому запросу разработчика через Claude Code — тем же справочником пользуется и встроенный ИИ-агент: под капотом у него есть отдельный сценарий «подобрать функцию БСП под задачу», так что агент сам находит готовый механизм по описанию, прежде чем писать код с нуля.

Справочник в его нынешнем виде — не первая попытка. Раньше за БСП отвечал отдельный модуль, который разбирал XML-выгрузку «чистой» библиотеки и превращал её в плоский список функций — без текстов, примеров и пометок о доступности. Он оказался избыточным: то, что из БСП реально присутствует в рабочей базе клиента, и так индексирует основной поисковик по конфигурации, а канон по версиям гораздо честнее берётся из самой документации ИТС. Старый модуль не удалён, но признан устаревшим и не запускается — данные нового справочника попросту богаче: тексты, примеры вызова, доступность, зависимости подсистем, а не только голые имена функций.

Что это даёт

• Реальная функция вместо выдумки. Ответ строится на официальной документации БСП, а не на том, что нейросеть «где-то видела» — это снимает галлюцинации по именам методов и их параметрам.
• Ответ под вашу версию БСП. Разные версии различаются по API — справочник хранит документацию по версиям и не выдаёт метод, устаревший или ещё не появившийся в вашей.
• Готовая карточка для правильного вызова. Сигнатура, параметры, возврат, пример и пометка «сервер/клиент» — этого достаточно, чтобы сразу написать корректный код, не разбираясь дополнительно в документации ИТС. Отдельно помечены и устаревшие методы, чтобы ассистент не предложил то, от чего сама фирма «1С» уже рекомендует отказаться.
• Быстрый обзор незнакомой подсистемы. Перечень всего экспортного API подсистемы позволяет «осмотреться» в ней целиком, прежде чем браться за задачу, а карточка подсистемы — назначение, категория, признаки, зависимости — помогает понять, что она за собой потянет.
• Соответствие стандартам 1С без лишних усилий. Стандарты требуют использовать готовые механизмы БСП — справочник делает поиск штатного решения вопросом одной фразы, а не часового рытья по документации.
• Ничего не качается на машину клиента лишний раз. Индекс собран заранее и один раз скачивается целиком под нужную версию, доступ к самому ИТС в установщик клиента не входит.

Честно об ограничениях

Сейчас в справочнике работает слой «методы» и слой «подсистемы»: поиск метода по смыслу, точная карточка метода, перечень методов подсистемы, поиск подсистемы по смыслу и карточка подсистемы — пять инструментов. А вот методический слой — «как применять подсистему», разделы документации про настройку и использование — в продукт пока не входит, это следующий шаг. Точно так же не реализованы пока подсказки по идиомам интеграции — например, что команды формы принято подключать через механизм «Подключаемые команды», а не обвязывать вручную. Это в планах, статус можно смотреть на странице планов.

Со стороны версий тоже стоит быть честным: сейчас в боевом каталоге доступны две версии БСП, ещё одна собрана и готовится к публикации. В архиве ИТС версий БСП около двух десятков, полный охват всех — отдельная задача на будущее, а не то, что уже сделано. И ещё: справочник — это канон самой библиотеки БСП, а не отражение того, что реально используется в конкретной базе клиента. Для вопроса «что из БСП реально есть в моей базе» служит основной поиск по конфигурации, а справочник БСП отвечает на другой вопрос — «как устроена сама библиотека».

Модуль доступен всем: пока идёт открытая бета, необязательные MCP-службы запускаются без оплаты — нужен только аккаунт с подтверждённой почтой.

Что дальше

Хотите, чтобы ассистент подбирал готовый метод БСП по описанию задачи, а не сочинял его на ходу, — скачайте one-s-mcp и подключите справочник к своей конфигурации. Что ещё умеет ассистент помимо работы с БСП — смотрите на странице всех возможностей.