BSL Jupyter Runtime: интерактивные ноутбуки 1С
BSL Jupyter Runtime
Интерактивный рантайм выполняет BSL-код 1С в Jupyter-ноутбуках VS Code с одним живым сеансом, точками останова и hot reload методов без обновления конфигурации
- 9 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Выполняет произвольный BSL-код в живом сеансе 1С, включая hot reload методов без обновления конфигурации
- Устанавливает служебное расширение в информационную базу и требует отключения безопасного режима при ручной установке
Установка
- Работает в
- Сервисы
Ручная установка
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"Установка Python-пакета и регистрация kernel из README.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Выполняет произвольный BSL-код в живом сеансе 1С, включая hot reload методов без обновления конфигурации
- Устанавливает служебное расширение в информационную базу и требует отключения безопасного режима при ручной установке
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет добавляет kernel и магическую команду %%bsl для Jupyter-ноутбуков в VS Code: BSL-ячейки выполняются в одном сеансе 1С и сохраняют его состояние между вызовами, а результаты, например таблицы значений, приходят в Python как pandas.DataFrame для дальнейшего анализа и графиков. Можно остановить выполнение внутри типового метода конфигурации, посмотреть его локальные данные и стек вызовов через точки останова CAPTURE, а для эксперимента загрузить измененную локальную копию метода без обновления конфигурации ИБ, то есть hot reload. Служебное расширение 1С устанавливается в базу автоматически из wheel-пакета или вручную через Конфигуратор. Отдельный VSIX дает подсветку, автодополнение и переход к определению для BSL-ячеек прямо в ноутбуке.
Для кого. Для 1С-разработчиков и аналитиков, которые хотят исследовать поведение типовых методов конфигурации интерактивно, с остановками и правкой на лету, а результаты обрабатывать в Python.
Подходит, если
- Нужно интерактивно исследовать расчет типового метода, например ФОТ, с остановкой внутри и просмотром промежуточных данных
- Нужно быстро проверить измененную версию метода без обновления конфигурации базы
- Нужно получить результат из 1С сразу как pandas.DataFrame для анализа и визуализации в Python
Не подходит, если
- Работа ведется не на Windows: README прямо указывает Windows как требование быстрого старта
- Нет отдельной копии информационной базы и копии выгрузки исходников: README требует именно копии, а не боевую базу
- Нужен готовый инструмент без настройки: нужны Python 3.12+, VS Code 1.136+, установленная платформа 1С и несколько расширений VS Code
Пример запроса к агенту
Останови выполнение метода расчета ФОТ перед возвратом результата и покажи таблицу значений как 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 в копии ИБ.
Частые вопросы
Можно менять метод без обновления конфигурации базы?
Да, это и есть hot reload: загружается измененная локальная копия метода, и правка проверяется в том же интерактивном сеансе без апдейта ИБ.
Результат из 1С сразу доступен как Python-объект?
Да, например таблица значений приходит как pandas.DataFrame, с которым можно работать обычными средствами Python.
Обсуждение
Вопросов и отзывов пока нет.
onec-hbk-bsl: линтер и MCP для BSL
1C HBK BSL (onec-hbk-bsl)
CLI-линтер и форматтер BSL со 180 диагностиками, LSP-сервером для VS Code и Cursor и MCP-инструментами для локальных ИИ-ассистентов
Набор скиллов, правил и MCP-серверов для разработки на 1С:Предприятие 8.3: агент работает по реальному коду и справке, а не по памяти
Локальный read-only набор MCP-серверов для 1С: Rust-индексатор кода, скиллы метаданных, галерея промптов и поиск по справке платформы
Линтер с автофиксами, LSP, поиск по документации платформы и метаданные-скаффолдинг для 1С:Элемент, плюс MCP-сервер и расширение VS Code на одном движке
Плагины Claude Code для 1С: навигация по BSL и горячая замена модулей
onec-claude-plugins
Два плагина для 1С: языковой сервер BSL вместо тяжелого grep по выгрузке и горячая замена модулей без перезапуска сеансов
Language Server для BSL на Rust с диагностиками кода, инкрементальным анализом и встроенным MCP-сервером для ИИ-агентов
Коротко о README
README описывает интерактивный рантайм с BSL-ячейками в Jupyter-ноутбуках VS Code, дает пошаговый быстрый старт с установкой Python-пакета, регистрацией kernel, установкой расширений VS Code и запуском сеанса на копиях платформы, ИБ и исходников. Показывает демо-ноутбуки для ЗУП и УТ, объясняет компоненты (runtime core, расширение 1С, интеграция Jupyter, предварительное расширение VS Code), автоматическую и ручную установку служебного расширения через ExtensionMode, требования к разработке через uv и лицензию GPL-3.0-only с уведомлениями о сторонних компонентах.