1C: Platform Tools

Расширение для Visual Studio Code, которое собирает повседневные инструменты разработки 1С в одном интерфейсе: команды vanessa-runner, навигацию по проектам и артефактам, дерево метаданных, TODO-панель, отладку и интеграцию с AI-агентами.

Возможности

• Инструменты 1С — дерево команд: информационная база, конфигурация, расширения, внешние файлы, поставка, запуск, тестирование, зависимости.
• Проекты 1С — поиск проектов, избранное, теги, переключение через статус-бар и палитру команд.
• Артефакты 1С — дерево *.cf/*.cfe/*.epf/*.erf с действиями сборки и разбора.
• Метаданные 1С — дерево метаданных, создание и редактирование объектов, фильтр по подсистемам.
• ER-диаграммы — интерактивные схемы связей метаданных, экспорт в Mermaid, Draw.io, SVG, PNG.
• Тестирование — панель тестирования VS Code: дерево тестов Vanessa, xUnit, YAxUnit, OneScript и 1bdd, запуск из редактора, статусы и переход к падению, сборка тестовых обработок.
• Список дел — панель меток TODO/FIXME/XXX/HACK/BUG в коде проекта.
• Отладка 1С — точки останова с условиями, изменение значений переменных, отладка расширений и внешних обработок, замер производительности.
• AI и MCP — навыки для агентов, запуск команд через файл-триггер и MCP-сервер mcp-1c-platform-tools.
• Docker и ibcmd — выполнение команд в контейнере без локальной платформы 1С, включая GitHub Codespaces.

Установка

Установите 1C: Platform Tools (yellow-hammer.1c-platform-tools) из Marketplace (Ctrl+Shift+X).

Расширение активируется для проекта 1С при наличии файла packagedef в корне рабочей папки. Панель Проекты 1С работает и без открытого проекта — поможет найти и открыть нужный.

Быстрый старт

Для команд 1С нужна платформа 1С:Предприятие, OneScript, OPM и vanessa-runner — недостающее можно установить из раздела Зависимости. Для отладки — .NET 8.

1. Откройте существующий проект 1С с файлом packagedef или выполните команду 1C: Зависимости: Инициализировать проект.

2. При необходимости выполните 1C: Зависимости: Инициализировать структуру проекта. Будут созданы каталоги по шаблону vanessa-bootstrap.

3. Настройте подключение к информационной базе в env.json:

   {
     "default": {
       "--ibconnection": "/F./build/ib"
     }
   }
   

4. Установите зависимости через раздел Зависимости или команду 1C: Зависимости: Установить зависимости.

5. Откройте панель Инструменты 1С и запускайте нужные команды из дерева.

Рекомендуемая структура проекта:

project/
├── build/
│   ├── ib/                 # Информационная база
│   └── out/                # Результаты сборки
├── features/               # Сценарии Gherkin (Vanessa Automation)
├── src/
│   ├── cf/                 # Исходники конфигурации
│   ├── cfe/                # Исходники расширений
│   ├── epf/                # Исходники внешних обработок
│   ├── erf/                # Исходники внешних отчётов
│   └── tests/              # Исходники тестовых обработок (xUnit)
├── tasks/                  # Задачи OScript
├── tests/                  # Скриптовые тесты OneScript (*.os)
├── tools/                  # Настройки и вспомогательные утилиты
├── env.json                # Подключение к ИБ и параметры запуска
└── packagedef              # Файл проекта и зависимостей OPM

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

• Руководства по функциям — в каталоге docs.
• Пошаговое знакомство со всеми панелями — walkthrough Начало работы с 1C: Platform Tools (Help → Welcome).

Важные нюансы

• Все команды vrunner выполняются в терминале VS Code, чтобы был виден вывод.
• По умолчанию расширение ищет vrunner и может использовать oscript_modules/bin/vrunner.bat проекта.
• Пути в настройках проекта задаются относительно workspace, если не указано иное.

Автор и поддержка

Автор: Ivan Karlo (i.karlo@outlook.com)

Поддержать проект:

• Boosty
• Чаевые