gitea-actions
61 lines
3.6 KiB
Markdown
61 lines
3.6 KiB
Markdown
# Плагин `kompas` — КОМПАС-3D в Claude Code
|
||
|
||
Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
|
||
с ними: навыки `kompas:kompas-3d` и `kompas: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) **8 или новее, x64** — сервер
|
||
поставляется framework-dependent, рантайм берётся с машины. Проверка: `dotnet --list-runtimes`
|
||
показывает `Microsoft.NETCore.App 8.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`.
|
||
|
||
## Разработка сервера
|
||
|
||
Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим:
|
||
|
||
```powershell
|
||
$env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
|
||
```
|
||
|
||
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
|
||
|
||
## Другие харнессы (Codex, opencode)
|
||
|
||
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
|
||
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
|
||
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
|
||
|
||
## Прочее
|
||
|
||
Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные
|
||
файлы) не очищается при обновлении и удалении плагина — удаляется вручную.
|