solidworks-gpt-plugin — плагин для Claude Code
Плагин solidworks-gpt-plugin добавляет в Claude пять скиллов, которые ведут проектирование в SolidWorks от требований до проверенной модели и отчёта о сессии.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install solidworks-gpt-plugin@awesome-codex-pluginsЧто делает solidworks-gpt-plugin
Пять скиллов делят работу между собой. solidworks-design проводит запрос от требований через планирование и моделирование к сдаче, sw-pre-start подгружает конвенции и активные правила проекта, sw-kb-api ищет в базе знаний детали каталога, опубликованные инструкции сборки, макросы и известные ошибки. Два оставшихся скилла отвечают за обратную связь: sw-learner собирает исправленный отчёт по текущей сессии SolidWorks, sw-session-reporter спрашивает согласие и отправляет его.
Перед любым изменением геометрии workflow фиксирует единицы, размеры, материал, допуски и ожидаемый результат. Модель считается готовой, только если сходятся состояние пересборки, дерево фич, масса, габаритный бокс и проверка validate_document. База знаний по умолчанию живёт на https://sw-plugin.ideep.org, другой адрес задаётся переменной SW_KB_HOST. Если база не отвечает, сбой записывается, а работа с CAD продолжается.
Для настоящего моделирования нужен Windows с установленным SolidWorks и уже доступная Codex поверхность автоматизации, например мост MCP/COM. Сам плагин MCP-сервер не содержит, поэтому без такого моста он доведёт дело до плана и проверок, а геометрию строить будет нечем. Ещё понадобятся curl для запросов к базе и Python 3.9+ для служебных скриптов. scripts/doctor.py проверяет окружение и не делает сетевых запросов.
Какие задачи решает
- зафиксировать единицы, материал и допуски до правок геометрии
- собрать ступенчатый вал по размерам и получить сохранённую деталь с экспортом в STEP
- проверить модель по пересборке, массе и габаритному боксу перед сдачей
- найти готовую инструкцию сборки или макрос вместо того, чтобы писать заново
- отправить уроки сессии в базу знаний, не нарушая согласие пользователя
Примеры запросов агенту
- Спроектируй метрический ступенчатый вал в SolidWorks: единицы мм, материал AISI 1045, длина 160, посадочные места 25 h6 на 30 с обоих концов. Нужны сохранённая деталь, экспорт в STEP, масса и габариты.
- Прогони
validate_documentна открытой детали и покажи отчёт по пересборке и дереву фич. - Собери итоги сессии и спроси, отправлять ли их в базу знаний.
Как установить solidworks-gpt-plugin
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install solidworks-gpt-plugin@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о solidworks-gpt-plugin
Как установить solidworks-gpt-plugin в Claude Code?
Сначала подключите маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установите плагин: /plugin install solidworks-gpt-plugin@awesome-codex-plugins. После этого начните новую задачу, чтобы скиллы загрузились.
Что делает solidworks-gpt-plugin?
Ведёт проектирование в SolidWorks по одному маршруту: требования и предполётные проверки, поиск по базе знаний, план фич, моделирование и измеряемая валидация. В конце собирает отчёт о сессии и отправляет его только с согласия.
Что нужно, чтобы плагин действительно строил модели?
Windows с установленным SolidWorks и готовая поверхность автоматизации для Codex, например интеграция MCP/COM. Без неё плагин ограничится планом и проверками; для запросов к базе знаний нужен curl, для служебных скриптов — Python 3.9+.
Исходный текст
solidworks-GPT-plugin · MIT
# solidworks-GPT-plugin
[](https://github.com/Erfouni/solidworks-GPT-plugin/actions/workflows/validate.yml)
[](https://www.python.org/)
[](#requirements)
[](LICENSE)
An installable Codex plugin that ports the knowledge workflow of
[`solidworks-claude-plugin`](https://github.com/mesutfd/solidworks-claude-plugin)
to OpenAI Codex.
It adds five coordinated skills:
- `solidworks-design` orchestrates requirements, planning, modeling, validation, and delivery.
- `sw-pre-start` loads conventions, active design rules, relevant references, and initial rule checks.
- `sw-kb-api` looks up catalog parts, published build instructions, macros, known errors, and lessons.
- `sw-learner` builds a complete, corrected feedback payload from the current SolidWorks session.
- `sw-session-reporter` asks for consent and submits feedback to the knowledge base.
<p align="center">
<img src="assets/workflow-demo.svg" alt="SolidWorks GPT Plugin conceptual workflow from engineering requirements to validated delivery" width="100%">
</p>
<p align="center"><sub>Conceptual workflow preview—not a recorded CAD result. Every reported model still has to pass the measured validation gates shown above.</sub></p>
## What the workflow guarantees
This plugin is designed for engineering work where a plausible answer is not
enough. It makes requirements, knowledge lookup, modeling, and validation
explicit parts of one workflow:
```mermaid
flowchart LR
A[Design request] --> B[Requirements and pre-start checks]
B --> C[Standards and knowledge lookup]
C --> D[Feature and datum plan]
D --> E[SolidWorks modeling]
E --> F{validate_document passes?}
F -- No --> G[Inspect and repair]
G --> E
F -- Yes --> H[Save, export, and report evidence]
H --> I[Build session lessons]
I --> J{User consent?}
J -- Yes --> K[Submit validated feedback]
J -- No --> L[Keep the session local]
```
| Boundary | Behavior |
|---|---|
| Engineering inputs | Units, dimensions, material, tolerances, and outputs are confirmed before geometry changes. |
| Knowledge | Standards, proven build instructions, macros, errors, and lessons are retrieved before modeling. |
| CAD validation | Rebuild state, feature tree, mass, bounding box, and `validate_document` determine pass or fail. |
| Privacy | Feedback is local by default and is submitted only with explicit or previously saved consent. |
## 60-second tour
After installing the plugin, start a new Codex task with a concrete engineering
request. For example:
```text
Design a metric stepped shaft in SolidWorks.
Units: mm
Material: AISI 1045
Overall length: 160
Bearing seats: 25 h6 x 30 long at both ends
Center section: 35 mm diameter
Output: saved part, STEP export, mass, bounding box, validation report
```
The workflow will stop for any geometry-changing requirement that is still
ambiguous, retrieve applicable standards and known patterns, plan the model,
build each document, and report measured validation evidence. A knowledge-base
outage is recorded but does not block local CAD work.
The default knowledge base is `https://sw-plugin.ideep.org`. Override it with
the `SW_KB_HOST` environment variable. Read-only runtime endpoints are public;
session feedback is sent only after the user chooses **Yes, send now** or has
previously chosen **Always send**.
## Install from GitHub
```powershell
codex plugin marketplace add Erfouni/solidworks-GPT-plugin
codex plugin add solidworks-gpt-plugin@solidworks-gpt
```
Restart the ChatGPT desktop app or start a new Codex task after installation so
the new plugin skills are loaded.
For a local checkout, replace the GitHub shorthand in the first command with
the absolute path to this repository.
## Requirements
- Windows with SolidWorks installed for actual CAD work.
- A SolidWorks automation surface already available to Codex (for example a
SolidWorks MCP/COM integration). This plugin supplies the design and knowledge
workflow; it does not bundle an MCP server or install SolidWorks itself.
- `curl` for knowledge-base calls.
- Python 3.9+ for the optional deterministic session and feedback utilities.
Knowledge-base outages never block CAD work. The skills record the outage and
continue with the available SolidWorks tooling and engineering context.
## Diagnose local readiness
Run the bundled doctor before the first CAD task:
```powershell
python plugins/solidworks-gpt-plugin/scripts/doctor.py
```
It validates Python, the installed manifest/skills/schema, `SW_KB_HOST` syntax,
`curl`, and the local SolidWorks COM registration. It makes zero network
requests and never launches SolidWorks. Missing optional dependencies are
reported as warnings; require the complete CAD and feedback environment with:
```powershell
python plugins/solidworks-gpt-plugin/scripts/doctor.py --strict
```
For CI, support packets, or reproducible installation evidence, use `--json`.
Host output is credential-free, and endpoint reachability is deliberately not
claimed.
For release notes and project questions, see the
[latest release](https://github.com/Erfouni/solidworks-GPT-plugin/releases/latest),
the [changelog](CHANGELOG.md), and
[GitHub Discussions](https://github.com/Erfouni/solidworks-GPT-plugin/discussions).
## Privacy and local state
- `.sw-learner-state.json` stores the current session ID and submission metadata
in the working directory.
- `~/.sw-feedback-pref` contains `always` only after the user explicitly chooses
**Always send**.
- Feedback may include build instructions, generated macros, resolved errors,
lessons, and model images. The payload is never submitted without consent
unless the saved `always` preference is present.
## Validate the plugin
From this repository root:
```powershell
python plugins/solidworks-gpt-plugin/scripts/run_checks.py
```
The repository also includes the original porting specification and the KB
admin OpenAPI reference under `plugins/solidworks-gpt-plugin/docs/`.
## Contributing
Bug reports, documentation improvements, and focused pull requests are
welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), use the structured issue
templates, and run the repository checks before opening a pull request.
## License
MIT. See [LICENSE](LICENSE) and [NOTICE](NOTICE) for upstream attribution.
© Erfouni · MIT · hashgraph-online/awesome-codex-plugins