KOT for 1C

Логотип KOT for 1C
Создавайте, запускайте и сопровождайте тесты 1С в Visual Studio Code.

KOT помогает писать сценарии СППР и Vanessa Automation: подсказывает шаги и параметры, открывает вложенные вызовы, собирает тесты и связывает редактор с работающей Vanessa. Свойства теста, библиотека шагов, информационные базы и результаты доступны в одном рабочем пространстве.

Начать работу · Учебная мастерская · Все документы · Изменения 3.0.0

Редактор feature, Менеджер тестов и свойства в KOT 3.0.0

Редактор сценария СППР с подсказками полей формы, Менеджер тестов, список баз и свойства сценария.

Что можно делать

Задача	Как помогает KOT	Подробнее
Написать первый тест	Мастер проекта, готовые примеры, создание сценария и выбор формата	Начало работы
Набрать шаг и его аргументы	IntelliSense шагов, сценариев, параметров и переменных; описание выбранной подсказки	Автодополнение
Найти нужный шаг	Библиотека Vanessa и проекта, категории, поиск по `!`, предпросмотр, вставка	Библиотека и редактор
Читать чужие тесты	F12, ссылки на вызовы, описание параметров, подсветка зависимостей	Навигация
Редактировать СППР	Один YAML или feature + метаданные YAML; свойства, параметры, вложенные вызовы	Форматы
Переиспользовать проверки	Вложенные сценарии, экспортные сценарии Vanessa, пользовательские BSL-шаги	Создание и переиспользование
Организовать набор тестов	Главные сценарии, процессы, группы, отметки сборки, избранное и фильтры	Менеджер тестов
Собрать и выполнить	Профили компиляции, проверка параметров, отчёт об ошибках, запуск feature	Компиляция и запуск
Проверить несколько шагов	F11, выполнение выделения, запуск с шага, точки останова и проба простого YAML до сборки	Управление Vanessa
Получить шаги из приложения	Запись действий, исследование формы, нативные подсказки и проверки всей формы	Form Explorer
Разобраться с ошибкой	Цвет строк, текст ошибки, переменные, журналы и диагностический пакет	Диагностика
Подготовить окружение	Базы, платформы, клиенты тестирования, DT/CF, шаблоны и эталонные состояния	Информационные базы
Работать в команде	Общие группы, каталоги и серии номеров в Git; личное состояние отдельно	Общие данные проекта
Использовать ИИ	Описание сценария, отчёт по изменениям конфигурации и ревью изменённых тестов	AI-инструменты

Выберите свой маршрут

У меня уже есть тесты СППР

Откройте папку проекта и запустите KOT: Настроить проект. Мастер найдёт сценарии, процессы и настройки запуска. Существующие исходники сохранят свой формат. Для полной компиляции потребуется обработка СборкаТекстовСценариев, выгруженная из вашей конфигурации СППР в .epf.

→ Подключить СППР и собрать первый тест

Я пишу обычные feature Vanessa

Используйте самостоятельные .feature: компилятор СППР для них не нужен. В свойствах доступны сценарии, теги и JSON запуска; библиотека и подсказки работают непосредственно в тексте feature.

→ Начать с Vanessa

Я знакомлюсь с автоматизацией 1С

Откройте копию учебной мастерской. В ней есть небольшие примеры с пояснениями и карта возможностей. Читать и редактировать их можно без установленной 1С; окружение выполнения подключается позже.

→ Пройти первое упражнение

Редактор и IntelliSense

Подсказки шагов, параметров и переменных

Начните вводить шаг или нажмите Ctrl+Space: KOT предложит подходящие определения и покажет описание выбранного варианта. Подсказки работают в YAML, feature + meta и самостоятельных feature с учётом доступных в каждом формате вызовов.

IntelliSense KOT: шаги Vanessa и вложенные сценарии с описаниями

