# Плагин `kompas` — КОМПАС-3D в Claude Code

Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
с ними: навыки `kompas:kompas-3d` и `kompas:kompas-fdm-design`.

## Предпосылки

- Windows x64;
- установленный **и запущенный** КОМПАС-3D (проверено на v24 Home) — сервер является COM-клиентом,
  а не автономным CAD-движком, и работает только на той же машине;
- КОМПАС установлен **вместе с компонентом SDK**: interop-сборки принадлежат АСКОН, в поставку
  сервера не входят и берутся из установки (`SDK\Samples\CSharp.zip`, каталог `Common`). При первом
  запуске они распаковываются в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`; если SDK не установлен,
  укажите каталог с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`;
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive.

.NET Runtime ставить не нужно: сервер публикуется self-contained.

## Установка

1. `/plugin marketplace add https://git.shahovalov.ru/mikhail/home-repo-cc.git`
2. `/plugin install kompas@home-repo-cc`
3. `/kompas:doctor` — проверка. Первый запуск скачивает сервер (~70 МБ) в
   `%LOCALAPPDATA%\kompas-mcp\<версия>` и сверяет SHA256 с `server.lock.json`.

> На момент написания этого README релиза ещё не существует (`server.lock.json` в состоянии
> `0.0.0`), а запись плагина `kompas` в каталоге `home-repo-cc` ещё не добавлена — шаги установки
> выше описывают целевой процесс, но пока не выполнимы буквально. До первого релиза используйте
> режим разработки (см. ниже).

## Обновление

Три шага, именно в таком порядке:

1. `/plugin marketplace update home-repo-cc`
2. `/plugin update kompas@home-repo-cc`
3. при необходимости `/reload-plugins`

Каталог приватный, поэтому на фоновое автообновление полагаться нельзя: фоновая синхронизация
отключает git-credential-helper и по HTTPS не аутентифицируется. Надёжнее добавить каталог
по SSH; при HTTPS выставьте `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1`, чтобы неудачная
фоновая синхронизация не сносила локальный клон.

## Разработка сервера

Собрать сервер локально и подсунуть его плагину:

```powershell
dotnet build -c Release
$env:KOMPAS_MCP_EXE = "<путь>\src\Kompas.Mcp.Host\bin\x64\Release\net8.0-windows\kompas-mcp.exe"
```

Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не обращается к релизу.

## Другие харнессы (Codex, opencode)

Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.

## Прочее

Каталог `%LOCALAPPDATA%\kompas-mcp` не очищается при обновлении и удалении плагина — старые версии
удаляются вручную.
