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
24 files changed
+269 -226

No files matched your search

+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-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-сборки, при разработке — временные файлы)
не очищается при обновлении и удалении плагина — удаляется вручную.