Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e6864b9d6b | ||
|
|
ef953f6e4b | ||
|
|
d514b45b88 |
No files matched your search
@@ -0,0 +1,18 @@
|
|||||||
|
# Changelog
|
||||||
|
|
||||||
|
## [0.7.6]
|
||||||
|
|
||||||
|
- Исправлены инструкции закрепления pi-пакета: первый поддерживаемый тег — v0.7.5;
|
||||||
|
приведена полная команда установки и пояснено обновление закреплённых версий.
|
||||||
|
- Добавлен changelog пакета для показа изменений в pi после обновления.
|
||||||
|
- Добавлены проверки changelog перед публикацией и после анонимного клонирования прилавка.
|
||||||
|
- В CI добавлен smoke-тест загрузки расширения из перемещённого пакета с пробелами в пути
|
||||||
|
и проверки конфигурации MCP без запуска КОМПАС; импорт типа API сделан явно type-only.
|
||||||
|
|
||||||
|
## [0.7.5]
|
||||||
|
|
||||||
|
- Добавлена установка в pi через git-пакет публичного прилавка.
|
||||||
|
- Расширение подключает MCP-сервер КОМПАС-3D через общий PowerShell-лаунчер;
|
||||||
|
инструменты доступны по поиску (`deferred`).
|
||||||
|
- Вместе с пакетом поставляются навыки `kompas-3d` и `kompas-fdm-design`.
|
||||||
|
- Добавлен ручной адаптер pi для подключения сервера без установки пакета.
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
# КОМПАС-3D в Claude Code и Codex
|
# КОМПАС-3D в Claude Code, Codex и pi
|
||||||
|
|
||||||
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
|
Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
|
||||||
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
|
[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
|
||||||
@@ -67,10 +67,31 @@ codex plugin marketplace add https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
|||||||
используйте `codex plugin marketplace upgrade kompas-plugin`, затем обновите плагин в интерфейсе.
|
используйте `codex plugin marketplace upgrade kompas-plugin`, затем обновите плагин в интерфейсе.
|
||||||
Команда `/kompas:doctor` относится к Claude Code; в Codex проверяйте подключение через `kompas_status`.
|
Команда `/kompas:doctor` относится к Claude Code; в Codex проверяйте подключение через `kompas_status`.
|
||||||
|
|
||||||
|
## Установка в pi
|
||||||
|
|
||||||
|
Прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, оба навыка идут вместе.
|
||||||
|
|
||||||
|
```
|
||||||
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||||||
|
```
|
||||||
|
|
||||||
|
Обновление — `pi update --extensions`. После обновления новые записи из
|
||||||
|
[CHANGELOG.md](CHANGELOG.md) показываются при следующем новом запуске pi
|
||||||
|
(при первой загрузке пакета — нет).
|
||||||
|
|
||||||
|
Для закрепления версии:
|
||||||
|
|
||||||
|
```
|
||||||
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git@v0.7.5
|
||||||
|
```
|
||||||
|
|
||||||
|
Закреплённый тег не обновляется до следующего релиза автоматически: повторите `pi install`
|
||||||
|
с новым тегом или без ref, чтобы снова следовать ветке. Проверка соединения — `kompas_status`.
|
||||||
|
|
||||||
## Другие агентские харнессы
|
## Другие агентские харнессы
|
||||||
|
|
||||||
Тот же сервер можно подключить вручную к Codex и opencode — сниппеты конфигурации лежат в
|
Тот же сервер можно подключить вручную к Codex, opencode и pi — сниппеты конфигурации лежат в
|
||||||
`plugin/adapters/{codex,opencode}/`.
|
`plugin/adapters/{codex,opencode,pi}/`.
|
||||||
|
|
||||||
## Лицензия
|
## Лицензия
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,24 @@
|
|||||||
|
{
|
||||||
|
"name": "kompas",
|
||||||
|
"version": "0.7.6",
|
||||||
|
"description": "КОМПАС-3D для агента pi: MCP-сервер (детали, эскизы, формообразующие операции, сборки, чертежи, STEP) плюс навыки kompas-3d и kompas-fdm-design. Установка: pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git",
|
||||||
|
"license": "MIT",
|
||||||
|
"keywords": [
|
||||||
|
"pi-package",
|
||||||
|
"cad",
|
||||||
|
"kompas",
|
||||||
|
"3d",
|
||||||
|
"step",
|
||||||
|
"mcp",
|
||||||
|
"fdm"
|
||||||
|
],
|
||||||
|
"repository": "https://git.shahovalov.ru/mikhail/kompas-plugin",
|
||||||
|
"pi": {
|
||||||
|
"extensions": [
|
||||||
|
"./plugin/pi/kompas.ts"
|
||||||
|
],
|
||||||
|
"skills": [
|
||||||
|
"./plugin/skills"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "kompas",
|
"name": "kompas",
|
||||||
"displayName": "КОМПАС-3D",
|
"displayName": "КОМПАС-3D",
|
||||||
"version": "0.7.3",
|
"version": "0.7.6",
|
||||||
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
"description": "Управление КОМПАС-3D из Claude Code: детали, сборки, чертежи, STEP — через MCP-сервер",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Shahovalov Mikhail",
|
"name": "Shahovalov Mikhail",
|
||||||
|
|||||||
+31
-7
@@ -1,7 +1,7 @@
|
|||||||
# Плагин `kompas` — КОМПАС-3D в Claude Code
|
# Плагин `kompas` — КОМПАС-3D в Claude Code, Codex и pi
|
||||||
|
|
||||||
Даёт Claude Code инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
|
Даёт агенту инструменты управления КОМПАС-3D (детали, сборки, чертежи, STEP) и методику работы
|
||||||
с ними: навыки `kompas:kompas-3d` и `kompas:kompas-fdm-design`.
|
с ними: навыки `kompas-3d` и `kompas-fdm-design`.
|
||||||
|
|
||||||
## Предпосылки
|
## Предпосылки
|
||||||
|
|
||||||
@@ -38,6 +38,29 @@
|
|||||||
|
|
||||||
Если инструменты остались прежними — `/reload-plugins`.
|
Если инструменты остались прежними — `/reload-plugins`.
|
||||||
|
|
||||||
|
## Установка в pi
|
||||||
|
|
||||||
|
Тот же прилавок — pi-пакет целиком: расширение регистрирует MCP-сервер, навыки идут вместе.
|
||||||
|
|
||||||
|
```
|
||||||
|
pi install git:https://git.shahovalov.ru/mikhail/kompas-plugin.git
|
||||||
|
pi list
|
||||||
|
```
|
||||||
|
|
||||||
|
Обновление — `pi update --extensions`: пакет без закреплённого ref синхронизируется с веткой.
|
||||||
|
После обновления pi показывает новые записи из `CHANGELOG.md` при следующем новом запуске;
|
||||||
|
при первой загрузке пакета changelog не показывается.
|
||||||
|
Версию можно закрепить тегом:
|
||||||
|
|
||||||
|
```
|
||||||
|
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/`.
|
||||||
|
|
||||||
## Промпты и ресурсы
|
## Промпты и ресурсы
|
||||||
|
|
||||||
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
Сервер отдаёт готовые маршруты работы промптами — `part`, `import-edit-export`, `drawing`,
|
||||||
@@ -55,11 +78,12 @@ $env:KOMPAS_MCP_EXE = "<путь>\kompas-mcp.exe"
|
|||||||
|
|
||||||
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
|
Тогда лаунчер `scripts/launch-kompas-mcp.ps1` не смотрит в `bin/` плагина.
|
||||||
|
|
||||||
## Другие харнессы (Codex, opencode)
|
## Другие харнессы (Codex, opencode, pi)
|
||||||
|
|
||||||
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/` и
|
Тот же лаунчер подключается и к другим агентским харнессам — см. `adapters/codex/`,
|
||||||
`adapters/opencode/`. Это сниппеты конфигурации и инструкция, а не отдельные дистрибутивы:
|
`adapters/opencode/` и `adapters/pi/`. Это сниппеты конфигурации и инструкция, а не отдельные
|
||||||
контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
|
дистрибутивы: контент (навыки, лаунчер) не размножается, новый харнесс стоит README + сниппета.
|
||||||
|
Для pi основной путь — pi-пакет (`package.json` в корне прилавка, расширение `plugin/pi/kompas.ts`).
|
||||||
|
|
||||||
## Прочее
|
## Прочее
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,24 @@
|
|||||||
|
# Подключение к pi
|
||||||
|
|
||||||
|
Основной путь — pi-пакет целиком (см. [README плагина](../../README.md)): `pi install git:…` ставит и MCP-сервер
|
||||||
|
через расширение, и оба навыка, и поддерживает обновления.
|
||||||
|
|
||||||
|
Ручная альтернатива — тот же лаунчер, подключённый напрямую к конфигурации pi:
|
||||||
|
|
||||||
|
1. Склонировать `https://git.shahovalov.ru/mikhail/kompas-plugin.git` — сервер лежит внутри,
|
||||||
|
в `plugin/bin/` (требуется .NET Runtime 10+ x64).
|
||||||
|
2. Зарегистрировать MCP-сервер, заменив `<PLUGIN>` на абсолютный путь к каталогу `plugin/`
|
||||||
|
клона:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
pi mcp add kompas -- powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "<PLUGIN>\scripts\launch-kompas-mcp.ps1"
|
||||||
|
```
|
||||||
|
|
||||||
|
…или слить `mcp.snippet.json` со своим `~/.pi/agent/mcp.json`.
|
||||||
|
3. Навыки: скопировать `plugin/skills/{kompas-3d,kompas-fdm-design}` в
|
||||||
|
`~/.pi/agent/skills/` (или подключить их другим удобным способом).
|
||||||
|
|
||||||
|
Свой собранный сервер подставляется переменной окружения `KOMPAS_MCP_EXE` — она перекрывает
|
||||||
|
`plugin/bin/kompas-mcp.exe`.
|
||||||
|
|
||||||
|
Это сниппет и инструкция, а не дистрибутив.
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"kompas": {
|
||||||
|
"command": "powershell",
|
||||||
|
"args": ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass",
|
||||||
|
"-File", "<PLUGIN>/scripts/launch-kompas-mcp.ps1"],
|
||||||
|
"description": "Контроль КОМПАС-3D: детали, эскизы, формообразующие операции, сборки, чертежи, STEP/STL, осмотр модели"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
Binary file not shown.
Binary file not shown.
@@ -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.3": {
|
"kompas-mcp/0.7.6": {
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"Kompas.Mcp.Core": "0.7.3",
|
"Kompas.Mcp.Core": "0.7.6",
|
||||||
"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.3": {
|
"Kompas.Mcp.Core/0.7.6": {
|
||||||
"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.3.0",
|
"assemblyVersion": "0.7.6.0",
|
||||||
"fileVersion": "0.7.3.0"
|
"fileVersion": "0.7.6.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"libraries": {
|
"libraries": {
|
||||||
"kompas-mcp/0.7.3": {
|
"kompas-mcp/0.7.6": {
|
||||||
"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.3": {
|
"Kompas.Mcp.Core/0.7.6": {
|
||||||
"type": "project",
|
"type": "project",
|
||||||
"serviceable": false,
|
"serviceable": false,
|
||||||
"sha512": ""
|
"sha512": ""
|
||||||
|
|||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,36 @@
|
|||||||
|
// pi-расширение пакета kompas: регистрирует MCP-сервер КОМПАС-3D.
|
||||||
|
//
|
||||||
|
// Сервер и лаунчер едут внутри одного пакета (plugin/bin + plugin/scripts),
|
||||||
|
// поэтому путь резолвится от этого файла. Регистрация не сохраняется, поэтому
|
||||||
|
// она повторяется при каждой загрузке расширения.
|
||||||
|
//
|
||||||
|
// Свой сервер подставляется переменной окружения KOMPAS_MCP_EXE — ей управляет
|
||||||
|
// лаунчер launch-kompas-mcp.ps1, а не это расширение.
|
||||||
|
|
||||||
|
import path from "node:path";
|
||||||
|
import { fileURLToPath } from "node:url";
|
||||||
|
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
||||||
|
|
||||||
|
const launcher = path.resolve(
|
||||||
|
path.dirname(fileURLToPath(import.meta.url)),
|
||||||
|
"..",
|
||||||
|
"scripts",
|
||||||
|
"launch-kompas-mcp.ps1",
|
||||||
|
);
|
||||||
|
|
||||||
|
export default function (pi: ExtensionAPI) {
|
||||||
|
pi.registerMcpServer("kompas", {
|
||||||
|
command: "powershell",
|
||||||
|
args: [
|
||||||
|
"-NoProfile",
|
||||||
|
"-NonInteractive",
|
||||||
|
"-ExecutionPolicy",
|
||||||
|
"Bypass",
|
||||||
|
"-File",
|
||||||
|
launcher,
|
||||||
|
],
|
||||||
|
exposure: "deferred",
|
||||||
|
description:
|
||||||
|
"Контроль КОМПАС-3D: детали, эскизы, формообразующие операции, сборки, 2D-чертежи, STEP/STL, осмотр модели — через MCP-сервер kompas-mcp.exe",
|
||||||
|
});
|
||||||
|
}
|
||||||
+1
-1
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"$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.3",
|
"version": "0.7.6",
|
||||||
"description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.",
|
"description": "Управление КОМПАС-3D через MCP: детали, сборки, чертежи и STEP.",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "Shahovalov Mikhail"
|
"name": "Shahovalov Mikhail"
|
||||||
|
|||||||
@@ -46,6 +46,14 @@ MCP-сервер даёт **общие** операции КОМПАС (эски
|
|||||||
|
|
||||||
## Два правила прежде всего
|
## Два правила прежде всего
|
||||||
|
|
||||||
|
**Показывай построение человеку в чате.** При создании или изменении детали/сборки вызови
|
||||||
|
`model_preview` сразу после появления первого тела или загрузки существующей модели. Повторяй
|
||||||
|
после существенных этапов и в конце: виджет показывает снимок на момент вызова и сам не
|
||||||
|
обновляется. Не вызывай его после каждой операции и пока открыт эскиз на редактировании. Если
|
||||||
|
клиент не поддерживает MCP Apps (`shown: false`), больше не повторяй вызов и предложи
|
||||||
|
`model_snapshot` по запросу. Превью предназначено человеку и не заменяет численную проверку модели;
|
||||||
|
подробности — `help(topic="live-preview")`.
|
||||||
|
|
||||||
**1. «Зрение» — структурное, не по картинке.** «Увидеть» деталь = **`describe_model`** — паспорт
|
**1. «Зрение» — структурное, не по картинке.** «Увидеть» деталь = **`describe_model`** — паспорт
|
||||||
одним запросом и ЕДИНСТВЕННЫЙ инструмент осмотра: разделы `box | mass | bodies | topology | tree |
|
одним запросом и ЕДИНСТВЕННЫЙ инструмент осмотра: разделы `box | mass | bodies | topology | tree |
|
||||||
variables | errors | components` (`sections` сужает и ответ, и объём чтения модели). Углубляться —
|
variables | errors | components` (`sections` сужает и ответ, и объём чтения модели). Углубляться —
|
||||||
|
|||||||
+4
-4
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"version": "0.7.3",
|
"version": "0.7.6",
|
||||||
"tag": "v0.7.3",
|
"tag": "v0.7.6",
|
||||||
"sourceSha": "a97aed3a4a3be2c4a97ac53122f0694a23ae6194",
|
"sourceSha": "c9f42fb464d371c577a4c883a84e1dc4b1d49561",
|
||||||
"built": "2026-11-03T16:25:52Z"
|
"built": "2026-11-03T20:22:23Z"
|
||||||
}
|
}
|
||||||
Reference in new issue
Block a user