Qadam1C 0.1.3 beta: подсказки, шаблоны, методы и области в Конфигураторе 1С

Qadam1C 0.1.3 — бета-версия помощника для разработчика 1С. Программа работает рядом с Конфигуратором: показывает подсказки возле курсора, вставляет шаблоны и добавляет меню действий с кодом.

Идея выросла из повседневных задач: меньше печатать одинаковые конструкции, быстрее находить нужное имя и выполнять простые правки прямо в привычном редакторе. Проект ещё развивается; эта публикация — приглашение попробовать бета-версию и помочь выявить ошибки.

Как появилась идея

Сейчас всё больше разработчиков экспериментируют с ИИ, создавая собственные аналоги известных программ. Меня заинтересовал этот подход и инструменты обратной разработки — reverse engineering, в том числе REA (Reverse Engineer Anything). Захотелось попробовать сделать свой аналог TurboConf для повседневной работы в Конфигураторе 1С. Так появился Qadam1C — пока экспериментальный проект на стадии бета-тестирования.

Подсказки прямо в Конфигураторе

При наборе появляется список ключевых слов, идентификаторов текущего модуля и подходящих шаблонов. Например, наберите Сооб, выберите Сообщить и нажмите Tab.

• Tab — принять вариант.
• ↑ / ↓ — выбрать вариант.
• Esc — закрыть подсказку.
• Ctrl+Alt+Пробел — запросить подсказки вручную.

Поиск учитывает сокращения и части имён. Возможности определения контекста пока ограничены: помощник не выполняет полный семантический анализ BSL.

Скриншот 1 в галерее — реальный пример подсказки возле курсора из тестирования бета-версии.

Более 150 шаблонов и свои заготовки

В программу включено более 150 шаблонов, импортированных из файла .st. Можно добавлять свои шаблоны и импортировать дополнительные наборы.

• Создание и редактирование своих шаблонов: название, группа, сокращение и текст.
• Импорт дополнительных файлов .st; точные дубли пропускаются.
• Включение и отключение отдельных шаблонов в подсказках.
• Сохранение личной библиотеки между запусками и обновлениями.

Шаблон вставляется без дополнительных вопросов. Маркер <?> удаляется, а курсор ставится на его место. Остальные поля <?…> тоже удаляются без диалогов: нужные значения разработчик дописывает вручную. Это упрощённая обработка полей, автоматические подстановки штатного механизма 1С не воспроизводятся.

В галерее есть снимок редактора шаблонов с примером «Если». Личная библиотека на снимке может отличаться от исходного набора: шаблоны можно удалять и добавлять.

Меню действий рядом с текущей строкой

Кнопка Qadam1C возле строки курсора открывает команды редактирования. Меню также вызывается сочетанием Ctrl+Alt+Enter.

• Дублировать текущую строку — также доступно по Ctrl+D.
• Вставить область на пустой строке или окружить выделение областью.
• Форматировать выделение или весь модуль.
• Выровнять выделение по = — для соседних простых присваиваний.
• Добавить / снять // у выделенных строк.
• Добавить / снять | у выделенных строк — например, при подготовке многострочного текста запроса.
• Открыть шаблоны и метаданные конфигурации.

Для команд над выделением используются полные строки. Повторное добавление // или | не дублирует уже имеющийся начальный префикс. Команда снятия удаляет один префикс. Операции редактирования проверялись с отменой через Ctrl+Z.

Пример выравнивания

Выделяем присваивания:

А=1;
ДлинноеИмя=2;
СуммаДокумента=100;

После команды «Выровнять выделение по =»:

А              = 1;
ДлинноеИмя     = 2;
СуммаДокумента = 100;

Подсказки по метаданным конфигурации

Через окно «Метаданные» можно загрузить штатный отчёт по конфигурации в формате MXL. Есть запуск сценария получения отчёта из открытого Конфигуратора. Полученный индекс сохраняется локально и используется для подсказок имён объектов, полей и общих модулей.

Полная XML-выгрузка конфигурации для такого индекса не требуется. Кэш своей конфигурации нужно создать на своём компьютере: в установщик чужие метаданные не входят.

