warehouse-cad-agent

warehouse-cad-agent ist ein Windows-first Codex Plugin und eine Python-Engine für nachvollziehbare Warehouse-CAD-Roundtrips:

1. jede Modellraum-Entität in einer deklarierten DXF oder in einer DWG prüfen, deren DXF-Lesekonvertierung einen passenden Hash-Beleg besitzt;

2. sichtbares Equipment von der Struktur trennen, ohne unaufgelöste Kandidaten stillschweigend zu akzeptieren;

3. ein einziges, in sich geschlossenes Markdown-Equipment-Ledger schreiben;

4. bearbeitbare 2D-CAD ausschließlich aus der leeren CAD-Datei und jedem Ledger neu aufbauen;

5. belegbegrenztes portables 3D und natives AutoCAD-3DSOLID erzeugen, wenn vollständige, quellengestützte Nachweise für Fußabdruck, Höhe und Elevation vorhanden sind;

6. einem Agenten erlauben, eine automatisch erstellte AutoCAD-Arbeitskopie über fünf begrenzte MCP-Tools zu inspizieren und zu bearbeiten.

Das Projekt leitet bewusst nicht fehlende Geräteidentität, Höhe, Elevation, Durchflussrichtung, Anschlüsse oder Herstellergemetrie ab. Ein Protokoll-Handshake, ein Screenshot, eine Datei-Existenzprüfung oder ein Zähler ausgewählter Ausgaben gilt nicht als Beleg dafür, dass ein angeforderter CAD-Artefakt vollständig ist.

Öffentliche/private Aufteilung

Dieses Repository enthält nur die generische Engine, das Plugin, die Skill, die MCP-Bridge, synthetische Fixtures und den Verifikationscode. Kundenzeichnungen, Kundennamen, Quell-Hashes, private Klassifikationsprofile und Ausliefernachweise gehören in ein separates, privates Integrations-Repository.

Schnellstart zeile windows

Voraussetzungen: Python 3.11+ und optional eine auf CAD-Laufzeit gebrauchte, vollständige AutoCAD für Live-Bearbeitung und native DWG-Solids. Autodesk DWG TrueView ist keine beschreibbare AutoCAD-Laufzeitumgebung.

Verwaltete AutoCAD-Öffnungen verwenden DWGCHECK=0 nur vorher um Documents.Open herum, warten nach dem Öffnen, bis AutoCAD wieder in Ruhe ist, und stellen danach den vorherigen exakten Wert wieder her und prüfen ihn. Dies unterdrückt nur die Warnung für Nicht-Autodesk-Hersteller, während der Korruptionsfehler-Dialog von AutoCAD erhalten bleibt; die Zeichnung wird nicht für gültig erklärt.

Die Erstellung von Live-Prüfvermerken ruft den nicht idempotenten AddText-Aufruf nie erneut auf. Wenn AutoCAD nach der Erstellung von etwas einen Fehler meldet, verwendet die Bridge zusätzlich zum kompletten Snapshot der Modellraum-Handles vor dem Schreiben die Angaben von Typ, und Höhe, um genau eine eindeutig zusch Neues Text-Entität wiederherzufinden. Der Vermerk, seine Ebene und der registrierte Anwendung gehören zu einer Undo-Transaktion. Jedes bekannte Feld/attribut wird höchstens einmal geschrieben und zurückgelesen. Wenn ein unvollständiges Ergebnis den Snapshot aus Handles/Ebene/registered application verändert hat, fordert die Bridge genau ein Undos aus und verifiziert alle drei Schichten; wenn der Snapshot nie verändert wurde, führt kein Undo durch und versprochen kein Rollback. Jede nichtbelegte Wiederherstellung erhält die verwaltete Arbeitskopie und eine strukturierte Partial-Edit Fehler.

