BSL Jupyter Runtime: интерактивные ноутбуки 1С

Установка

Ручная установка

py -3.12 -m venv .venv
.venv\Scripts\python.exe -m pip install "onec-interactive-jupyter==0.1.23" "ipykernel>=6.29,<7" "matplotlib>=3.11,<4"
.venv\Scripts\python.exe -m ipykernel install --user --name onec-bsl --display-name "1C BSL"

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Пакет добавляет kernel и магическую команду %%bsl для Jupyter-ноутбуков в VS Code: BSL-ячейки выполняются в одном сеансе 1С и сохраняют его состояние между вызовами, а результаты, например таблицы значений, приходят в Python как pandas.DataFrame для дальнейшего анализа и графиков. Можно остановить выполнение внутри типового метода конфигурации, посмотреть его локальные данные и стек вызовов через точки останова CAPTURE, а для эксперимента загрузить измененную локальную копию метода без обновления конфигурации ИБ, то есть hot reload. Служебное расширение 1С устанавливается в базу автоматически из wheel-пакета или вручную через Конфигуратор. Отдельный VSIX дает подсветку, автодополнение и переход к определению для BSL-ячеек прямо в ноутбуке.

Для кого. Для 1С-разработчиков и аналитиков, которые хотят исследовать поведение типовых методов конфигурации интерактивно, с остановками и правкой на лету, а результаты обрабатывать в Python.

Пример запроса к агенту

Останови выполнение метода расчета ФОТ перед возвратом результата и покажи таблицу значений как pandas.DataFrame

Ограничения

Требует Windows, Python 3.12+, VS Code 1.136+ и установленную платформу 1С, платформа, демобазы и выгрузки в пакет не входят. README прямо рекомендует использовать отдельную копию информационной базы и копию выгрузки исходников, а не боевые. Поддержка BSL в редакторе через VSIX помечена как предварительная версия. Собственный код распространяется по GPL-3.0-only, что накладывает копилефт-обязательства при распространении производных работ.

Как отключить. Удалите VSIX-расширение из VS Code, деинсталлируйте пакет командой pip uninstall onec-interactive-jupyter и отключите служебное расширение OnecInteractiveRuntime в копии ИБ.

Проверка безопасности

• Выполняет произвольный BSL-код в живом сеансе 1С, включая hot reload методов без обновления конфигурации
• Устанавливает служебное расширение в информационную базу и требует отключения безопасного режима при ручной установке

Коротко о README

README описывает интерактивный рантайм с BSL-ячейками в Jupyter-ноутбуках VS Code, дает пошаговый быстрый старт с установкой Python-пакета, регистрацией kernel, установкой расширений VS Code и запуском сеанса на копиях платформы, ИБ и исходников. Показывает демо-ноутбуки для ЗУП и УТ, объясняет компоненты (runtime core, расширение 1С, интеграция Jupyter, предварительное расширение VS Code), автоматическую и ручную установку служебного расширения через ExtensionMode, требования к разработке через uv и лицензию GPL-3.0-only с уведомлениями о сторонних компонентах.

Похожие