Headless EDT
Автозапуск headless EDT, ожидание моделей проектов в задании CI и перенос готовой рабочей области на другую машину.
Обвязка запускает headless EDT, если EDT не запущена. На странице описаны этот запуск, ожидание моделей проектов в задании CI и перенос рабочей области, которую EDT уже проиндексировала.
Автозапуск
При автоматическом запуске отдельный процесс-наблюдатель держит ввод CLI открытым и отслеживает
запущенный 1cedtcli. Если CLI завершается до готовности моста, обвязка возвращает код завершения
и до 16 КиБ из конца объединенного stdout/stderr. Вывод декодируется как UTF-8 с заменой
некорректных байтов. Наблюдатель завершается вместе с CLI; следующий вызов может повторить запуск.
--start-timeout ограничивает ожидание готовности, пока CLI работает. По таймауту работающий
процесс остается запущенным; EDT также продолжает работу после завершения короткой команды обвязки.
Сообщение о таймауте называет процесс-наблюдатель и говорит, успела ли ответить консоль EDT. Если
успела, сама EDT запустилась, а плагин нет, и дальнейшее ожидание не поможет.
Перед запуском обвязка проверяет, что может прочитать jar плагина в dropins: EDT работает от
того же пользователя и тоже не смогла бы его прочитать. Пока EDT запускается, обвязка читает
журнал рабочей области .metadata/.log. Если плагин не может загрузиться, обвязка останавливает
запущенную ею headless EDT и сообщает причину.
Одна headless EDT обслуживает одну рабочую область. Наблюдатель держит блокировку своей рабочей области, пока работает. Вторая обвязка, запущенная на ту же рабочую область, ждет эту EDT, даже если список процессов ее еще не показывает или запрос PowerShell, через который этот список получается в Windows, не укладывается в отведенное время.
Если мост не поднимается, в headless EDT или в окне EDT, выполните edt-bridge-mcp doctor --workspace <ws>. Команда ничего не запускает и не меняет. Она проверяет jar в dropins и то,
может ли EDT его прочитать, какую версию моста регистрирует каждая конфигурация EDT, запущена ли
EDT от администратора и была ли ошибка загрузки плагина в последнем сеансе EDT. Для каждой
найденной проблемы команда называет шаг, который ее исправляет. Сразу после self-update
конфигурация EDT еще помнит прежний jar. Это не проблема: EDT обновит запись при следующем
запуске, и команда покажет ее пометкой note с кодом выхода 0.
Ожидание моделей
Мост отвечает раньше, чем большой проект проиндексирован, и инструмент, вызванный в это время,
получает отказ “no BM model”. В задании CI модели ожидает команда edt-bridge-mcp wait-ready --project <имя> --timeout <секунды>. Если EDT не запущена, команда запускает headless EDT, а затем
опрашивает /status, пока каждый названный проект не сообщит modelReady; без --project она
ждет все открытые проекты EDT. Код завершения 0 означает, что проекты готовы, 1 – EDT не запущена
или завершилась, 2 – срок истек, а EDT еще загружается. Проект, импортированный после запуска,
тоже ожидается.
Готовая рабочая область
Импорт и индексация большой конфигурации занимают у headless EDT десятки минут, а рабочая
область, которую EDT сохранила при штатной остановке, открывается за несколько. Команда
edt-bridge-mcp workspace переносит такую рабочую область на следующую машину или в контейнер:
- Запустить EDT на рабочей области, импортировать проекты и дождаться моделей:
edt-bridge-mcp wait-ready --workspace <ws> --project <имя>. - Сохранить замечания EDT по проектам:
edt-bridge-mcp workspace checks --workspace <ws> --object <fqn> --output before.json. Команда вызываетedt_project_errorsс обновлением для каждого проекта или каждого объекта из--objectи отклоняет неполный, незавершенный или обрезанный по пределу список. На большой конфигурации проверять несколько объектов, замечания которых зависят от индексированной модели: проект целиком может превысить предел числа замечаний. - Остановить EDT командой
edt-bridge-mcp shutdown --workspace <ws>, чтобы она сохранила состояние. - Упаковать рабочую область:
edt-bridge-mcp workspace pack --workspace <ws> --archive ready.tar.gz. - На следующей машине восстановить ее:
edt-bridge-mcp workspace restore --archive ready.tar.gz. - Запустить там EDT, дождаться моделей и сравнить замечания:
edt-bridge-mcp workspace checks --workspace <ws> --compare before.json.
Архив имеет формат PAX tar: .tar, .tar.gz или, начиная с Python 3.14, .tar.zst. Он
сохраняет время изменения с долями секунды, потому что EDT сравнивает его с сохраненным
состоянием. В архив не попадают блокировка рабочей области, журналы .metadata (EDT пишет туда
командную строку с токеном моста), файлы pid и блокировки журналов. EDT хранит в метаданных
абсолютные пути, поэтому restore распаковывает рабочую область только по пути, с которого она
упакована, в отсутствующий или пустой каталог и на системе того же типа. pack отказывает, пока
рабочую область использует EDT, и обе команды называют процесс или блокировку, которые ее держат.
Проект, файлы которого лежат вне каталога рабочей области, тоже приводит к отказу: архив его не
перенесет. checks --compare завершается с кодом 0 при совпадении замечаний и 2 при расхождении
и перечисляет замечания, найденные только с одной стороны. Где хранить архивы и какие входные
данные определяют архив, решает задание, которое их собирает.