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