Справка платформы за минуты вместо трёх часов
· Команда one-s-mcp · 2 мин чтения
Содержание
Чтобы ассистент перестал выдумывать методы платформы, ему нужен поисковый индекс справки 1С. Индекс собирается из файлов, которые и так лежат рядом с установленной платформой, — казалось бы, вопрос закрыт. Но у сборки есть цена, и на части машин она оказывалась запретительной.
Три часа против трёх с половиной минут
Сборка справки — это векторизация: каждый кусок документации превращается в отпечаток смысла. Считает такие отпечатки видеокарта. Замер по справке одной версии платформы дал около трёх часов на процессоре против трёх с половиной минут на видеокарте.
Разница в десятки раз — это не «немного дольше», это другой сценарий. У разработчика с игровой картой справка собиралась за время перекура. У коллеги на офисном ноутбуке без подходящей видеокарты — за рабочий день, который проще было потратить иначе. И это при том, что справка платформы у всех одна и та же: она общедоступна и одинакова для каждого, у кого стоит та же версия 1С.
Считать одно и то же по три часа на каждой машине — ровно та работа, которую разумно сделать один раз.
Готовое издание из каталога
Теперь в окне справки видно, какие версии у нас уже есть готовыми, и любую можно просто скачать. Справка появляется за минуты — и на машинах без видеокарты тоже.
Собрать своими силами по-прежнему можно: выбор остаётся за пользователем, ничего не отобрали. Больше того, собранное у себя издание можно выложить обратно в каталог — так он и пополняется.
Готовые издания привязаны к мажорной версии платформы, а не к каждой сборке. Сборок тысячи, и отдельное издание на каждую не имеет смысла: состав методов в пределах одной мажорной версии не меняется настолько, чтобы это оправдывало тысячу изданий.
Заодно: сигнатура целиком, а не половина
Вторая правка волны маленькая на вид и заметная в работе. Раньше в ответе по методу часть сведений терялась — и ассистент дописывал недостающие параметры «по правдоподобию». Ровно то, ради борьбы с чем справка и подключалась.
Теперь в ответе идут строки синтаксиса, список параметров, возвращаемое значение и доступность метода: клиент, сервер и прочее. Дописывать нечего.
Честно об ограничениях
Индекс справки всё равно нужно один раз получить — скачать готовое издание или собрать самому; для своей сборки на компьютере должна стоять сама платформа 1С, файлы берутся оттуда. Без этого шага поиска по справке не будет.
Каталог пополняется по мере сборки, и не любая версия в нём уже есть — если нужной пока нет, остаётся обычная сборка у себя. И ещё одно, чтобы не путать два разных сообщения: справка платформы — это не про приватность вашего кода. Она у всех одинаковая, так что скачивание готового издания ничего о вашей конфигурации не рассказывает; за секретность базы отвечают другие модули, и они работают локально.
Подробнее — на странице возможности «Поиск по справке платформы».