Шаги и вызовы: определения Vanessa, экспортные сценарии и, в СППР, вложенные сценарии проекта.
Параметры СППР: введите [ для выбора объявленного параметра; в подсказке видно его значение по умолчанию.
Переменные Vanessa: $ и $$ вызывают подсказки локальных и глобальных переменных в соответствующем контексте.

Поиск по смыслу через `!`

Введите ! и слова о действии, выберите подходящий шаг и заполните его аргументы. Поиск работает локально, без AI-сервиса.

Аргументы из активной формы 1С

Имена элементов живой формы в аргументе feature

Подключённая форма подсказывает подписи и технические имена элементов, а для подходящих аргументов — таблицы, колонки и текущие значения.

Подробнее о подсказках и Библиотеке · Визуальный маршрут: от настройки до результата

Как выполняется тест

Исходник СППР проходит компиляцию. Самостоятельная feature Vanessa запускается без этого этапа. Дальше Vanessa управляет клиентом проверяемой базы, а KOT управляет сеансом Vanessa через MCP и показывает полученные результаты.

Посмотрите реальные примеры:

Кадры с результатом и пояснения есть в руководстве по управлению Vanessa.

Как устроен интерфейс

Карта рабочей области KOT

Слева — выбор и организация тестов, библиотека определений и информационные базы. В центре — обычный редактор исходника или полная панель инструмента. Справа — свойства открытого теста и переменные сеанса. В строке состояния — подключение Vanessa.

Сохранение файла, Undo и привычная навигация VS Code остаются доступны. Настройки KOT открываются отдельной страницей; знакомство с проектом запускается явной кнопкой.

Визуальный маршрут по возможностям · Контекстные меню · Реальные экраны · Знакомство с интерфейсом

Что нужно установить

Для чего	Необходимое окружение
Читать и писать тесты	VS Code 1.106+ и KOT; Windows, macOS или Linux
Компилировать СППР	Windows, платформа 1С и совместимая обработка компилятора СППР
Выполнять тесты	Windows, платформа 1С, Vanessa Automation и тестовая база
Управлять работающей Vanessa	Сеанс с совместимыми MCP-инструментами; KOT умеет подготовить собственный управляемый сеанс
Использовать AI	Доступный OpenAI-совместимый сервис; подключается отдельно

Установка и подготовка окружения · Совместимость и ограничения

Справочники поставщиков: компилятор СППР на ИТС, JSON-параметры Vanessa, программа работы с файлами 1С для MXL.

Документация описывает 3.0.0. Сверяйте её с версией установленного расширения. Локальные операции 1С на macOS/Linux пока не являются поддержанным сценарием KOT.

Важные различия

Компиляция превращает исходник СППР в feature. Выполнение проходит шаги в Vanessa. Успешная компиляция ещё не означает, что тест пройден.
Менеджер тестов KOT — панель VS Code. Менеджер тестирования — сеанс 1С с Vanessa, который управляет клиентами проверяемых баз.
Пара scen.feature + meta.yaml остаётся исходником СППР. Обычная самостоятельная feature запускается без компиляции СППР.
Возможности управления зависят от версии и инструментов MCP Vanessa. Простое выполнение YAML до сборки не заменяет проверку всего сценария компилятором.

Короткий словарь

Документация и участие

Руководства по задачам — от первого сценария до записи действий и сопровождения набора тестов.
Технические справочники — настройки, команды, форматы, компилятор и MCP.
Разработка и проверка — сборка расширения, тесты и правила проверки изменений.
Сообщить об ошибке — укажите версии KOT, VS Code и Vanessa, способ запуска и минимальный пример.

Полное дерево документации — раскрыть

Все текущие руководства, уроки и справочники доступны отсюда. Выберите ветку по своей задаче.

Материалы проектирования и история разработки находятся отдельно в репозитории: спецификации, планы, аудиты, черновики issue Vanessa, макет первого запуска и проверка интерфейса. Они фиксируют отдельные этапы работы; актуальное поведение описано в руководствах выше.

Лицензия и благодарности

KOT for 1C распространяется по MIT. Упоминания 1С, СППР и Vanessa Automation обозначают совместимость; KOT — самостоятельный проект.

Спасибо разработчикам Vanessa Automation, 1c-neurofish / onec-client-mcp-devkit и WebTransport, а также участникам проекта. Версии включённых компонентов, исходники и условия распространения перечислены в THIRD_PARTY_LICENSES.md.

Отдельная благодарность командам тестирования и DevOps 1C:Drive за практические сценарии, обратную связь и помощь с инфраструктурой, а также сообществу тестирования 1С.

Alexey Eremeev