warehouse-cad-agent

warehouse-cad-agent — это Windows-first плагин Codex и Python-движок для отслеживаемых циклов работы со складским CAD:

1. аудит каждой сущности пространства модели в объявленном DXF или в DWG, чья read-DXF конвертация имеет совпадающую хэш-квитанцию;

2. отделение видимого оборудования от конструкции без молчаливого принятия неразрешённых кандидатов;

3. создание одного самодостаточного Markdown-реестра оборудования;

4. восстановление редактируемого 2D CAD только из пустого CAD и этого реестра;

5. создание ограниченного доказательствами переносимого 3D и нативного 3DSOLID AutoCAD, когда существуют полные подтверждённые исходными данными сведения о footprint, высоте и отметке;

6. возможность Агенту просматривать и редактировать автоматически созданную рабочую копию AutoCAD через пять ограниченных инструментов MCP.

Проект намеренно не выводит отсутствующие идентичность устройства, высоту, отметку, направление потока, порты или геометрию производителя. Протокольное рукопожатие, скриншот, проверка существования файла или количество выбранных выходных данных не считаются доказательством полноты запрошенного CAD-артефакта.

Разделение публичного/частного

Этот репозиторий содержит только универсальный движок, плагин, навык, MCP-мост, синтетические фикстуры и код проверки. Чертежи клиентов, имена клиентов, исходные хэши, частные профили классификации и доказательства поставки принадлежат отдельному частному интеграционному репозиторию.

Быстрый старт в Windows

Требования: Python 3.11+ и, опционально, полный AutoCAD с COM-автоматизацией для живого редактирования и нативных твердотельных объектов DWG. Autodesk DWG TrueView не является доступным для записи временем выполнения AutoCAD.

Управляемые открытия AutoCAD временно используют DWGCHECK=0 только вокруг Documents.Open, ожидают, пока AutoCAD не станет бездействующим после открытия, затем восстанавливают и проверяют точное предыдущее значение. Это подавляет только предупреждение о непроизводителе Autodesk, сохраняя диалог ошибок повреждения AutoCAD; это не объявляет чертёж действительным.

Создание живых заметок проверки никогда не повторяет неидемпотентный вызов AddText. Если AutoCAD сообщает об ошибке вызова после создания чего-либо, мост использует снимок дескрипторов пространства модели до записи, а также тип, вставку и высоту, чтобы восстановить только один уникально атрибутируемый новый текстовый объект. Заметка, её слой и зарегистрированное приложение принадлежат одной транзакции отмены. Известные поля записываются не более одного раза и считываются обратно. Если неполный результат изменил снимок дескриптора/слоя/зарегистрированного приложения, мост запрашивает одну отмену и проверяет все три набора; если снимок никогда не менялся, он не отменяет и не заявляет об откате. Любое недоказанное восстановление сохраняет управляемую рабочую копию с структурированной ошибкой частичного редактирования.

Принятие сохранённых/закрытых/повторно открытых файлов может использовать новый процесс AutoCAD, запущенный Агентом. Действие сеанса shutdown является fail-closed: оно требует отсутствия управляемого сеанса, отсутствия контрольного чертежа, нулевого количества открытых документов и подтверждённого выхода точного процесса, привязанного к окну приложения. Его опциональный запасной вариант force_if_graceful_timeout=true ограничен этим процессом, запущенным Агентом: после того как один корректный Application.Quit истекает по тайм-ауту, мост должен повторно подтвердить, что AutoCAD бездействует с нулевым количеством документов, прежде чем завершить уже привязанный дескриптор процесса Windows один раз. Он никогда не завершает и не прекращает работу приложения AutoCAD, к которому Агент лишь присоединился.

py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
.\.venv\Scripts\warehouse-cad-agent doctor
.\.venv\Scripts\python.exe examples\synthetic\make_fixture.py
.\.venv\Scripts\warehouse-cad-agent roundtrip examples\synthetic\project.yaml

Манифест маркетплейса репозитория Codex — это .agents/plugins/marketplace.json. Зарегистрируйте клонированный репозиторий как локальный маркетплейс, установите плагин, затем начните новый поток Codex:

git clone https://github.com/X-isdoingreat/warehouse-cad-agent.git
Set-Location warehouse-cad-agent
codex plugin marketplace add .
codex plugin add warehouse-cad-agent@warehouse-cad-agent

Вызовите $warehouse-cad-agent в этом новом потоке. Маркетплейс использует аутентификацию ON_USE: одобрите первое локальное использование MCP в интерактивном режиме. Неинтерактивный сеанс, настроенный с approval=never, обнаружит пять инструментов, но должен отказать в вызове, если этот вызов явно не авторизован.

project.yaml — это список разрешений на запуск. Отдельный source.read_dxf должен включать source.read_conversion_receipt; неразрешённые объекты могут быть классифицированы только через связанные source.resolution.inventory и source.resolution.ledger. Аудит продукта перечисляет файл, но сам по себе не является независимым знаменателем приёмки клиента.

Пустой CAD и Markdown не считаются взаимозаменяемыми допустимыми файлами: пустой файл несёт встроенную привязку проекта/источника, реестр Markdown также привязывает точный SHA-256 пустого файла, и каждая пересборка отклоняет несовпадающую или изменённую пару перед записью выходных данных. Адаптеры клиентов, которые создают спецификации нативных твердотельных объектов, используют то же правило точного пустого файла и держат предыдущую цель приёмки исходного реестра отдельно от текущей цели продукта нативного CAD.

Текущее ограничение проверки

Синтетический путь «пустой + Markdown + изолированный 2D + переносимый 3D» и свежий вызов doctor Codex/MCP были проверены локально. На одном точном синтетическом DWG установленный плагин также прошёл реальное создание/запрос/откат/сохранение в AutoCAD 2027 Trial, а также сверку повторного открытия в новом процессе. Один точный, частный, привязанный к хэшу складской DWG + набор исходных данных реестра оборудования дополнительно прошёл нативную генерацию 3DSOLID, сохранение финального DWG, повторное открытие ObjectDBX с совпадающей версией, сверку идентичности/геометрии на уровне записей Агента и сверку финальной структуры в реальном AutoCAD 2027 Trial. Это узкие результаты для конкретного набора исходных данных, а не заявление о произвольном DWG, моделях производителей, BIM или готовности к производству. doctor отличает установленную/активную полную идентичность AutoCAD от процесса, который в данный момент достаточно бездействует для приёма автоматизации; он не делает вывод о платной или пробной лицензии. Когда спецификация нативного твердотельного объекта остаётся привязанной к исходному пустому DXF, AutoCAD открывает только отдельно предоставленный рабочий DWG, чья квитанция о преобразовании связывает оба хэша и доказывает сравнение структуры DXF→DWG→DXF с нулевым расхождением в потоковом режиме. TrueView не удовлетворяет этому условию.

Границы продукта

См. docs/PRODUCT_BOUNDARY.md перед заявлениями о возможностях. Переносимый DXF 3D является производным аудита; нативный инженерный 3D-мастер — это DWG, содержащий повторно открытые, измеримые объекты 3DSOLID, созданные полным AutoCAD на основе подтверждённых исходных данных.

Лицензия и атрибуция

Apache-2.0. Дизайн COM/MCP был разработан с учётом проекта multiCAD-mcp под лицензией Apache-2.0; см. NOTICE.