kompas 0.1.0 (из c7b0387a24cfeae3f19c052eb16d29dcc8030e31)

2026-08-06 21:03:33 +00:00
parent 2b4def3479
commit 39ee6cb155
63 changed files with 2169 additions and 2 deletions
@@ -0,0 +1,60 @@
+# Плагин `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`;
+- [**.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-сборки, при разработке — временные
+файлы) не очищается при обновлении и удалении плагина — удаляется вручную.