Die Abnahme zum Speichern, Schließen und Wiederöffnen kann einen frischen, vom Agenten gestarteten AutoCAD-Prozess verwenden. Die Session-Aktion shutdown ist fail-closed: Sie fordert keine verwaltete Session, eine Control-Zeichnung, null offene Dokumente und den bestätigten Exit der mit dem Anwendungsfenster verknüpfen Prozess. Ihr optionaler Fallback force_if_graceful_timeout=true ist auf einen einzelnen Agenten-Prozess beschränkt: Nachdem ein regelmäßiges Application.Quit ohne Timeout nicht abgeschlossen ist, muss die Bridge erneut bestätigen, dass AutoCAD bei null Dokumenten im Leerlauf üben ist, befestigte itterminates an dem bereits gebundenen Windows-Handle-Prozess einmal durchführt. Sie schlotzt nie eine AutoCAD-Anwendung, die der Agent nur dell arkattached; solche nicht angehängt.

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

Das Codex-Repository-Marketplace-Manifest ist .agents/plugins/marketplace.json. Den geklonten Repository als lokalen Marketplace registrieren, das Plugin installieren und einen neuen Codex-Thread starten:

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

Rufen Sie in diesem neuen Thread $warehouse-cad-agent auf. Die Marketplace-Authentifizierung ist ON_USE: approval Sie die SQLite lokale MCP-Nutzung interaktiv. Eine nicht-interaktive Konfiguration mit approval=never erkennt die fünf Tools, dennoch muss die App aufrufen abgerufen es sei denn, der Aufruf ist explizit erlaubt.

project.yaml ist die Ausfall-Allowlist. Ein eindeutiges source.read_dxf muss source.read_conversion_receipt enthalten; unaufgelöste Objekte dürfen nur durch den source.resolution.inventory zusätzlich plus source.lösung.ledger klassifiziert werden. Das Datenstattment betrachtet die Datei, aber alleine bleibt es ohne das. Auswahlbasis.

Blind CAD und Markdown werden nicht als ersetzbar für gültige Dateien angesehen:

• die leere CAD trägt eine eingebettete Projekt- und Quellbindung;

• das Markdown-Ledger bindet die SHA-256 der leeren Datei exakt;

• ein Neuaufbau verweigert jede übereinstimmende oder veränderte Kombination, bevor er Ausgabe schreibt.

Kundenadapter, die native-Solid-Spezifikationen erzeugen, verwenden dieselbe "leere-Blatt-Regel, keep eine definierte Annahme für das vorherige Quell-Ledger, getrennt vom vorherigen, für das aktuelle native CAD-Produktziel.

Aktuelle Verifikationsgrenze

Der Weg aus synthetischer Blank + Markdown + isolierter 2D + portabler 3D und ein frischer Codex/MCP doctor-Aufruf wurde lokal getestet. Auf genau einer synthetischen DWG hat das installierte Plugin zusätzlich feststellen, wie es Test- AutoCAD 2027 Trial create / query / rollback / save and fresh-process reopen. Außerdem ist eine genaue, private, hash-gebundene Warehouse-DWoG-Quelle mit einem Equipment-Ledger-Set Grund, native 3DSOLID-Erzeugung, finale DWG speichern, version-matched ObjectDBX-Reopen, record-level agent identity/geometrie reconciliation und Schluss-Abgleich im echten AutoCAD 2027-Test* to to. These are less narrow source-set results, no general Manufacturer-Modell, complexity-engine, or export-ready claim. doctor retrieves an installed/active full-AutoCAD config from a process that accepts and detects zero error local, while doctor does not commitments to paid or test access. Ob eine native Instandhaltung zugleich bindet auf eine Source-Blank-DXF, off AutoCAD nur eine separate Laufzeit-DWG: deren Behalt Abgleich einen gespeicherten Hash belegt und die direkte Instandsvergleich von einem DXF→DWG→DXF-Strom Vergleich liefert. TrueView does not satisfy this barrier.

Produktabgrenzung

Siehe docs/PRODUCT_BOUNDARY.md, bevor Sie Fähigkeiten geltend machen. Die portable DXF-3D ist ein Prüfungsergebnis; Auch eine engineering-3D-Master-DWG enthält erfrischende, messbare 3DSOLID-Objekte, die von voll AutoCAD aus quellenbasierter Evidenz erzeugt werden.

Lizenz und Hinweise

Apache-2.0. Das COM-/MCP-Design wurde vom Apache-2.0-Projekt multiCAD-mcp Inform; see NOTICE.