--- name: onec-setup-and-connect description: Проверить готовность рабочего стенда 1c-ai-pipeline, настроить автора Git по имени и корпоративной почте пользователя, открыть скачивание 1С:EDT в браузере, установить или пересобрать EDT MCP и Vanessa Runner, скачать репозиторий 1С по ссылке от релиз-инженера и подключить тестовую базу 1С (КА, ЗУП, ERP, УТ). --- # Развёртывание стенда и подключение базы 1С Используй этот навык, когда пользователь просит проверить или завершить настройку плагина `1c-ai-pipeline`, присылает свои имя и корпоративный e-mail, присылает ссылку на конфигурацию 1С от релиз-инженера, пишет «я поставил EDT», просит разобраться с недоступным `EDT MCP` или `Vanessa Runner`, либо хочет начать работу со своей тестовой базой **1С:КА**, **1С:ЗУП**, **1С:ERP** или другой конфигурацией 1С. ## 1. Правила безопасности и общения с пользователем 1. **Пользователь не обязан знать Git, SSH или командную строку**: - **Никогда не проси пользователя вручную вводить `git config`, `git clone`, `ssh-keygen` в терминале.** - Спрашивай простым языком только человеческие данные (Имя и Фамилию, корпоративный e-mail, ссылку от релиз-инженера, путь к тестовой копии базы), а все команды выполняй сам. 2. **Никогда не работай на продуктивной (боевой) информационной базе** — для диагностики, выгрузки исходников и автотестов используй только **тестовую копию базы**. 3. **Обязательно проверяй ручной первый запуск и лицензию 1С**: перед автоматическими запусками уточни у пользователя, открывал ли он эту тестовую базу **1 раз вручную в «1С:Предприятии»** и запускается ли она **без окна лицензии** (иначе фоновый запуск `1cv8` через `Vanessa Runner` повиснет на модальном диалоге пин-кода лицензии). 4. **Не проси пароль от базы в открытом тексте чата** и **не останавливай запущенные процессы пользователя** (`1cv8`, `1cv8c`, `1cedt`, `rphost`, `rmngr`, `ragent`). --- ## 2. Шаг 1 — Точная диагностика машины (`doctor`) Запусти встроенный скрипт диагностики из корня установленного плагина (`${PLUGIN_ROOT}` или `.agents/plugins/1c-ai-pipeline` внутри клона `vanessa-ai-pipeline`): ```sh node "/bin/pipeline-deploy.cjs" doctor --json ``` Скрипт возвращает полную картину без догадок: - `nodePath`: исправность `node` в системном `PATH` и наличие `mise`; - `gitIdentity`: установлен ли `Git` и заполнены ли `user.name` и `user.email` (`configured: true/false`); - `platforms`: найденные на диске версии платформы **1С:Предприятие 8** (`8.3.x` / `8.5.x`); - `vanessaRunner`: путь к `oscript`, `runner_root`, зависимости `oscript_modules` и фактическое число ответивших инструментов MCP; - `vanessaAutomation`: наличие клона и собранных обработок `.epf`; - `edt`: точный статус связки с **1С:EDT** (`ready`, `edt_not_running`, `port_conflict`, `plugin_not_installed`, `edt_not_installed`). --- ## 3. Шаг 2 — Автоматическая настройка автора Git и скачивание репо от релиз-инженера 1. **Если `gitIdentity.configured == false`**: - Спроси у пользователя в чате простым языком: *«Как вас зовут (Имя и Фамилия) и какой у вас корпоративный e-mail?»* - Как только пользователь ответит, сам пропиши настройки командой: ```sh node "/bin/pipeline-deploy.cjs" setup-git --name "Имя Фамилия" --email "user@company.ru" ``` *(Команда также включает `core.quotepath=false`, чтобы русские имена объектов 1С читались без восьмеричных кодов.)* 2. **Получение репозитория конфигурации 1С (КА / ЗУП / своей ИБ)**: - Дай пользователю готовый текст для **релиз-инженера**: *«Выдай мне, пожалуйста, доступ к репозиторию конфигурации 1С на мою корпоративную почту и пришли ссылку»*. - Когда пользователь пришлёт ссылку (`https://...` или `git@...`) — сам склонируй репозиторий в удобную рабочую папку пользователя (`git clone `). - Если корпоративный Git-сервер требует **SSH-ключ** (ошибка `Permission denied (publickey)` или запрос от релиз-инженера): сам проверь `~/.ssh/id_ed25519.pub` (если файла нет — сгенерируй без пароля через `ssh-keygen -t ed25519 -N "" -C "" -f ~/.ssh/id_ed25519`) и выведи пользователю готовую публичную строку `ssh-ed25519 ...`, чтобы он просто переслал её релиз-инженеру. --- ## 4. Шаг 3 — Разбор статуса 1С:EDT и `EDT MCP` Действуй строго по полю `edt.status` из вывода `doctor --json`: ### Случай А: `edt_not_installed` (1С:EDT на компьютере не установлена) 1. **Открой страницу скачивания 1С:EDT прямо в браузере пользователя** (если она ещё не была открыта на этапе `deploy --open-edt-download`): ```sh node "/bin/pipeline-deploy.cjs" open-edt-download ``` 2. Сообщи пользователю простым языком: - в его браузере открыта официальная страница https://edt.1c.ru/ (также доступно на https://releases.1c.ru/project/DevelopmentTools10 — скачивание **бесплатное** по обычной учётной записи `portal.1c.ru`, платный договор ИТС не требуется; бесплатная комьюнити-лицензия при необходимости оформляется на https://developer.1c.ru/); - нужно скачать установщик **1C:EDT Start** и через него поставить **1С:EDT `2025.2`, `2026.1` или `2026.2`**, один раз запустить и закрыть окно EDT, после чего написать в чат *«EDT поставил»*; - при этом **ждать установки EDT не обязательно** — начинать диагностику тестовой копии базы КА / ЗУП можно уже сейчас напрямую через Платформу 1С и `Vanessa Runner`. ### Случай Б: `plugin_not_installed` (или пользователь написал «EDT поставил») 1. Убедись, что окно 1С:EDT сейчас закрыто, и выполни сборку из локального форка `./edt-mcp` и установку в 1С:EDT: ```sh node "/bin/pipeline-deploy.cjs" deploy-edt ``` Скрипт по умолчанию собирает p2-репозиторий из живых исходников `./edt-mcp` через `mise` (`mise install` + `mise run build`) и устанавливает плагин `com.ditrix.edt.mcp.server.feature.feature.group` через `org.eclipse.equinox.p2.director` с комплектной JVM этой установки 1С:EDT. *(Крайний резервный флаг `--from-release` для скачивания архива из GitHub Releases используй только если на корпоративном ПК полностью заблокирован доступ к Maven.)* ### Случай В: `port_conflict` (порт `8765` занят посторонним процессом, например возвращает `HTTP 404`) Ответ `HTTP 404` на `127.0.0.1:8765` означает, что порт занят чужим локальным сервисом, а не сервером 1С:EDT. Используй свободный порт `edt.suggestedPort` из отчёта `doctor` (обычно `8766`) через `deploy-edt --port <порт>` и синхронизируй URL подключения `edt-mcp` в настройках клиента (`http://127.0.0.1:<порт>/mcp`). ### Случай Г: `edt_not_running` (плагин в 1С:EDT установлен, но окно 1С:EDT закрыто) Поясни пользователю: `vanessa-runner` запускается чатом автоматически в фоне, а `edt-mcp` работает внутри открытого приложения **1С:EDT** — чтобы появились инструменты `edt-mcp`, нужно запустить 1С:EDT с открытым проектом и дождаться готовности модели (`list_projects` → `READY`). --- ## 5. Шаг 4 — Проверка лицензии и подключение тестовой базы КА / ЗУП / ERP 1. **Перед первым вызовом `Vanessa Runner` на базе пользователя**: - Убедись, что пользователь указал путь к **тестовой копии базы** (не боевой!) и **открывал её хотя бы 1 раз вручную в «1С:Предприятии»**, активировав лицензию (корпоративный пин-код или бесплатную комьюнити-лицензию с https://developer.1c.ru/, открыть страницу в браузере можно командой `node "/bin/pipeline-deploy.cjs" open-edt-download --license`). 2. **Режим 1 (напрямую по тестовой базе через Платформу 1С + `Vanessa Runner`)**: - Выгрузи нужные объекты/конфигурацию или расширение через `vanessa-runner` (`cf_dump` / `validate_syntax_check`) и приступай к разбору задачи по КА (`onec-ka-incident-router`) или ЗУП (`onec-zup-payroll-diagnostics`). 3. **Режим 2 (через 1С:EDT + `EDT MCP`)**: - Открой в 1С:EDT склонированный проект конфигурации от релиз-инженера (либо для доработки типовой КА/ЗУП создай **Проект расширения конфигурации** через `Файл → Новый → Проект расширения конфигурации`), убедись через `list_projects`, что проект в статусе `READY`, и приступай к задаче. --- ## 6. Как дорабатывать и патчить компоненты локально Все 4 компонента развёрнуты в живых Git-клонах, чтобы ИИ-исполнитель мог исправлять их на месте: - **Навыки (`skills/`) и перехватчики (`hooks/`)**: правь в клоне `vanessa-ai-pipeline` (`.agents/plugins/1c-ai-pipeline`) и переподключай плагин (`codex plugin add 1c-ai-pipeline@1c-ai-pipeline`). - **Плагин `EDT MCP`**: правь исходники в `./edt-mcp`, закрывай окно 1С:EDT и запускай `node "/bin/pipeline-deploy.cjs" deploy-edt --rebuild`. - **`Vanessa Runner`**: правь `.os`-исходники в `./vanessa-runner` — `runner_root` указывает прямо на этот клон. - **`Vanessa Automation`**: правь исходники в `./vanessa-automation` и пересобирай обработки через `mise run compile`.