Ограничение: отчёт содержит структуру метаданных, но не тексты модулей. Сейчас подсказываются имена общих модулей; их экспортные процедуры, функции и параметры по одному MXL не индексируются. Автоматическое определение базы и повторное подключение кэша после перезапуска Конфигуратора ещё требуют доработки. После точки доступна штатная подсказка платформы 1С.

Панель методов, областей и избранного

В отдельной панели отображаются процедуры, функции и области текущего открытого модуля. При переключении модулей список обновляется автоматически.

• Поиск методов и областей, иконки процедур и функций, отдельная колонка номера строки.
• Переход к методу или области двойным щелчком либо Enter.
• Группировка и сворачивание областей кнопками +/−.
• Перетаскивание методов внутри области и между областями; комментарии и директивы перемещаются вместе с методом.
• Сначала меняется будущий порядок в панели. Кнопка «Применить порядок» вносит все перестановки в 1С, «Отменить» сбрасывает план.
• Пустая строка между переносимыми методами добавляется только при её отсутствии.
• Избранные метаданные в нижнем блоке панели. Ctrl+Alt+B добавляет текущий объект из дерева или модуля.
• Блоки методов и избранного включаются независимо; панель можно прикрепить справа к 1С.
• Крестик очистки во всех полях поиска.

При изменении исходного текста после планирования перестановок применение блокируется, чтобы не затереть правки. Перенос в несовместимую ветвь условной компиляции не выполняется. Перед переносом сохраняется локальная резервная копия модуля; после применения доступна отмена через Ctrl+Z в 1С.

Демонстрация панели: список методов, области и перетаскивание.

Открытые исходники — MIT

Авторский код Qadam1C опубликован под лицензией MIT. Разрешены использование, изменение и распространение, включая коммерческие проекты, при сохранении текста лицензии и уведомления об авторских правах. Условия сторонних материалов указаны отдельно в THIRD_PARTY_NOTICES.md.

• Репозиторий Qadam1C на GitHub — код C#, ресурсы и инструкции сборки.
• Релиз 0.1.3 beta — архив исходников и контрольная сумма. Готовый установщик доступен во вложении этой публикации.
•  

Установка и первый запуск

1. Скачайте Qadam1C-Setup-0.1.3-x64.exe.
2. Установите программу. При желании оставьте включёнными создание ярлыка и запуск вместе с Windows.
3. Запустите Qadam1C и откройте модуль в Конфигураторе.
4. Наберите Сооб и проверьте принятие подсказки по Tab.
5. Для шаблонов откройте меню значка Qadam1C возле часов → «Шаблоны…».

Требования: Windows 10/11 x64 и установленная платформа 1С. .NET включён в установщик, отдельно устанавливать его не требуется. Установка выполняется для текущего пользователя.

Автозапуск можно изменить через правый щелчок по значку в трее → «Запускать вместе с Windows». Программа запускается при входе пользователя в Windows. Там же можно приостановить подсказки или завершить работу.

В установленной версии личные шаблоны и кэш находятся в %LOCALAPPDATA%\Qadam1C\data. Они сохраняются при удалении программы.

Что учитывать в бета-версии

• Основные команды проверялись в Конфигураторе 8.3.27.1936. Отдельные ранние проверки выполнялись на 8.5.1.1150. Это не означает подтверждённую совместимость со всеми релизами платформы.
• Другие масштабы Windows, несколько мониторов и совместная работа с другими помощниками требуют дополнительного тестирования.
• Форматирование базовое: отступы блоков и отдельные пробелы. Полноценного разбора всех конструкций BSL, сложных переносов и директив препроцессора пока нет.
• Выравнивание работает с соседними простыми присваиваниями с одинаковым начальным отступом; условия, комментарии и пустые строки разделяют группы.
• Вставка многострочных шаблонов использует буфер обмена с попыткой восстановить его прежнее содержимое.
• ИИ-функций в этой версии нет. Обработка подсказок и шаблонов выполняется локально.

Первые проверки лучше выполнить в тестовом модуле. Буду благодарен за воспроизводимые примеры: версия Windows и платформы, масштаб экрана, фрагмент тестового кода, последовательность действий, ожидаемый и фактический результат.

Планы развития

Ближайшие направления — надёжное подключение кэша к нужной базе, дальнейшая проверка совместимости и подсказки методов общих модулей при наличии их текстов. Это планы, в текущую версию эти возможности полностью не входят.