Проблема, которую решает расширение:
Понимание логики работы сложных или незнакомых отчетов и обработок в 1С часто требует значительных усилий и времени на изучение кода. Документация может отсутствовать или быть неактуальной, а быстрый поиск ответа на конкретный вопрос ("Как рассчитывается этот показатель?", "Где используется этот реквизит?") затруднен.
Это ваш интеллектуальный помощник для работы с отчетами и обработками 1С. Используя мощь искусственного интеллекта Google Gemini, расширение анализирует код и структуру объектов, чтобы отвечать на ваши вопросы о их функциональности и логике работы. Оно помогает быстро разобраться даже в самом запутанном коде.
Почему выбрал Gemini?
Мой выбор в пользу Gemini обусловлен значительным размером его контекстного окна, достигающим 1 миллиона токенов. Такой объем позволяет передавать на анализ целиком даже очень крупные и сложные обработки или отчеты, что критически важно для глубокого анализа кода.
Ключевые возможности:
-
Детальный анализ структуры EPF/ERF:
-
Автоматически разбирает внутреннюю структуру файлов .epf и .erf, извлекая все компоненты: модуль объекта, формы, макеты (включая СКД).
-
Понимает взаимосвязи между элементами объекта.
-
-
Извлечение исходного кода:
-
Собирает полный текст модулей объекта, модулей форм, содержимое макетов СКД для предоставления AI наиболее полного контекста.
-
Опционально: Может анализировать объекты непосредственно из исходных файлов конфигурации (при настроенном пути).
-
-
Интерактивный Диалог с AI (Google Gemini):
-
Предоставляет AI (Gemini) извлеченный код как основу для ответов.
-
Задавайте вопросы на естественном языке! Например:
-
"Объясни простыми словами, что делает эта обработка?"
-
"Как рассчитывается показатель 'Сумма взаиморасчетов' в этом отчете?"
-
"Где в коде используется реквизит 'Контрагент'?"
-
"Какие основные шаги выполняет процедура 'Сформировать печатную форму'?"
-
"Найди все запросы к базе данных в этом объекте."
-
-
-
Интеграция и удобство:
-
Может быть вызвано непосредственно из формы анализируемого отчета или обработки.
-
Предоставляет интуитивно понятный интерфейс для ввода вопроса и просмотра ответа.
-
Отображает ответ AI в формате Markdown с подсветкой синтаксиса кода, что облегчает чтение и понимание.
-
Для кого это расширение:
-
Разработчики 1С (для анализа своего и чужого кода)
-
Консультанты и аналитики 1С (для понимания логики без глубокого погружения в код)
-
Специалисты технической поддержки
-
Продвинутые пользователи, желающие разобраться в работе конкретного инструмента
Как начать:
-
Установите расширение в вашу конфигурацию 1С.
-
Важно: При установке снимите флаги "Безопасный режим" и "Защита от опасных действий", так как расширение использует внешние компоненты (COM) и доступ к файловой системе (для чтения EPF/ERF и исходников конфигурации).
-
-
Получите API ключ для Gemini (API key).
-
Настройте модель AI:
-
Откройте справочник Модели.
-
Создайте новый элемент.
-
Укажите "Имя модели" (ознакомится со списком моделей можно тут (Модели)).
-
Вставьте ваш API ключ.
-
Задайте системный промпт (инструкцию для AI, например: "Ты - опытный разработчик 1С. Анализируй предоставленный код и метаданные отчетов/обработок 1С и отвечай на вопросы пользователя максимально точно и понятно. Приводи фрагменты кода для иллюстрации.").
-
Опционально (для анализа из исходников конфигурации):
-
Выгрузите конфигурацию в файлы через Конфигурация -> Выгрузить конфигурацию в файлы....
-
Убедитесь, что у пользователей, которые будут использовать эту функцию, есть права на чтение в папке с выгруженными файлами.
-
Укажите путь к этой папке в соответствующей константе настроек.
Опционально (для вызова из форм обработок):
-
Добавьте команду на форму обработки.
-
Вставьте код
Как использовать:
-
Способ 1: Анализ открытого объекта (если настроена интеграция):
-
Откройте нужный отчет или обработку в режиме 1С:Предприятие.
-
Нажмите на добавленную кнопку/команду вызова анализатора.
-
-
Способ 2: Анализ файла EPF/ERF:
-
Откройте основную форму диалога (через меню "Мастер 1С" -> "Диалог").
-
Нажмите кнопку выбора файла и укажите путь к .epf или .erf файлу, который хотите проанализировать.
-
-
Задайте вопрос: Введите ваш вопрос о работе объекта на естественном языке в поле для ввода.
-
Получите ответ: Нажмите кнопку "Задать вопрос" (или аналогичную). Расширение отправит запрос к Gemini, передав ему контекст (код, структуру) и ваш вопрос. Ответ AI будет отображен в специальном поле.
Пример:
Пользователь задает вопрос о конкретном показателе. AI предоставляет развернутый ответ, объясняя логику расчета.
Технические требования:
-
Доступ в Интернет (для работы Gemini API).
-
Возможно Вам потребуется VPN и DNS для обхода блокировок.
-
API ключ Gemini: Необходимо получить собственный ключ и указать его в настройках расширения (в справочнике "Модели").
-
Возможность использования COM-объекта VBScript.RegExp.
P.S. Расширение использует возможности искусственного интеллекта Google Gemini – технологии, которая постоянно развивается и обучается. Хотя Gemini стремится к максимальной точности, иногда ответы могут быть не до конца полными, содержать неточности или "галлюцинации". Пожалуйста, относитесь к результатам как к помощи в анализе и отправной точке для понимания, но всегда проверяйте критически важную информацию.
P.P.S. Есть какая-то проблема с отображением HTML документа, вылезают какие-то артефакты. Победить не смог, но работе с обработкой не мешают
P.P.P.S. Возможно можно попробовать и другие модели, но я не тестировал и не уверен что поместиться весь код в контекстное окно.
Проверено на следующих конфигурациях и релизах:
- 1С:ERP Управление предприятием 2, релизы 2.5.10.84
- Управление торговлей, редакция 11, релизы 11.5.16.80