gitea-actions
67 lines
7.5 KiB
Markdown
67 lines
7.5 KiB
Markdown
---
|
|
description: "Диагностика установки плагина КОМПАС-3D: версия сервера, .NET, interop, соединение с КОМПАС"
|
|
---
|
|
|
|
Проверь установку плагина `kompas` по шагам и дай отчёт на русском. На каждый неуспешный пункт
|
|
назови конкретное действие, которое пользователь может сделать сам (без доступа к исходникам
|
|
проекта). Не переходи к следующему пункту, если текущий выявил фатальную проблему — сразу
|
|
переходи к отчёту с найденной причиной.
|
|
|
|
1. **Ожидаемая версия.** Прочитай `${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json` — поле
|
|
`version`. Это версия, которую Claude Code считает установленной; сервер едет в том же дереве
|
|
плагина, отдельной установки и кеша у него нет.
|
|
|
|
2. **Локальная сборка вместо поставки.** Проверь переменную окружения `KOMPAS_MCP_EXE`
|
|
(в PowerShell: `$env:KOMPAS_MCP_EXE`). Если она задана — это режим разработки: используется
|
|
указанный в ней бинарь, а не поставленный с плагином. Проверь, что файл по этому пути
|
|
существует; не существует — попроси пользователя пересобрать проект или снять переменную.
|
|
|
|
3. **Сервер на месте и запускается.** Если `KOMPAS_MCP_EXE` не задана, бинарь лежит в
|
|
`${CLAUDE_PLUGIN_ROOT}/bin/kompas-mcp.exe`. Проверь, что файл есть, и выполни
|
|
`& "<путь>\kompas-mcp.exe" --version` — команда печатает версию и сразу выходит, КОМПАС при
|
|
этом не запускается. Разбирай результат так:
|
|
- файла нет — установка повреждена: `/plugin update kompas@kompas-plugin`, при необходимости
|
|
переустановить плагин;
|
|
- команда не запустилась и в ошибке упомянут .NET / `hostfxr` / «framework» — на машине нет
|
|
нужного рантайма (см. пункт 4);
|
|
- версия не совпала с `plugin.json` — обновление применилось наполовину:
|
|
`/plugin update kompas@kompas-plugin`, затем `/reload-plugins`.
|
|
|
|
4. **.NET Runtime.** Сервер поставляется framework-dependent, поэтому рантайм нужен на машине:
|
|
`dotnet --list-runtimes` должен показать строку `Microsoft.NETCore.App 8.<любая>` или новее
|
|
(x64). Ни одной подходящей строки или самой команды `dotnet` нет — это и есть причина сбоя
|
|
пункта 3: попроси пользователя поставить .NET Runtime 8 или новее с
|
|
https://dotnet.microsoft.com/download/dotnet (нужен именно x64; Desktop Runtime не обязателен).
|
|
|
|
5. **КОМПАС-3D установлен и, возможно, уже запущен.** Сервер подключается к КОМПАС лениво — не при
|
|
старте MCP-сервера, а при первом вызове инструмента. Проверь двумя командами:
|
|
`Get-Process KOMPAS* -ErrorAction SilentlyContinue` (запущен ли сейчас) и
|
|
`Get-ChildItem 'HKLM:\SOFTWARE\Classes\KOMPAS.Application.5' -ErrorAction SilentlyContinue`
|
|
(зарегистрирован ли COM-класс, то есть установлен ли КОМПАС вообще). Запущен — сервер
|
|
присоединится к нему; не запущен, но зарегистрирован — попробует запустить новый экземпляр сам;
|
|
не зарегистрирован — это и есть причина сбоя: попроси пользователя установить КОМПАС-3D.
|
|
|
|
6. **Interop-сборки КОМПАС.** Сервер их не поставляет (они принадлежат АСКОН) и берёт из установки
|
|
КОМПАС: `<каталог установки>\SDK\Samples\CSharp.zip`, каталог `Common` внутри архива,
|
|
распаковка — в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`. Проверь наличие архива:
|
|
`Test-Path ((Get-ItemProperty "HKLM:\SOFTWARE\Classes\CLSID\$((Get-ItemProperty 'HKLM:\SOFTWARE\Classes\KOMPAS.Application.5\CLSID').'(default)')\LocalServer32").'(default)'.Trim('"') | Split-Path | Split-Path | Join-Path -ChildPath 'SDK\Samples\CSharp.zip')`.
|
|
Архива нет — КОМПАС установлен без компонента SDK: попроси пользователя доустановить SDK либо
|
|
задать переменную окружения `KOMPAS_INTEROP_DIR` с каталогом, где лежат `KompasAPI7.dll`,
|
|
`Kompas6API5.dll`, `Kompas6Constants.dll`, `Kompas6Constants3D.dll`. Если переменная
|
|
`KOMPAS_INTEROP_DIR` уже задана — проверь, что эти четыре файла в указанном каталоге есть.
|
|
|
|
7. **Проверка соединения инструментами MCP.** Вызови инструмент `kompas_connect` — он либо
|
|
присоединится к уже запущенному КОМПАС, либо запустит новый и покажет окно, и вернёт версию и
|
|
редакцию. Если вызов упал с ошибкой — приложи её текст к отчёту дословно (обычно это означает,
|
|
что КОМПАС не установлен, лицензия не активирована, или предыдущий процесс КОМПАС завис —
|
|
попроси пользователя проверить лицензию и вручную закрыть зависшие процессы КОМПАС через
|
|
Диспетчер задач). Затем вызови `kompas_status`, чтобы явно зафиксировать итоговое состояние
|
|
подключения в отчёте — учти, что сам по себе `kompas_status` не пытается подключиться, а
|
|
только читает текущее состояние сессии, поэтому он осмыслен только после `kompas_connect`.
|
|
Отдельный случай: если `kompas_status` вернул сообщение про interop-сборки — это диагноз
|
|
пункта 6, а не проблема соединения.
|
|
|
|
8. **Итог.** Собери отчёт: версия плагина, источник бинаря (поставка или `KOMPAS_MCP_EXE`), путь до
|
|
него, версия найденного .NET Runtime, результат `kompas_connect`/`kompas_status`, и — если
|
|
что-то не сошлось — какое из действий выше нужно предпринять пользователю.
|