WorkBuddy-QMT Bridge

Native, fail-closed Trading-Bridge zwischen WorkBuddy/MCP und dem in QMT integrierten Python.

Wichtiger Risikohinweis

Dieses Projekt kann Aufträge auf Simulations- oder Echtgeldkonten auslösen, stellt keine Anlageberatung dar und garantiert keine Gewinne. Der Standardmodus ist OBSERVE_ONLY. Jede Echtgeld-Bereitstellung muss zuvor eine Vor-Ort-Abnahme der Ziel-QMT-Version, des Broker-Backends, der Kontofelder, der Auftragsbestätigungen, der Stornierung und der Wiederherstellungsabläufe durchlaufen. Die Beispiel-Mappings im Repository dürfen nicht direkt im Live-Betrieb verwendet werden.

Aktuelle Version

• Version: 0.3.0

• Phase: P1 LIMITED_AUTO Software-Steuerungsebene abgeschlossen

• MCP-Tools: 29

• Python: Worker benötigt 3.10 oder höher

• QMT-Adapter: Kompatibel mit der in QMT integrierten Python-3.6-Umgebung

• Laufzeitgrenze: Bindet nur an 127.0.0.1, keine Abhängigkeit von xtquant

Projektseite: https://github.com/peppaboar95/workbuddy-qmt-bridge

„P1 abgeschlossen" bedeutet nur, dass die strukturierte Autorisierung, die Reservierung von Limits, die Zustandsmaschine, die Schutzschalter und die Adapter-Gegenprüfung auf der Softwareseite implementiert und lokal getestet wurden. Es bedeutet nicht, dass ein beliebiges Echtgeld-Backend abgenommen wurde.

Related MCP server: IBKR MCP Server

Vier Modi

SIM_SIGNAL bedeutet nicht „nur Signale erzeugen, aber nicht handeln". Wenn fälschlicherweise eine Verbindung zu einem Echtgeld-Backend hergestellt wird, kann es dennoch passorder aufrufen. Daher müssen Konto und Backend manuell überprüft werden.

Sicherheitsdesign

• Zweiphasen-Commit mit preview_trade und submit_trade_intent;

• Beim Senden werden die vollständigen harten Risikoprüfungen erneut ausgeführt und der Risikoentscheidungs-Fingerprint verglichen;

• Worker und QMT-Adapter prüfen auf beiden Seiten Konto, Modus, Signatur, TTL und Autorisierungsgeneration;

• LIMITED_AUTO-Genehmigung ist gebunden an Konto, Wertpapier, Aktion, Strategie/Regelversion, Handelsfenster, Auftragstyp und mehrstufige Limits;

• Atomare Limit-Reservierung mit Begrenzung von Einzelauftrag, kumuliertem Betrag, Auftragsanzahl, Frequenz, Parallelität, Positionsrisiko, Drawdown und aufeinanderfolgenden Fehlern;

• PRE_SUBMIT- oder SUBMIT_CALLED-Status werden nicht automatisch erneut gesendet; unbekannte Ergebnisse bleiben SUBMIT_UNKNOWN;

• Nach einem Schutzschalter-Auslösen ist die Wiederherstellung nur lokal möglich und kehrt sicher zu OBSERVE_ONLY zurück;

• Automatischer Kredithandel ist standardmäßig deaktiviert; neue Kreditverbindlichkeiten erfordern zusätzliche explizite Genehmigung und Vor-Ort-Abnahme.

Installation

Normale Benutzer laden vorzugsweise das Installations-ZIP, den separaten ZIP-Hash und die Gesamt-Hashliste von GitHub Releases herunter:

• workbuddy-qmt-bridge-0.3.0.zip

• workbuddy-qmt-bridge-0.3.0.zip.sha256

• SHA256SUMS.txt

Nach der Hash-Prüfung das ZIP entpacken und „首次安装与配置.cmd" per Doppelklick ausführen. Für die manuelle Installation des Wheels herunterladen:

• workbuddy_qmt_bridge-0.3.0-py3-none-any.whl

Windows PowerShell:

python -m pip install .\workbuddy_qmt_bridge-0.3.0-py3-none-any.whl
workbuddy-qmt setup

Entwicklungsinstallation aus dem Quellcode:

git clone https://github.com/peppaboar95/workbuddy-qmt-bridge.git
cd workbuddy-qmt-bridge
python -m pip install -e .

Vom Nur-Lesen zum Handel

