Расширение для Visual Studio Code (а также Cursor, Windsurf и VSCodium), которое собирает повседневные инструменты разработки 1С в одном интерфейсе: команды vanessa-runner, навигацию по проектам и артефактам, дерево метаданных, TODO-панель, отладку и интеграцию с AI-агентами.
Документация
Возможности
- 1С: Инструменты — дерево команд: информационная база, конфигурация, расширения, внешние файлы, поставка, запуск, тестовое окружение, зависимости, выбор установки OneScript.
- 1С: Проекты — поиск проектов, избранное, теги, переключение через статус-бар и палитру команд.
- 1С: Администрирование — список информационных баз платформы и запуск Предприятия или Конфигуратора; консоль кластера через
rac: подключения к ras, сеансы, соединения, блокировки.
- 1С: Артефакты — дерево
*.cf/*.cfe/*.epf/*.erf с действиями сборки и разбора.
- 1С: Метаданные — дерево метаданных, свойства и состав объектов, формы, макеты и схемы компоновки, поддержка поставщика, поиск по имени и фильтр по подсистемам.
- 1С: Свойства — палитра свойств выделенного узла, как в конфигураторе.
- 1С: Список дел — панель меток TODO/FIXME/XXX/HACK/BUG в коде проекта.
- Служебные файлы — создание из шаблонов:
.gitignore, .gitattributes, профиль запуска, файлы tools/*.
- Профили запуска — параметры подключения к ИБ, активный профиль в статус-баре, своя база на каждую ветку.
- Автоматизация — пайплайны: визуальный редактор цепочек с ветками на успех и ошибку; хуки команд до, после и при ошибке.
- Автономный сервер — публикация файловой ИБ через
ibsrv: локальная разработка и отладка HTTP/Web/OData-сервисов, открытие в браузере.
- ER-диаграммы — интерактивные схемы связей метаданных, экспорт в Mermaid, Draw.io, SVG, PNG.
- Тестирование — панель тестирования VS Code: Vanessa, xUnit, YAxUnit, OneScript и 1bdd, запуск из редактора, статусы и переход к падению.
- Отладка 1С — точки останова с условиями, изменение значений переменных, отладка расширений и внешних обработок, замер производительности.
- AI-агенты — навыки для агентов и запуск команд через файл-триггер.
- MCP-сервер — агент вызывает команды расширения через MCP: установка, подключение, параметры инструментов и примеры фраз.
- Docker и ibcmd — выполнение команд в контейнере без локальной платформы 1С, включая GitHub Codespaces.
- Внешние компоненты — отладчик, дерево метаданных, JRE, OVM и Allure: загрузка, свои сборки и работа без доступа к GitHub.
- Сочетания клавиш — панели по номеру, синтаксический контроль как в конфигураторе.
- Формат EDT — проекты 1С:EDT наравне с выгрузкой конфигуратора: те же панели, команды и тесты.
Установка
Поиск по 1C: Platform Tools в панели расширений (Ctrl+Shift+X) или ссылкой:
| Редактор |
Откуда ставить |
| Visual Studio Code |
VS Marketplace |
| Cursor, Windsurf, VSCodium |
Open VSX |
| Без доступа к маркетплейсу |
файл .vsix из релизов, Extensions: Install from VSIX… |
В Cursor работают те же панели и команды; MCP там подключается своим файлом .cursor/mcp.json - его пишет команда расширения, см. MCP-сервер.
Расширение активируется, когда в рабочей области есть проект 1С: каталог с файлом packagedef. Проектов в окне может быть несколько, см. Проекты в рабочей области. Панели 1С: Проекты и 1С: Администрирование работают и без открытого проекта: первая поможет найти и открыть нужный, вторая не привязана к рабочей области вовсе.
Что нужно для работы
- Платформа 1С:Предприятие 8 — клиент, конфигуратор,
1cestart, rac/ras, ibsrv, ibcmd.
- OneScript, OPM и vanessa-runner — из раздела Зависимости в дереве 1С: Инструменты.
- 1С:EDT — если исходный код ведётся в формате EDT, см. Формат EDT.
- MCP — расширение 1C: Platform Tools MCP, если команды вызывает агент, см. MCP-сервер.
 Без локальной 1С команды можно выполнять в Docker — см. Docker и ibcmd.
Быстрый старт
Откройте существующий проект 1С с файлом packagedef или выполните команду 1С: Зависимости: Инициализировать проект.
При необходимости выполните 1С: Зависимости: Инициализировать структуру проекта. Будут созданы каталоги по шаблону vanessa-bootstrap.
Настройте подключение к ИБ в основном профиле запуска. Формат файла зависит от установленного vanessa-runner (расширение определяет версию автоматически):
// env.json — vanessa-runner 2
{ "default": { "--ibconnection": "/F./build/ib" } }
// autumn-properties.json — vanessa-runner 3
{ "vrunner": { "ibconnection": "/F./build/ib" } }
Профиль можно создать из дерева Служебные файлы (пункт «Осн. профиль запуска») или из статус-бара.
Установите зависимости через раздел Зависимости или команду 1С: Зависимости: Установить зависимости.
Откройте панель 1С: Инструменты и запускайте нужные команды из дерева.
Рекомендуемая структура проекта:
project/
├── .1cpt/ # Пайплайны и хуки команд
├── build/
│ ├── ib/ # Информационная база
│ └── out/ # Результаты сборки
├── features/ # Сценарии Gherkin (Vanessa Automation)
├── src/
│ ├── cf/ # Исходники конфигурации
│ ├── cfe/ # Исходники расширений
│ ├── epf/ # Исходники внешних обработок
│ └── erf/ # Исходники внешних отчётов
├── tasks/ # Задачи OScript
├── tests/ # Скриптовые тесты OneScript (*.os)
│ ├── cfe/ # Исходники тестовых расширений (YAxUnit и тесты)
│ └── epf/ # Исходники тестовых обработок (xUnit)
├── tools/ # Настройки и вспомогательные утилиты
├── env.json # Осн. профиль запуска (или autumn-properties.json для vrunner 3)
└── packagedef # Файл проекта и зависимостей OPM
Важные нюансы
- Команды выполняются задачами VS Code: вывод виден в панели задачи, прогон можно остановить. Интерактивный терминал возвращается настройкой
execution.useTasks.
- По умолчанию расширение ищет
vrunner и может использовать oscript_modules/bin/vrunner.bat проекта.
- Пути в настройках проекта задаются относительно корня проекта, если не указано иное.
Автор и поддержка
Автор: Ivan Karlo (i.karlo@outlook.com)
Поддержать проект:
| |
