Инструменты по категориям
BSP Documentation — устанавливаемый плагин Codex с одним Agent Skill и встроенным Python MCP по STDIO. Вместе с инструкцией поставляются локальная документация БСП 3.1.11, навигационная карта API, SQLite-индекс и архив демо EDT 3.1.11.115.
Навык
bsp-development | определение версии БСП проекта, подбор подсистемы и группы API, поиск внутри выбранной области и обязательное чтение документации метода перед написанием вызова. Затем агент получает каталог демо, ищет полное имя метода и читает содержащую вызов процедуру вместе с callbacks, командами формы и клиент-серверными переходами. Для сложной неопределённой задачи инструкция предусматривает отдельное исследование документации агентом без права записи, а выбор решения и изучение полного примера остаются у основного агента. |
|---|
Исполняемый слой — девять встроенных MCP-tools для документации, навигации, версий и получения демо. Сам навык задаёт порядок их использования; поиск и чтение BSL-файлов демо выполняются файловыми инструментами агента. Изменение целевого проекта, диагностика кода и запуск 1С не реализованы в MCP.
Нужны Codex с поддержкой plugins и Python 3.11+. При первом запуске создаётся отдельное виртуальное окружение и устанавливаются зависимости; демо распаковывается в стабильный пользовательский каталог. Для гибридного поиска нужен OpenRouter с моделью, совместимой с готовым индексом; навигация и чтение не требуют ключа. Поставляемый снимок документации выбирается по семейству major.minor, а пример демо — по первым трём компонентам релиза. Инструкции применения навыка не являются автоматической проверкой того, что агент выполнил все шаги.
BSP Documentation содержит архив исходников демо-конфигурации БСП 3.1.11.115 в формате EDT. Он даёт агенту реальные процедуры использования API, callbacks, команды и код форм. В архиве 2961 BSL-модуль; это исходники конфигурации для самостоятельного изучения сценариев.
Инструмент доступа к примерам
get_bsp_demo_location | принимает версию БСП, выбирает демо по первым трём компонентам релиза, проверяет SHA-256 и при первом обращении распаковывает встроенный архив в стабильный пользовательский каталог. Возвращает путь, версию демо, формат 1c-edt и признак доступности; при отсутствии подходящего архива сообщает причину. |
|---|
Поиск полного имени метода и чтение содержащей вызов процедуры агент выполняет своими файловыми инструментами. Для UI-примера следует читать также связанные callbacks, обработчики формы и клиент-серверные переходы. MCP не возвращает готовую карточку примера и не вставляет код в целевой проект.
Поставка содержит демо 3.1.11.115; запрос релиза 3.1.12 не получает этот пример. Двоичные тела внешних компонент исключены из архива, поэтому поставка предназначена для чтения исходников, а запуск может потребовать дополнительные компоненты и платформу 1С. Для распаковки нужны Python 3.11+ и доступ на запись в каталог кэша; ключ OpenRouter и запущенная EDT не нужны. Встроенного CRUD шаблонов, памяти и веб-интерфейса нет; демо следует адаптировать к целевой конфигурации.
BSP Documentation поставляет локальный снимок документации БСП 3.1.11, карту программного интерфейса на 70 подсистем и SQLite-индекс семейства 3.1 на 3761 секцию. Встроенный MCP работает по STDIO. Навигация и чтение обращаются к локальным данным; гибридный поиск объединяет SQLite FTS5/BM25 и векторное ранжирование через RRF, получая embedding запроса по HTTPS через OpenRouter.
Инструменты документации
detect_bsp_version | определяет полный релиз и семейство индекса по локальному проекту или явно переданному файлу. Читает XML-данные поддержки EDT либо сведения о родительских конфигурациях в наследуемом формате. |
|---|---|
list_bsp_versions | перечисляет установленные семейства индексов; в поставке 3.1. |
list_bsp_api_sections | список подсистем программного интерфейса выбранного снимка документации. |
discover_bsp_api_sections | лексический подбор подсистем по задаче, с учётом названий, описаний и ключевых слов; лимит 1–20, по умолчанию 5. Эмбеддинги не используются. |
get_bsp_api_section_map | компактная карта групп API выбранной подсистемы: названия, описания и принадлежность к интерфейсу или переопределению. |
search_bsp | гибридный поиск с режимами all, development для программного интерфейса и override для переопределяемых callbacks. Фильтры subsystem/api_group применяются до ранжирования; для api_group нужна подсистема. Возвращает ID, заголовок, положение в документации и выдержку до 600 символов, с пометками рекомендаций и предупреждений; лимит 1–20, по умолчанию 8. |
get_bsp_section | полный текст индексированной секции по ID, с пометками рекомендаций и предупреждений. ID относится к секции, которая может быть частью большой страницы. |
get_bsp_source_section | исходная локальная страница найденной секции целиком, в Markdown или HTML. |
Команды подготовки материалов через CLI bsp-docs-mcp
inspect | разбор локального HTML-корпуса без эмбеддингов. |
|---|---|
export-html | выгрузка очищенных страниц в локальное дерево документации. |
crawl-its | сбор страниц документации БСП с ИТС; поддерживает переданные cookies/заголовки и продолжение по локальному манифесту. Текущий сборщик рассчитан на источник БСП 3.1.11. |
build-navigation | построение карты программного интерфейса из локальных HTML-страниц. |
index | построение SQLite-индекса и эмбеддингов документации через OpenRouter; при работе с каталогом создаёт и навигацию. |
serve | запуск MCP по STDIO. |
Нужны Python 3.11+, поставляемые данные и для поиска — ключ OpenRouter. Модель должна точно совпадать с qwen/qwen3-embedding-8b в готовом индексе. Перед первым поиском и затем через 24 часа выполняются пять контрольных запросов; несовместимость модели или провал проверки блокируют поиск. Эмбеддинги запросов кешируются в SQLite, поэтому поиску нужен доступ на запись к индексу. Навигация и чтение работают без ключа.
Версия запроса сводится к major.minor
релизы семейства 3.1 используют поставляемую документацию 3.1.11. Точная сверка каждого патч-релиза и автоматическое обновление с ИТС не выполняются. Код плагина не имеет указанной лицензии; документация и демо сохраняют отдельные условия правообладателя.