diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index fbfd5b6..8f40cbd 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -11,7 +11,9 @@ { "name": "kompas", "source": "./plugin", - "description": "Управление КОМПАС-3D из Claude Code: 74 MCP-инструмента (детали, эскизы, формообразующие операции, массивы, отверстия, исполнения, внешний вид, сборки и сопряжения, 2D-чертежи, STEP/STL, осмотр модели) и два навыка — построение (kompas-3d) и проектирование под FDM-печать (kompas-fdm-design).", + "homepage": "https://git.shahovalov.ru/mikhail/kompas-plugin", + "license": "MIT", + "description": "Управление КОМПАС-3D из Claude Code: MCP-сервер (детали, эскизы, формообразующие операции, массивы, отверстия, исполнения, внешний вид, сборки и сопряжения, 2D-чертежи, STEP/STL, осмотр модели) и два навыка — построение (kompas-3d) и проектирование под FDM-печать (kompas-fdm-design).", "category": "productivity", "keywords": ["cad", "kompas", "3d", "step", "mcp", "fdm"] } diff --git a/CHANGELOG.md b/CHANGELOG.md index b2225df..0e7b978 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,17 @@ # Changelog +## [0.7.7] + +- Локальный HTTP-сервер принимает только loopback-соединения, а браузерный + клиент обязан отправлять Origin собственного хоста (защита от DNS rebinding). +- COM-объекты теперь освобождаются в едином скоупе за STA-операцию (ComScope); + перестроены построение деталей, геометрические запросы и импорт чертежей — + меньше утечек RCW при ошибках. +- Уточнены JSON-RPC-ошибки, журнал операций и кэш каталога моделей панели агента. +- Витрина прилавка: README оформлен как основной, добавлен значок для Codex, + манифесты больше не ссылаются на закрытый репозиторий; общий assets/ копируется + в прилавок при релизе. + ## [0.7.6] - Исправлены инструкции закрепления pi-пакета: первый поддерживаемый тег — v0.7.5; diff --git a/assets/banner.svg b/assets/banner.svg index d2b19c6..ecfb7fd 100644 --- a/assets/banner.svg +++ b/assets/banner.svg @@ -1,35 +1,35 @@ - - - - - - - - - - - - -150Ø40 -MODEL CONTEXT PROTOCOL · COM API5/API7 -kompas3d-mcp -КОМПАС-3D в руках языковой модели -эскизы3D-деталисборкичертежиSTEP · STL · DXF -ГОСТ 2.317 · изометрия - - - + + + + + + + + + + + + +150Ø40 +MODEL CONTEXT PROTOCOL · COM API5/API7 +kompas3d-mcp +КОМПАС-3D в руках языковой модели +эскизы3D-деталисборкичертежиSTEP · STL · DXF +ГОСТ 2.317 · изометрия + + + diff --git a/assets/example.svg b/assets/example.svg index 99d3ed0..c4cb852 100644 --- a/assets/example.svg +++ b/assets/example.svg @@ -1,73 +1,73 @@ - - - - - - - - -01 · ЗАПРОС -Вы - -02 · ВЫЗОВЫ -Агент - -03 · ОТВЕТ -Сервер - - - -Кронштейн: -полка 150 × 96 × 24, -стойка высотой 110 -с отверстием Ø40, -в полке два -крепёжных Ø11. -Высоту стойки — -переменной. - -1 -document_create(part) - -2 -set_variable(H = 110) - -3 -primitive(block 150×96×24) - -4 -primitive(height = "H", -result = union) - -5 -hole(Ø40, сквозное) - -6 -hole(Ø11, points = [2]) - -7 -describe_model(box, mass) -H -✓ Построение чистое -тел: 1 -габарит 150 × 96 × 110 мм -H ведёт высоту стойки: -set_variable(H = 140) - + + + + + + + + +01 · ЗАПРОС +Вы + +02 · ВЫЗОВЫ +Агент + +03 · ОТВЕТ +Сервер + + + +Кронштейн: +полка 150 × 96 × 24, +стойка высотой 110 +с отверстием Ø40, +в полке два +крепёжных Ø11. +Высоту стойки — +переменной. + +1 +document_create(part) + +2 +set_variable(H = 110) + +3 +primitive(block 150×96×24) + +4 +primitive(height = "H", +result = union) + +5 +hole(Ø40, сквозное) + +6 +hole(Ø11, points = [2]) + +7 +describe_model(box, mass) +H +✓ Построение чистое +тел: 1 +габарит 150 × 96 × 110 мм +H ведёт высоту стойки: +set_variable(H = 140) + diff --git a/assets/flow.svg b/assets/flow.svg index bfce236..502ca62 100644 --- a/assets/flow.svg +++ b/assets/flow.svg @@ -1,43 +1,43 @@ - - - - - - - - - -LLM-агент -Claude Code · Codex · pi · opencode -навыки kompas-3d и -kompas-fdm-design - -kompas3d-mcp -инструменты · справка help -STA-поток, хендлы, -сверка с запросом - -КОМПАС-3D -COM API7 / API5 -окно пользователя или -свой скрытый экземпляр - - - - - - - - -вызовинструмента -COM-вызовы -факты +сверка -геометрия,дерево, ошибки -MCP -COM - + + + + + + + + + +LLM-агент +Claude Code · Codex · pi · opencode +навыки kompas-3d и +kompas-fdm-design + +kompas3d-mcp +инструменты · справка help +STA-поток, хендлы, +сверка с запросом + +КОМПАС-3D +COM API7 / API5 +окно пользователя или +свой скрытый экземпляр + + + + + + + + +вызовинструмента +COM-вызовы +факты +сверка +геометрия,дерево, ошибки +MCP +COM + diff --git a/assets/icons/assembly.svg b/assets/icons/assembly.svg index adc9e76..dd48093 100644 --- a/assets/icons/assembly.svg +++ b/assets/icons/assembly.svg @@ -1 +1 @@ -Сборки +Сборки diff --git a/assets/icons/drawing.svg b/assets/icons/drawing.svg index 2d738c7..637bd29 100644 --- a/assets/icons/drawing.svg +++ b/assets/icons/drawing.svg @@ -1 +1 @@ -Чертежи +Чертежи diff --git a/assets/icons/export.svg b/assets/icons/export.svg index 428f961..aeb87af 100644 --- a/assets/icons/export.svg +++ b/assets/icons/export.svg @@ -1 +1 @@ -Экспорт +Экспорт diff --git a/assets/icons/import.svg b/assets/icons/import.svg index 60d953d..cdc51fb 100644 --- a/assets/icons/import.svg +++ b/assets/icons/import.svg @@ -1 +1 @@ -Импорт +Импорт diff --git a/assets/icons/inspect.svg b/assets/icons/inspect.svg index 913b351..c712f42 100644 --- a/assets/icons/inspect.svg +++ b/assets/icons/inspect.svg @@ -1 +1 @@ -Осмотр +Осмотр diff --git a/assets/icons/param.svg b/assets/icons/param.svg index ba13f4b..a1d3556 100644 --- a/assets/icons/param.svg +++ b/assets/icons/param.svg @@ -1 +1 @@ -ПараметрикаH*2 +ПараметрикаH*2 diff --git a/assets/icons/part.svg b/assets/icons/part.svg index 8f8d3ef..aeae9b1 100644 --- a/assets/icons/part.svg +++ b/assets/icons/part.svg @@ -1 +1 @@ -Детали +Детали diff --git a/package.json b/package.json index 90b4fa1..ba453ec 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "kompas", - "version": "0.7.6", + "version": "0.7.7", "description": "КОМПАС-3D для агента pi: MCP-сервер (детали, эскизы, формообразующие операции, сборки, чертежи, STEP) плюс навыки kompas-3d и kompas-fdm-design. Установка: pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git", "license": "MIT", "keywords": [ diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json index 0bcdf75..103971a 100644 --- a/plugin/.claude-plugin/plugin.json +++ b/plugin/.claude-plugin/plugin.json @@ -1,19 +1,21 @@ { "name": "kompas", "displayName": "КОМПАС-3D", - "version": "0.7.6", + "version": "0.7.7", "description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер", "author": { "name": "Shahovalov Mikhail", "email": "miha.shahovalov@gmail.com" }, - "homepage": "https://git.shahovalov.ru/mikhail/kompas3d-mcp", - "repository": "https://git.shahovalov.ru/mikhail/kompas3d-mcp", + "homepage": "https://git.shahovalov.ru/mikhail/kompas-plugin", + "repository": "https://git.shahovalov.ru/mikhail/kompas-plugin", + "license": "MIT", "keywords": [ "cad", "kompas", "3d", "step", - "mcp" + "mcp", + "fdm" ] } diff --git a/plugin/README.md b/plugin/README.md index f023b1c..41c6fed 100644 --- a/plugin/README.md +++ b/plugin/README.md @@ -1,65 +1,92 @@ -# Плагин `kompas` — КОМПАС-3D в Claude Code, Codex и pi + -Даёт агенту инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы -с ними: навыки `kompas-3d` и `kompas-fdm-design`. +# Плагин `kompas` -## Предпосылки +КОМПАС-3D в Claude Code, Codex и pi: инструменты управления (детали, сборки, чертежи, STEP) и +методика работы с ними. Витрина и список изменений — +[прилавок `kompas-plugin`](https://git.shahovalov.ru/mikhail/kompas-plugin). -- 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. +```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 ``` -Сервер (`bin/kompas-mcp.exe`) едет вместе с плагином — отдельно скачивать и устанавливать нечего. -`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение. +`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение. Обновление: -## Обновление - -``` +```text /plugin marketplace update kompas-plugin /plugin update kompas@kompas-plugin ``` Если инструменты остались прежними — `/reload-plugins`. -## Установка в pi - -Тот же прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе. +### 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 синхронизируется с веткой. -После обновления pi показывает новые записи из `CHANGELOG.md` при следующем новом запуске; -при первой загрузке пакета changelog не показывается. -Версию можно закрепить тегом: +Обновление — `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. -Проверка соединения — инструмент `kompas_status` (команда `/kompas:doctor` принадлежит Claude Code). -Ручная альтернатива без пакета — `adapters/pi/`. +Закреплённый тег не меняется при `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/`. Это сниппеты и инструкция, а не отдельные дистрибутивы: навыки +и лаунчер не размножаются. ## Промпты и ресурсы @@ -70,22 +97,14 @@ pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5 ## Разработка сервера -Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим: +Переменная окружения `KOMPAS_MCP_EXE` подменяет поставленный бинарь своим, и лаунчер не смотрит в +`bin/` плагина: ```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-сборки, при разработке — временные -файлы) не очищается при обновлении и удалении плагина — удаляется вручную. +Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные файлы) +не очищается при обновлении и удалении плагина — удаляется вручную. diff --git a/plugin/assets/icon.svg b/plugin/assets/icon.svg new file mode 100644 index 0000000..daa1b3a --- /dev/null +++ b/plugin/assets/icon.svg @@ -0,0 +1 @@ +КОМПАС-3D diff --git a/plugin/bin/Kompas.Mcp.Core.dll b/plugin/bin/Kompas.Mcp.Core.dll index e6497c4..1eb8d45 100644 Binary files a/plugin/bin/Kompas.Mcp.Core.dll and b/plugin/bin/Kompas.Mcp.Core.dll differ diff --git a/plugin/bin/Kompas.Mcp.Core.pdb b/plugin/bin/Kompas.Mcp.Core.pdb index 75d2214..ee99a0b 100644 Binary files a/plugin/bin/Kompas.Mcp.Core.pdb and b/plugin/bin/Kompas.Mcp.Core.pdb differ diff --git a/plugin/bin/kompas-mcp.deps.json b/plugin/bin/kompas-mcp.deps.json index d25cff3..23d02f3 100644 --- a/plugin/bin/kompas-mcp.deps.json +++ b/plugin/bin/kompas-mcp.deps.json @@ -7,9 +7,9 @@ "targets": { ".NETCoreApp,Version=v10.0": {}, ".NETCoreApp,Version=v10.0/win-x64": { - "kompas-mcp/0.7.6": { + "kompas-mcp/0.7.7": { "dependencies": { - "Kompas.Mcp.Core": "0.7.6", + "Kompas.Mcp.Core": "0.7.7", "Microsoft.Extensions.Hosting": "10.0.14", "ModelContextProtocol": "2.3.0" }, @@ -433,21 +433,21 @@ } } }, - "Kompas.Mcp.Core/0.7.6": { + "Kompas.Mcp.Core/0.7.7": { "dependencies": { "Microsoft.Extensions.Logging.Abstractions": "10.0.14" }, "runtime": { "Kompas.Mcp.Core.dll": { - "assemblyVersion": "0.7.6.0", - "fileVersion": "0.7.6.0" + "assemblyVersion": "0.7.7.0", + "fileVersion": "0.7.7.0" } } } } }, "libraries": { - "kompas-mcp/0.7.6": { + "kompas-mcp/0.7.7": { "type": "project", "serviceable": false, "sha512": "" @@ -676,7 +676,7 @@ "path": "system.diagnostics.eventlog/10.0.14", "hashPath": "system.diagnostics.eventlog.10.0.14.nupkg.sha512" }, - "Kompas.Mcp.Core/0.7.6": { + "Kompas.Mcp.Core/0.7.7": { "type": "project", "serviceable": false, "sha512": "" diff --git a/plugin/bin/kompas-mcp.dll b/plugin/bin/kompas-mcp.dll index 8730753..dd3fcd5 100644 Binary files a/plugin/bin/kompas-mcp.dll and b/plugin/bin/kompas-mcp.dll differ diff --git a/plugin/bin/kompas-mcp.exe b/plugin/bin/kompas-mcp.exe index b0392cc..4793e53 100755 Binary files a/plugin/bin/kompas-mcp.exe and b/plugin/bin/kompas-mcp.exe differ diff --git a/plugin/bin/kompas-mcp.pdb b/plugin/bin/kompas-mcp.pdb index 411c179..8dd9f33 100644 Binary files a/plugin/bin/kompas-mcp.pdb and b/plugin/bin/kompas-mcp.pdb differ diff --git a/plugin/plugin.json b/plugin/plugin.json index 41609da..9b07cce 100644 --- a/plugin/plugin.json +++ b/plugin/plugin.json @@ -1,20 +1,27 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "kompas", - "version": "0.7.6", + "version": "0.7.7", "description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.", "author": { "name": "Shahovalov Mikhail" }, + "license": "MIT", "extensions": { "com.openai": { "requires_local_executor": true, "interface": { "displayName": "КОМПАС-3D", - "shortDescription": "Управление КОМПАС-3D", - "longDescription": "Создание и редактирование моделей и чертежей КОМПАС-3D через локальный MCP-сервер.", + "shortDescription": "Детали, сборки и чертежи в КОМПАС-3D", + "longDescription": "Создание и редактирование деталей, сборок и чертежей КОМПАС-3D через локальный MCP-сервер, импорт и экспорт STEP и STL, осмотр модели и методика построения.", "developerName": "Shahovalov Mikhail", - "category": "Productivity" + "category": "Productivity", + "websiteURL": "https://git.shahovalov.ru/mikhail/kompas-plugin", + "logo": "./assets/icon.svg", + "logoDark": "./assets/icon.svg", + "composerIcon": "./assets/icon.svg", + "brandColor": "#2F6EA8", + "brandColorDark": "#9FD4FF" } } } diff --git a/release.json b/release.json index b9dcf15..56bd5fd 100644 --- a/release.json +++ b/release.json @@ -1,6 +1,6 @@ { - "version": "0.7.6", - "tag": "v0.7.6", - "sourceSha": "c9f42fb464d371c577a4c883a84e1dc4b1d49561", - "built": "2026-11-03T20:22:23Z" + "version": "0.7.7", + "tag": "v0.7.7", + "sourceSha": "66b8a4d74db323335a048aa7298f49d3337ae277", + "built": "2026-11-17T05:27:17Z" }