1. setup ausführen, um lokale Konfiguration, Schlüssel, Worker-Token und Kontoisolationsverzeichnisse zu erstellen;

2. Die generierten qmt_adapter.py und qmt_adapter.json in der entsprechenden QMT-Strategieinstanz bereitstellen;

3. OBSERVE_ONLY beibehalten und die Erfassung von Heartbeat, Konto, Positionen, Aufträgen, Ausführungen und Marktdatenfeldern abschließen;

4. P0-Mapping-Verifizierung auf dem Ziel-Simulations-Backend durchführen und das Profile signieren;

5. In SIM_SIGNAL die Abgleichung von Mindestmenge, Auftragserteilung, Ausführung, Stornierung, Neustart und Wiederherstellung unbekannter Ergebnisse abschließen;

6. Für Echtgeld-Szenarien zuerst eine kleine Abnahme mit MANUAL_LIVE durchführen;

7. Erst wenn readiness keine Blockaden aufweist und die Strategiegrenzen klar definiert sind, eine LIMITED_AUTO P1-Genehmigung erstellen.

Die 1–60 Minuten Zeitautorisierung von MANUAL_LIVE befreit nur von der manuellen Einzelauftrags-Freigabe; jede Transaktion muss weiterhin neu synchronisiert, in der Vorschau geprüft und die harten Risikoprüfungen bestanden werden. Die Genehmigung von LIMITED_AUTO dauert maximal 720 Minuten, darf aber nicht über einen Handelstag hinausgehen und unterliegt den vollständigen Strategiegrenzen und dem kumulierten Budget.

LIMITED_AUTO P1-Ablauf

1. Worker und zugehörigen Adapter lokal auf LIMITED_AUTO umschalten;

2. check_limited_auto_readiness aufrufen, um zu bestätigen, dass Warteschlange, Snapshot, Heartbeat, Dead Letter und SUBMIT_UNKNOWN keine Blockaden aufweisen;

3. Dem Operator die vollständige Genehmigungsrichtlinie anzeigen und nach ausdrücklicher Bestätigung authorize_limited_auto aufrufen;

4. Automatische Aufgaben führen für jede Transaktion weiterhin Synchronisierung, Vorschau und Senden aus;

5. Mit get_limited_auto_status die verbleibende Zeit, Auftragsanzahl, Betragsbudget und Pausengründe beobachten;

6. Wenn Gesundheits-, Drawdown- oder aufeinanderfolgende Fehlerschutzschalter auslösen, wird automatisch pausiert; nach Wiederherstellung der Bedingungen kann nur explizit über resume_limited_auto fortgesetzt werden;

7. Am Ende revoke_limited_auto aufrufen. Das Widerrufen der Genehmigung widerruft nicht automatisch bereits beim Broker platzierte Aufträge.

Verifiziert und nicht verifiziert

Die lokalen inkrementellen Tests dieser Version decken ab:

• Schema-Migration von v1 auf v2;

• Strukturierte P1-Genehmigung;

• Vorschau, Senden und atomare Limit-Belegung;

• Strategieversionsbindung;

• Pause, Fortsetzung und Rotation der Autorisierungsgeneration;

• Adapter-Manipulationsschutz-Gegenprüfung.

Für die Zielumgebung müssen noch abgeschlossen werden:

• Fähigkeitsmatrix für echte QMT- und Broker-Builds;

• Auftrags-, Ausführungs-, Hinweis- und Stornierungsbestätigungen von Echtgeld-Backends;

• Windows-ACL-, Backup-, Wiederherstellungs- und SUBMIT_UNKNOWN-Übungen;

• Sechs Aktionsarten für Kreditkonten, Felddimensionen, Berechtigungen, Limits und Verbindlichkeitsregeln;

• Kleine manuelle Echtgeld-Abnahme.

Daten und Datenschutz

runtime, Datenbank, WAL/SHM, Logs, Warteschlangen, Ausführungsprotokolle, signierte Profile, Schlüssel, Worker-Token, Kontonummern und lokale MCP-Konfiguration dürfen weder ins Repository übertragen noch an Issues angehängt werden. Diagnosematerial muss zuerst anonymisiert werden.

Dokumentation

• Veröffentlichung und Installation: docs/README-RELEASE.zh-CN.md

• P1-Validierungshinweise: docs/P1-VALIDATION.zh-CN.md

• Konfigurationsbeispiele: examples/README.md

• Sicherheitsrichtlinie: SECURITY.md

Lizenz

Dieses Projekt ist unter der MIT License lizenziert, siehe LICENSE.