| name | 1c-platform-tools-config |
| description | Конфигурации запуска и служебные файлы (env.json и env-профили, launch.json, .gitignore, .gitattributes). Используй, когда пользователь просит открыть/создать env.json, переключить профиль запуска, запустить 1С с параметрами, создать .gitignore/.gitattributes или другие служебные файлы проекта. |
Конфигурации запуска и служебные файлы: команды расширения
Выполняй команды сам (Execute Command), не проси пользователя искать файлы вручную.
env-профили запуска
Профиль — самодостаточный файл настроек vanessa-runner в корне проекта:
env.json — базовый профиль (по умолчанию);env.<id>.json — именованный профиль (env.dev.json, env.prod.json);env.local.json — личные переопределения разработчика (в .gitignore, профилем не считается): плоский объект с флагами vrunner (--ibconnection, --db-user, --db-pwd, --v8version, --additional); приоритет: временные параметры > env.local.json > профиль.
В значениях профиля и перекрытий работает ${gitBranch} — имя текущей ветки git как безопасное имя каталога (feature/RS-123 → feature-RS-123); так делают отдельную ИБ на каждую ветку: "--ibconnection": "/F./build/${gitBranch}". Текущее значение видно в env.status (поля gitBranch, effectiveIbConnection, localOverrides).
Активный профиль выбирается локально (не коммитится) и подставляется во все команды vrunner через --settings. Поверх него можно задать временные параметры (адрес ИБ, пользователь, пароль, версия платформы, дополнительные параметры) — отдельные флаги перекрывают значения файла и применяются ко всем командам vanessa-runner. Сам запуск Предприятия/Конфигуратора/тестов — обычными командами (см. навык 1c-platform-tools-run и др.) под активным профилем.
Перед операциями, зависящими от окружения, проверяй состояние через env.status (MCP: env_status): какой профиль активен, какой файл настроек и строка подключения будут применены.
Правило выбора профиля. Если пользователь назвал профиль в запросе («запусти тесты под test», «переключись на storage») — переключи его: 1c-platform-tools.env.selectProfile с аргументом-строкой (id dev, имя файла env.dev.json или подпись профиля). Если профиль не назван — ничего не переключай, работай под активным профилем из статус-бара. Для разового прогона под другим профилем без переключения передавай settingsFile в MCP-инструменте.
| Запрос пользователя (примеры) | Command ID |
|---|
| Узнать активный профиль и окружение | 1c-platform-tools.env.status (read-only, возвращает JSON: профиль, файл настроек, версия vrunner, временные параметры, строка подключения) |
| Выбрать/переключить профиль запуска | 1c-platform-tools.env.selectProfile (аргумент-строка) или MCP env_selectProfile { profile: "имя" } — без окна выбора |
| Создать новый профиль (env.dev.json и т.п.) | 1c-platform-tools.env.createProfile |
| Задать временные параметры (ИБ/версия/пользователь) на лету | 1c-platform-tools.env.setOverrides |
| Сбросить временные параметры | 1c-platform-tools.env.clearOverrides |
| Открыть env.json | 1c-platform-tools.env.editSettingsFile |
| Открыть launch.json | 1c-platform-tools.launch.editConfigurations |
Служебные файлы
Расширение создаёт служебные файлы из шаблонов. Существующий файл не перезатирается — открывается; отсутствующий создаётся. При создании env.json секции команд (vanessa/xunit/syntax-check) выбираются флажками.
| Запрос пользователя (примеры) | Command ID |
|---|
| Создать служебные файлы (меню выбора) | 1c-platform-tools.serviceFiles.create |
| Создать базовый набор | 1c-platform-tools.serviceFiles.createRecommendedSet |
| Создать .gitignore | 1c-platform-tools.serviceFiles.createGitignore |
| Создать .gitattributes | 1c-platform-tools.serviceFiles.createGitattributes |
| Создать env.json | 1c-platform-tools.serviceFiles.createEnvJson |
Назначение служебных файлов
- env.json / env..json — настройки vanessa-runner (подключение к ИБ, версия платформы, секции команд
default/vanessa/xunit/...).
- env.local.json — локальные переопределения; не коммитится.
- .gitignore — исключения для 1С:
/build/, /oscript_modules/, env.local.json, lastUploadedCommit.txt, бинарники *.cf/*.cfe/*.epf/*.erf/*.dt.
- .gitattributes — текст/бинарь и переводы строк для файлов 1С (
*.bsl, *.os, *.xml — текст; *.cf, *.epf — бинарь).
- lastUploadedCommit.txt — служебный файл инкрементальной выгрузки конфигурации (хранит SHA последнего выгруженного коммита).
- tools/ — конфиги инструментов (VAParams.json, vrunner.init.json, yaxunit.json, xUnitParams.json и пр.), на которые ссылаются секции env.json.
Примеры
- «Запусти 1С с другой версией платформы» →
1c-platform-tools.env.setOverrides (задать --v8version), затем запуск.
- «Переключись на dev-профиль» →
1c-platform-tools.env.selectProfile.
- «Сделай gitignore для проекта 1С» →
1c-platform-tools.serviceFiles.createGitignore.
