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
@@ -1,4 +1,65 @@
 # КОМПАС-3D в Claude Code

-Репозиторий поставки плагина `kompas`. Содержимое появляется с первым релизом —
-его публикует workflow из репозитория с исходниками.
+Каталог плагинов с одним плагином — **`kompas`**. Он даёт Claude Code управление
+[КОМПАС-3D](https://ascon.ru/products/7/) (АСКОН) через MCP-сервер: детали, эскизы,
+формообразующие операции, массивы и зеркало, отверстия, сборки с сопряжениями, 2D-чертежи,
+STEP/STL, осмотр и измерение модели — плюс два навыка с методикой построения.
+
+Это репозиторий поставки: здесь лежит собранный сервер и материалы плагина. Исходники сервера
+не публикуются.
+
+## Что нужно до установки
+
+- **Windows x64** — сервер является COM-клиентом КОМПАС и работает только на той же машине;
+- **установленный КОМПАС-3D** (проверено на v24 Home) **с компонентом 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 (2,3 МБ вместо 34), поэтому рантайм берётся с машины.
+  Проверить: `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
+```
+
+`/kompas:doctor` — диагностика: версия сервера, установлен ли КОМПАС, на месте ли interop-сборки,
+проходит ли соединение. С неё стоит начинать разбор любой неполадки.
+
+## Обновление
+
+```
+/plugin marketplace update kompas-plugin
+/plugin update kompas@kompas-plugin
+```
+
+Если после обновления инструменты остались прежними — `/reload-plugins`.
+
+## Что внутри
+
+| | |
+|---|---|
+| **MCP-сервер `kompas`** | 85 инструментов: документы, эскизы, выдавливание/вращение/по сечениям/по траектории, оболочка, рёбра, уклон, скругления и фаски, массивы и зеркало, отверстия, булевы операции, прямое редактирование B-rep, переменные и параметризация, сборки и сопряжения, 2D-чертежи (виды, размеры, обозначения, тех. требования), STEP/STL, осмотр (`describe_model`, `list_faces`, `list_edges`, `measure`) |
+| **Навык `kompas-3d`** | методика построения: порядок работы, выбор подхода, проверенные приёмы и ловушки |
+| **Навык `kompas-fdm-design`** | проектирование под FDM/FFF-печать: нависания, толщины стенок, зазоры и посадки, ориентация, бобышки и защёлки |
+| **Команда `/kompas:doctor`** | диагностика установки |
+| **Справка `help`** | инструмент `help(topic=…)` — статьи по механике и ловушкам, прямо в сессии |
+
+## Другие агентские харнессы
+
+Тот же сервер подключается к Codex и opencode — сниппеты конфигурации лежат в
+`plugin/adapters/{codex,opencode}/`.
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE). На interop-сборки КОМПАС-3D (© АО «АСКОН») лицензия не
+распространяется: они в поставку не входят.