CLI для файлов бизнес-процессов Bitrix
Bitrix BPT CLI Tool
Консольная утилита на .NET распаковывает, собирает и показывает содержимое файлов *.bpt с шаблонами бизнес-процессов Bitrix
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Работает только с локальными файлами .bpt, не подключается к порталу Bitrix24
- Команда build может испортить файл при неверной ручной правке текста между длинами строк
Установка
Ручная установка
git clone https://github.com/bslie/bitrix-bpt-cli-tool.git && cd bitrix-bpt-cli-tool && dotnet buildСборка из исходников, нужен .NET 9.0 SDK.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Файлы .bpt в Bitrix это PHP-сериализованные данные, сжатые одним из четырех способов: gzip, zlib, deflate или без сжатия. Утилита дает три команды: dump достает содержимое в текст (с флагом --pretty можно получить читаемое дерево вместо сырого сериализованного текста), build собирает файл обратно с нужным способом сжатия, info показывает сводку о файле и определяет формат упаковки по заголовку. Поддерживается работа через stdin и stdout, так что команды можно соединять в конвейер, а при сборке недостающие директории создаются автоматически.
Для кого. Для разработчиков и администраторов Bitrix, которым нужно редактировать или анализировать шаблоны бизнес-процессов вне визуального редактора.
Подходит, если
- Нужно достать текст шаблона бизнес-процесса из файла .bpt для просмотра или версионирования в git
- Нужно собрать .bpt обратно после ручной правки текста
- Нужно определить, каким способом сжат конкретный .bpt перед пересборкой
Не подходит, если
- Нужно редактировать бизнес-процесс визуально: для этого есть штатный редактор Bitrix
- Нужна проверка целостности ссылок внутри процесса: эта утилита только упаковывает и распаковывает, без валидации
Пример запроса к агенту
Распакуй файл bp-179.bpt в читаемый вид и покажи, какие активности в нем используютсяОграничения
Нужен .NET 9.0 SDK для сборки из исходников либо готовый релиз под свою платформу. При правке текста между dump и build нельзя менять длины строк внутри блоков s:<длина>:"...", иначе сборка не совпадет байт-в-байт. Инструмент не проверяет ссылки на активности и константы внутри процесса, для этого нужен отдельный анализ. Одна звезда, README только на русском и английском в одном файле.
Как отключить. Удалите скачанный бинарь или папку с исходниками, инструмент не устанавливает ничего в систему.
Проверка безопасности
- Работает только с локальными файлами .bpt, не подключается к порталу Bitrix24
- Команда build может испортить файл при неверной ручной правке текста между длинами строк
Коротко о README
README перечисляет три команды с примерами (dump, build, info), четыре формата сжатия, требование .NET 9.0, ссылку на готовые сборки в Releases, предупреждение о сохранении длин сериализованных строк при ручной правке и инструкцию, где в интерфейсе Bitrix on-premise взять файл .bpt: Настройки → Инструменты → Бизнес-процессы → Шаблоны.
Частые вопросы
Как понять, каким способом сжат мой .bpt?
Командой info: она показывает заголовок и фактический формат, который сработал при распаковке.
Можно ли передавать данные через pipe между dump и build?
Да, обе команды поддерживают stdin и stdout через флаг -o - или --in/--out -.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything