92 lines
5.5 KiB
Markdown
92 lines
5.5 KiB
Markdown
# Плагин `kompas` — КОМПАС-3D в Claude Code, Codex и pi
|
||
|
||
Даёт агенту инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
|
||
с ними: навыки `kompas-3d` и `kompas-fdm-design`.
|
||
|
||
## Предпосылки
|
||
|
||
- Windows x64;
|
||
- установленный КОМПАС-3D (проверено на v25 Home, v24 Home тоже поддерживается) — сервер является COM-клиентом, а не автономным
|
||
CAD-движком, и работает только на той же машине. Запускать заранее не нужно: сервер присоединится
|
||
к открытому окну, а если его нет — запустит экземпляр сам;
|
||
- КОМПАС установлен **вместе с компонентом SDK**: interop-сборки принадлежат АСКОН, в поставку
|
||
сервера не входят и берутся из установки (`SDK\Samples\CSharp.zip`, каталог `Common`). При первом
|
||
запуске они распаковываются в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`; если SDK не установлен,
|
||
укажите каталог с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
|
||
- [**.NET Runtime**](https://dotnet.microsoft.com/download/dotnet) **10 или новее, x64** — сервер
|
||
поставляется framework-dependent, рантайм берётся с машины. Проверка: `dotnet --list-runtimes`
|
||
показывает `Microsoft.NETCore.App 10.x` или новее;
|
||
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.
|
||
|
||
## Установка
|
||
|
||
```
|
||
/plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||
/plugin install kompas@kompas-plugin
|
||
/kompas:doctor
|
||
```
|
||
|
||
Сервер (`bin/kompas-mcp.exe`) едет вместе с плагином — отдельно скачивать и устанавливать нечего.
|
||
`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение.
|
||
|
||
## Обновление
|
||
|
||
```
|
||
/plugin marketplace update kompas-plugin
|
||
/plugin update kompas@kompas-plugin
|
||
```
|
||
|
||
Если инструменты остались прежними — `/reload-plugins`.
|
||
|
||
## Установка в pi
|
||
|
||
Тот же прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе.
|
||
|
||
```
|
||
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||
pi list
|
||
```
|
||
|
||
Обновление — `pi update --extensions`: пакет без закреплённого ref синхронизируется с веткой.
|
||
После обновления pi показывает новые записи из `CHANGELOG.md` при следующем новом запуске;
|
||
при первой загрузке пакета changelog не показывается.
|
||
Версию можно закрепить тегом:
|
||
|
||
```
|
||
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
|
||
```
|
||
|
||
Закреплённый тег не меняется при `pi update --extensions`; для перехода на другую версию
|
||
повторите `pi install` с новым тегом или без ref.
|
||
Проверка соединения — инструмент `kompas_status` (команда `/kompas:doctor` принадлежит Claude Code).
|
||
Ручная альтернатива без пакета — `adapters/pi/`.
|
||
|
||
## Промпты и ресурсы
|
||
|
||
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
||
`assembly` — и они появляются в меню slash-команд Claude Code как `/kompas:part (MCP)` и т. д.
|
||
Справочник и сводка активной модели доступны ресурсами `kompas://help/<тема>` и
|
||
`kompas://active/summary`; агент читает их сам, а подстановка через @-упоминание зависит от клиента.
|
||
|
||
## Разработка сервера
|
||
|
||
Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим:
|
||
|
||
```powershell
|
||
$env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
|
||
```
|
||
|
||
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
|
||
|
||
## Другие харнессы (Codex, opencode, pi)
|
||
|
||
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/`,
|
||
`adapters/opencode/` и `adapters/pi/`. Это сниппеты конфигурации и инструкция, а не отдельные
|
||
дистрибутивы: контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
|
||
Для pi основной путь — pi-пакет (`package.json` в корне прилавка, расширение `plugin/pi/kompas.ts`).
|
||
|
||
## Прочее
|
||
|
||
Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные
|
||
файлы) не очищается при обновлении и удалении плагина — удаляется вручную.
|