kompas 0.7.7 (из 66b8a4d74db323335a048aa7298f49d3337ae277)

This commit is contained in:
actions-bot Bot committed 2026-11-17 05:27:17 +00:00
1 parent 0f482ae5fa
commit b2df179c93
14 files changed
+111 -68

No files matched your search

+3 -1
View File
@@ -11,7 +11,9 @@
{ {
"name": "kompas", "name": "kompas",
"source": "./plugin", "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", "category": "productivity",
"keywords": ["cad", "kompas", "3d", "step", "mcp", "fdm"] "keywords": ["cad", "kompas", "3d", "step", "mcp", "fdm"]
} }
+12
View File
@@ -1,5 +1,17 @@
# Changelog # Changelog
## [0.7.7]
- Локальный HTTP-сервер принимает только loopback-соединения, а браузерный
клиент обязан отправлять Origin собственного хоста (защита от DNS rebinding).
- COM-объекты теперь освобождаются в едином скоупе за STA-операцию (ComScope);
перестроены построение деталей, геометрические запросы и импорт чертежей —
меньше утечек RCW при ошибках.
- Уточнены JSON-RPC-ошибки, журнал операций и кэш каталога моделей панели агента.
- Витрина прилавка: README оформлен как основной, добавлен значок для Codex,
манифесты больше не ссылаются на закрытый репозиторий; общий assets/ копируется
в прилавок при релизе.
## [0.7.6] ## [0.7.6]
- Исправлены инструкции закрепления pi-пакета: первый поддерживаемый тег — v0.7.5; - Исправлены инструкции закрепления pi-пакета: первый поддерживаемый тег — v0.7.5;
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "kompas", "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", "description": "КОМПАС-3D для агента pi: MCP-сервер (детали, эскизы, формообразующие операции, сборки, чертежи, STEP) плюс навыки kompas-3d и kompas-fdm-design. Установка: pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git",
"license": "MIT", "license": "MIT",
"keywords": [ "keywords": [
+6 -4
View File
@@ -1,19 +1,21 @@
{ {
"name": "kompas", "name": "kompas",
"displayName": "КОМПАС-3D", "displayName": "КОМПАС-3D",
"version": "0.7.6", "version": "0.7.7",
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер", "description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
"author": { "author": {
"name": "Shahovalov Mikhail", "name": "Shahovalov Mikhail",
"email": "miha.shahovalov@gmail.com" "email": "miha.shahovalov@gmail.com"
}, },
"homepage": "https://git.shahovalov.ru/mikhail/kompas3d-mcp", "homepage": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"repository": "https://git.shahovalov.ru/mikhail/kompas3d-mcp", "repository": "https://git.shahovalov.ru/mikhail/kompas-plugin",
"license": "MIT",
"keywords": [ "keywords": [
"cad", "cad",
"kompas", "kompas",
"3d", "3d",
"step", "step",
"mcp" "mcp",
"fdm"
] ]
} }
+66 -47
View File
@@ -1,65 +1,92 @@
# Плагин `kompas` — КОМПАС-3D в Claude Code, Codex и pi <img src="assets/icon.svg" alt="" width="64" height="64" align="right">
Даёт агенту инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы # Плагин `kompas`
с ними: навыки `kompas-3d` и `kompas-fdm-design`.
## Предпосылки КОМПАС-3D в Claude Code, Codex и pi: инструменты управления (детали, сборки, чертежи, STEP) и
методика работы с ними. Витрина и список изменений —
[прилавок `kompas-plugin`](https://git.shahovalov.ru/mikhail/kompas-plugin).
- Windows x64; ```text
- установленный КОМПАС-3D (проверено на v25 Home, v24 Home тоже поддерживается) — сервер является COM-клиентом, а не автономным plugin/
CAD-движком, и работает только на той же машине. Запускать заранее не нужно: сервер присоединится ├─ bin/ сервер kompas-mcp.exe, кладёт релиз
к открытому окну, а если его нет — запустит экземпляр сам; ├─ skills/ kompas-3d, kompas-fdm-design
- КОМПАС установлен **вместе с компонентом SDK**: interop-сборки принадлежат АСКОН, в поставку ├─ commands/doctor.md /kompas:doctor в Claude Code
сервера не входят и берутся из установки (`SDK\Samples\CSharp.zip`, каталог `Common`). При первом ├─ scripts/ launch-kompas-mcp.ps1, общий лаунчер всех клиентов
запуске они распаковываются в `%LOCALAPPDATA%\kompas-mcp\interop\<ключ>`; если SDK не установлен, ├─ pi/ расширение для pi-пакета
укажите каталог с этими сборками в переменной окружения `KOMPAS_INTEROP_DIR`; ├─ adapters/ ручное подключение: codex, opencode, pi
- [**.NET Runtime**](https://dotnet.microsoft.com/download/dotnet) **10 или новее, x64** — сервер └─ assets/ значок плагина
поставляется framework-dependent, рантайм берётся с машины. Проверка: `dotnet --list-runtimes` ```
показывает `Microsoft.NETCore.App 10.x` или новее;
- чекаут репозитория и рабочие файлы — вне синхронизируемых папок OneDrive. ## Требования
| | |
|---|---|
| **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 marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
/plugin install kompas@kompas-plugin /plugin install kompas@kompas-plugin
/kompas:doctor /kompas:doctor
``` ```
Сервер (`bin/kompas-mcp.exe`) едет вместе с плагином — отдельно скачивать и устанавливать нечего. `/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение. Обновление:
`/kompas:doctor` проверяет версию, наличие .NET и КОМПАС, interop-сборки и соединение.
## Обновление ```text
```
/plugin marketplace update kompas-plugin /plugin marketplace update kompas-plugin
/plugin update kompas@kompas-plugin /plugin update kompas@kompas-plugin
``` ```
Если инструменты остались прежними — `/reload-plugins`. Если инструменты остались прежними — `/reload-plugins`.
## Установка в pi ### Codex
Тот же прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе.
```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 install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
pi list pi list
``` ```
Обновление — `pi update --extensions`: пакет без закреплённого ref синхронизируется с веткой. Обновление — `pi update --extensions`: пакет без закреплённого ref синхронизируется с веткой. Новые
После обновления pi показывает новые записи из `CHANGELOG.md` при следующем новом запуске; записи `CHANGELOG.md` pi показывает при следующем запуске (при первой загрузке пакета — нет). Версию
при первой загрузке пакета changelog не показывается. можно закрепить тегом:
Версию можно закрепить тегом:
``` ```text
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5 pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
``` ```
Закреплённый тег не меняется при `pi update --extensions`; для перехода на другую версию Закреплённый тег не меняется при `pi update --extensions`: для перехода повторите `pi install` с новым
повторите `pi install` с новым тегом или без ref. тегом или без ref. Проверка соединения — как в Codex, инструмент `kompas_status`. Манифест пакета —
Проверка соединения — инструмент `kompas_status` (команда `/kompas:doctor` принадлежит Claude Code). `package.json` в корне прилавка, расширение — `pi/kompas.ts`.
Ручная альтернатива без пакета — `adapters/pi/`.
### Ручное подключение
Лаунчер `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 ```powershell
$env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe" $env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
``` ```
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина. ## Что остаётся после удаления
## Другие харнессы (Codex, opencode, pi) Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные файлы)
не очищается при обновлении и удалении плагина — удаляется вручную.
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/`,
`adapters/opencode/` и `adapters/pi/`. Это сниппеты конфигурации и инструкция, а не отдельные
дистрибутивы: контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
Для pi основной путь — pi-пакет (`package.json` в корне прилавка, расширение `plugin/pi/kompas.ts`).
## Прочее
Каталог `%LOCALAPPDATA%\kompas-mcp` (распакованные interop-сборки, при разработке — временные
файлы) не очищается при обновлении и удалении плагина — удаляется вручную.
+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" width="96" height="96" viewBox="0 0 48 48" role="img" aria-label="КОМПАС-3D"><title>КОМПАС-3D</title><defs><linearGradient id="bg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#0d1b2e"/><stop offset="1" stop-color="#14304f"/></linearGradient></defs><rect width="48" height="48" rx="10" fill="url(#bg)"/><rect x=".5" y=".5" width="47" height="47" rx="9.5" fill="none" stroke="#9fd4ff" stroke-opacity=".35"/><g transform="translate(0 -3.5)" stroke="#9fd4ff" stroke-width="1.4" stroke-linejoin="round"><polygon points="24.0,23.8 37.9,31.8 24.0,39.8 10.1,31.8" fill="#2f6ea8"/><polygon points="10.1,36.0 24.0,44.0 24.0,39.8 10.1,31.8" fill="#1d4a78"/><polygon points="37.9,36.0 24.0,44.0 24.0,39.8 37.9,31.8" fill="#163a60"/><polygon points="24.0,11.0 37.9,19.0 33.4,21.6 19.6,13.6" fill="#2f6ea8"/><polygon points="19.6,26.4 33.4,34.4 33.4,21.6 19.6,13.6" fill="#1d4a78"/><polygon points="37.9,31.8 33.4,34.4 33.4,21.6 37.9,19.0" fill="#163a60"/><ellipse cx="26.5" cy="23.4" rx="3.2" ry="4.2" transform="rotate(-30 26.5 23.4)" fill="#0b1626" stroke-width="1.2"/></g></svg>

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.
Binary file not shown.
+7 -7
View File
@@ -7,9 +7,9 @@
"targets": { "targets": {
".NETCoreApp,Version=v10.0": {}, ".NETCoreApp,Version=v10.0": {},
".NETCoreApp,Version=v10.0/win-x64": { ".NETCoreApp,Version=v10.0/win-x64": {
"kompas-mcp/0.7.6": { "kompas-mcp/0.7.7": {
"dependencies": { "dependencies": {
"Kompas.Mcp.Core": "0.7.6", "Kompas.Mcp.Core": "0.7.7",
"Microsoft.Extensions.Hosting": "10.0.14", "Microsoft.Extensions.Hosting": "10.0.14",
"ModelContextProtocol": "2.3.0" "ModelContextProtocol": "2.3.0"
}, },
@@ -433,21 +433,21 @@
} }
} }
}, },
"Kompas.Mcp.Core/0.7.6": { "Kompas.Mcp.Core/0.7.7": {
"dependencies": { "dependencies": {
"Microsoft.Extensions.Logging.Abstractions": "10.0.14" "Microsoft.Extensions.Logging.Abstractions": "10.0.14"
}, },
"runtime": { "runtime": {
"Kompas.Mcp.Core.dll": { "Kompas.Mcp.Core.dll": {
"assemblyVersion": "0.7.6.0", "assemblyVersion": "0.7.7.0",
"fileVersion": "0.7.6.0" "fileVersion": "0.7.7.0"
} }
} }
} }
} }
}, },
"libraries": { "libraries": {
"kompas-mcp/0.7.6": { "kompas-mcp/0.7.7": {
"type": "project", "type": "project",
"serviceable": false, "serviceable": false,
"sha512": "" "sha512": ""
@@ -676,7 +676,7 @@
"path": "system.diagnostics.eventlog/10.0.14", "path": "system.diagnostics.eventlog/10.0.14",
"hashPath": "system.diagnostics.eventlog.10.0.14.nupkg.sha512" "hashPath": "system.diagnostics.eventlog.10.0.14.nupkg.sha512"
}, },
"Kompas.Mcp.Core/0.7.6": { "Kompas.Mcp.Core/0.7.7": {
"type": "project", "type": "project",
"serviceable": false, "serviceable": false,
"sha512": "" "sha512": ""
Binary file not shown.
Binary file not shown.
Binary file not shown.
+11 -4
View File
@@ -1,20 +1,27 @@
{ {
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "kompas", "name": "kompas",
"version": "0.7.6", "version": "0.7.7",
"description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.", "description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.",
"author": { "author": {
"name": "Shahovalov Mikhail" "name": "Shahovalov Mikhail"
}, },
"license": "MIT",
"extensions": { "extensions": {
"com.openai": { "com.openai": {
"requires_local_executor": true, "requires_local_executor": true,
"interface": { "interface": {
"displayName": "КОМПАС-3D", "displayName": "КОМПАС-3D",
"shortDescription": "Управление КОМПАС-3D", "shortDescription": "Детали, сборки и чертежи в КОМПАС-3D",
"longDescription": "Создание и редактирование моделей и чертежей КОМПАС-3D через локальный MCP-сервер.", "longDescription": "Создание и редактирование деталей, сборок и чертежей КОМПАС-3D через локальный MCP-сервер, импорт и экспорт STEP и STL, осмотр модели и методика построения.",
"developerName": "Shahovalov Mikhail", "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"
} }
} }
} }
+4 -4
View File
@@ -1,6 +1,6 @@
{ {
"version": "0.7.6", "version": "0.7.7",
"tag": "v0.7.6", "tag": "v0.7.7",
"sourceSha": "c9f42fb464d371c577a4c883a84e1dc4b1d49561", "sourceSha": "66b8a4d74db323335a048aa7298f49d3337ae277",
"built": "2026-11-03T20:22:23Z" "built": "2026-11-17T05:27:17Z"
} }