Vergleichstabelle CLI vs. Trader

Lieber Benutzer, dieses Kapitel fasst die in der Trader Shell (Befehlszeilenschnittstelle) verfügbaren Befehle und die damit zu lösenden Probleme zusammen. Die Hilfe und die Echtzeitausgabe in der Shell sind auf Englisch; die folgende Tabelle ist auf Chinesisch.

So gelangen Sie in die Shell: > Führen Sie qt.run(op, mode=0, …) mit live_trade_ui_type=‘cli‘ aus oder fügen Sie beim Ausführen des Beispiels –ui cli hinzu. Sobald Sie sich in der Shell befinden, können Sie Befehle an der Eingabeaufforderung eingeben, als würden Sie mit einem Händler sprechen.

Anwendungsbereich

Eingabemethode: qt.run(op, mode=0, ...) und live_trade_ui_type='cli' (oder beispielsweise ``–ui cli`)
DEBUG-Modus: run –task … und verschiedene Debugging-Aufgaben sind nur verfügbar, wenn Trader auf debug=True eingestellt ist (beginnen Sie mit –debug oder wechseln Sie mit dem Befehl debug in der Shell).
Die Hilfeausgabe ist für den Benutzer in Englisch sichtbar; die Dokumentation ist in Chinesisch.

Befehlsaliase

Trader Shell unterstützt kurze Aliase, wodurch Tipparbeit reduziert wird. Aliase werden vor der Ausführung in qteasy in die offiziellen Befehlsnamen umgeschrieben – Hilfe und Protokolle verwenden weiterhin die offiziellen Namen. Die folgende Tabelle listet nur Aliase für Betrieb und Wartung auf; vollständige Befehlsdetails finden Sie in der späteren „Funktionsvergleichstabelle“.

Bedeutung der einzelnen Spalten: Der eingegebene Alias ist die von der Shell akzeptierte Form; der interne Befehl ist der tatsächliche Name des aufgerufenen do_*-Prozessors.

Anwendung: Bei Verwendung der Bindestrichschreibweise verwenden Sie die linke Spalte; bei der Angabe eines formalen Namens in einem Skript oder Dokument verwenden Sie die rechte Spalte. Wenn beispielsweise in einem Debugging-Dokument „gate“ verwendet wird, können Sie auch „startup-gate“ eingeben.

Beispiel: Beim Überprüfen des Log-Pfads hat die Eingabe von ls-artifacts den gleichen Effekt wie die Eingabe von artifacts.

Der von Ihnen eingegebene Alias	Interne Befehle
ls-artifacts	artifacts
live-config	liveconfig
startup-gate	gate
`snapshot-reconcile`	reconcile
rotate-logs	rotatelogs
pull-state	sync

Fähigkeitsvergleichstabelle

Diese Tabelle dient als Hauptindex für öffentliche Funktionen für Trader/Broker und Shell-Befehle: Links wird angezeigt, was qteasy leisten kann, in der Mitte, was Sie eingeben müssen, und rechts, ob die Funktion in der aktuellen Version implementiert ist. Im Live-Subsystem ist die Befehlszeilenschnittstelle (CLI) einer der wichtigsten Einstiegspunkte für Operationen und Smoke-Operationen; über die API-Spalte können Sie dieselben Funktionen in Notebooks oder Skripten aufrufen.

Bedeutung der einzelnen Spalten:

Funktionen: Funktionsbereich Händler-/Brokerseite
Typische Anwendungsfälle: Wann benötigen Sie es (Fehlerbehebungsszenarien)?
Binding-API (Zusammenfassung): Python-seitiger Einstiegspunkt (unvollständige Signatur)
CLI-Befehl: Shell-Name; – bedeutet, dass kein direkter CLI-Befehl vorliegt.
Status: Unterstützt / Reserviert (Noch nicht implementiert)

Anwendung: Suchen Sie nach „typischer Verwendung“ – zum Beispiel, um das Protokollverzeichnis zu finden → suchen Sie nach „Wo befinden sich die Protokolldateien?“ → verwenden Sie artifacts. Behandeln Sie den Status reserviert nicht als Fehler (z. B. synchronisieren).

Beispiel: Um die Live-Konfiguration nach dem Start zu überprüfen → Typischer Anwendungsfall: „Überprüfen, ob die aktuelle Live-Konfiguration wirksam ist“ → Befehl liveconfig oder live-config.

Fähigkeit	Typische Anwendungen	API-Bindung (Zusammenfassung)	CLI-Befehl	Zustand
Status / Angehalten / Beenden	Prüfen Sie, ob der Prozess läuft, pausiert/fortgesetzt ist oder die Shell beendet wird.	„status`, `pause`, `resume`, ``stop`“ usw.	`status` `pause` `resume` `bye` …	Unterstützt
Manuelle Auftragserteilung / Auftragsstornierung	Manuelle Auftragsprüfung oder Stornierung	`submit_trade_order`, `cancel`	`buy` `sell` `cancel ORDER_ID`	Unterstützt
Lese-/Schreibzugriff konfigurieren	Laufende Konfiguration anzeigen oder ändern	`get_config` / `update_config`	config	Unterstützt
Pfad zu Datenträgerartefakten	Finden Sie heraus, wo sich die Protokolldateien befinden.	`qt.list_live_trade_artifacts`	`artifacts` / `ls-artifacts`	Unterstützt
Zusammenfassung der Live-Konfiguration	Prüfen Sie, ob die aktuelle Live-Konfiguration wirksam ist.	`build_live_trade_config` → `to_summary_dict`	`liveconfig` / `live-config`	Unterstützt
Aufgabenwarteschlange	Aufgaben in der Warteschlange anzeigen, Aufgaben abbrechen	`list_tasks` / `cancel_task` usw.	`tasks` / `task`	Unterstützt
Zugriffskontrolle aktivieren	Manuelle Vorabprüfung durchführen	run_startup_gate	gate / startup-gate	Unterstützt
Momentaufnahme der Abstimmung	Die Abstimmungs-JSON-Datei wird zum Zeitpunkt des Abschlusses angezeigt usw.	`collect_broker_reconcile_snapshot`	`reconcile` / `snapshot-reconcile`	Unterstützt
Diagnostik während des Transports	Unterschiede zwischen lokalen und entfernten Bestellungen während des Transports (nur lesbar)	`collect_pending_order_diagnostics`	`run --task diagnose_pending_orders` (DEBUG)	Unterstützt
Logrotation	Abgelaufene CSV-Dateien/Risikoprotokolle manuell bereinigen	qt.rotate_trade_logs	`rotatelogs` / `rotate-logs`	Unterstützt
Broker-Sitzung	Prüfen Sie, ob die simulierte Brokerage-Plattform „verbunden“ ist.	`connect` / `disconnect` / `is_connected`	`Broker-Status\|Verbinden\|Trennen`	Unterstützt
Remote-Statussynchronisierung	Statusabfrage von realen Brokerfirmen (noch nicht implementiert)	(Reserviert für die API der Klasse sync_from_broker)	sync / pull-state	Reserviert
Hauptschleifen-Lebenszyklus	Skript-/Notebook-Seite starten/stoppen	`start` / `run` / `join`	—	Nur für Bediener/Notebook

Dashboard und interaktive Modi

Beim Start befindet sich das Programm standardmäßig im Dashboard-Modus: Das Terminal zeigt unten eine einzelne Zeile mit dem Countdown bis zur nächsten Aufgabe, den überwachten Kursen und Systemmeldungen an; die Hauptschleife des Traders läuft im Hintergrund weiter. Drücken Sie Strg+C, um den Modus zu wechseln oder das Programm zu beenden.

1 — Wechseln Sie in den interaktiven (Befehls-)Modus, indem Sie buy, config, artifacts usw. eingeben.
2 — Zurück zum Dashboard
3 — Shell verlassen und Trader stoppen

Wenn innerhalb von 5 Sekunden keine Eingabe erfolgt, wird das System automatisch aus dem Modus vor der Unterbrechung fortgesetzt. Während der Wartezeit im Menü können Sie durch erneutes Drücken von Strg+C das Menü sofort verlassen. Mit dem Befehl „dashboard“ gelangen Sie zurück zum Dashboard. Tritt in der Hauptschleife eine unerwartete Ausnahme auf, kehrt das System standardmäßig nach 5 Sekunden zum Dashboard zurück (drücken Sie 3, um das System zu verlassen).

DEBUG `run --task` Whitelist

Nur im DEBUG-Modus kann es manuell über run –task TASK ausgelöst werden (entweder beim Start mit –debug oder innerhalb der Shell mit debug):

process_result
pre_open / open_market / close_market / post_close
refill (Argumente, die über –args übergeben werden)
diagnose_pending_orders

Broker-Unterbefehl

broker status — Gibt Brokernamen, Verbindungsstatus usw. aus.
broker connect — Stellt eine Sitzung der Anpassungsschicht her (Simulator ist ein Flag).
broker disconnect – die Sitzung trennen

Reserviert: sync

Die Funktionen sync oder pull-state führen zu einer Fehlermeldung, die darauf hinweist, dass sie noch nicht implementiert sind, zum Beispiel:

[NOT_IMPLEMENTED] sync_from_broker is reserved for QMT broker integration (S2.1-b).

Bedeutung: Die tatsächlichen „synchronisierten Bestände/Aufträge von Brokerfirmen“ wurden noch nicht integriert; das Erscheinen dieser Meldung ist ein erwartetes Verhalten und keine Fehlfunktion.