CLI と Trader の比較表

ユーザーの皆様、この章では、Trader シェル (コマンドラインインターフェイス) で使用できるコマンドと、それらのコマンドによって解決される問題について概要を説明します。シェルのヘルプとリアルタイム出力は英語です。下の表は中国語です。

シェルに入る方法 > live_trade_ui_type='cli' を指定して qt.run(op, mode=0, ...) を実行するか、サンプルの実行時に --ui cli を追加します。シェルに入ると、トレーダーと話しているかのようにプロンプトにコマンドを入力できます。

適用範囲

入力方法: qt.run(op, mode=0, ...) and live_trade_ui_type='cli' (or example ``--ui cli`)
デバッグモード: run --task ... およびいくつかのデバッグタスクは、Trader が debug=True に設定されている場合にのみ使用できます (--debug で開始するか、シェルで debug コマンドを使用して切り替えます)。
ヘルプ出力は英語でユーザーに表示されます。ドキュメントは中国語です。

コマンドエイリアス

Trader シェルは 短いエイリアス をサポートし、入力を軽減します。エイリアスは、実行前に qteasy 内の正式なコマンド名に書き換えられます。ヘルプとログでは引き続き正式な名前が使用されます。以下の表には、運用と保守に関連する別名のみがリストされています。コマンドの詳細については、後述の「機能比較表」を参照してください。

各列の意味: 入力したエイリアスは、シェルによって受け入れられる形式です。内部コマンドは、呼び出される do_* プロセッサの実際の名前です。

使用方法: ハイフン表記を使用する場合は、左の列を調べます。スクリプトまたはドキュメント内で正式な名前を参照する場合は、右側の列を使用します。たとえば、デバッグドキュメントで ``gate` が使用されている場合、``startup-gate` と入力することもできます。

例: ログのパスを確認する場合、ls-artifacts を入力すると、artifacts と同じ効果があります。

入力したエイリアス	内部コマンド
ls-artifacts	artifacts
live-config	liveconfig
startup-gate	gate
`snapshot-reconcile`	reconcile
rotate-logs	rotatelogs
pull-state	sync

能力比較表

この表は、Trader/Broker パブリック機能 と シェルコマンド の主要なインデックスです。左側は「qteasy でできること」、中央は「入力すべき内容」、右側は「現在のバージョンに実装されているか?」を示しています。ライブサブシステムでは、CLI は操作とスモークの主要なエントリポイントの 1 つです。 API 列を使用すると、ノートブックまたはスクリプトで同じ機能を呼び出すことができます。

各列の意味:

機能: Trader/ブローカー側の機能ドメイン
典型的な使用例: いつ使用する必要がありますか (トラブルシューティングシナリオ)?
バインディング API (概要): Python サイドエントリポイント (不完全な署名)
CLI コマンド: シェル名。 -- は、直接 CLI コマンドがないことを示します。
ステータス: Supported / Reserved (未実装)

使用方法: 「一般的な使用法」で検索します。たとえば、ログディレクトリを見つける場合は、「ログファイルの場所」を検索し、artifacts を使用します。 reserved のステータスを障害として扱わないでください (例: sync)。

例: 起動後にライブ構成を確認する場合 → 典型的な使用例: 「現在のライブ構成が有効かどうかを確認する」 → コマンド liveconfig または live-config。

容量	典型的な使用例	API バインディング (概要)	CLIコマンド	状態
ステータス / 一時停止 / 終了	実行中か、一時停止/再開中か、シェルを終了しているかを確認します。	`status`, `pause`, `resume`, ``stop``など	`status` `pause` `resume` `bye` …	サポートされています
手動注文/注文キャンセル	手動による注文のテストまたはキャンセル	`submit_trade_order`, `cancel`	`buy` `sell` `cancel ORDER_ID`	サポートされています
読み取り/書き込みを構成する	実行コンフィギュレーションを表示または変更する	`get_config` / `update_config`	config	サポートされています
ディスクアーティファクトのパス	ログファイルの場所を見つける	`qt.list_live_trade_artifacts`	`artifacts` / `ls-artifacts`	サポートされています
ライブ構成の概要	現在のライブ構成が有効かどうかを確認してください。	`build_live_trade_config` → `to_summary_dict`	`liveconfig` / `live-config`	サポートされています
タスクキュー	キューに入れられたタスクの表示、タスクのキャンセル	`list_tasks` / ``cancel_task``など	`tasks` / `task`	サポートされています
アクセス制御を有効にする	市場前チェックを手動で実行します	run_startup_gate	gate / startup-gate	サポートされています
調整スナップショット	閉店時間などに調整JSONを表示します。	`collect_broker_reconcile_snapshot`	`reconcile` / `snapshot-reconcile`	サポートされています
輸送中の診断	ローカルとリモートの輸送中の注文の違い (読み取り専用)	`collect_pending_order_diagnostics`	`run --task diagnose_pending_orders` (DEBUG)	サポートされています
ログローテーション	期限切れの CSV/リスクログを手動でクリーンアップします	qt.rotate_trade_logs	`rotatelogs` / `rotate-logs`	サポートされています
ブローカーセッション	シミュレートされた仲介業者が「接続」されているかどうかを確認します。	Implement connect / disconnect / is_connected	`broker status\|connect\|disconnect`	サポートされています
リモートステータス同期	実在の証券会社からステータスを取得（未実装）	(sync_from_broker クラス API 用に予約されています)	sync / pull-state	予約済み
メインループのライフサイクル	スクリプト/ノートブック側の開始/停止	`start` / `run` / `join`	—	Operator/ノートブックのみ

7.1 ダッシュボードと対話モード

起動すると、デフォルトでダッシュボードモード**になります。ターミナルの下部に、次のタスクまでのカウントダウン、監視されている価格、およびシステムメッセージを示す 1 行が表示されます。 Trader メインループはバックグラウンドで実行され続けます。 **Ctrl+C を押してモードを切り替えるか、終了します。

1 — buy、config、artifacts などを入力して対話型 (コマンド) モードに入ります。
2 — ダッシュボードに戻る
3 — シェルを終了し、Trader を停止します

** 5 秒以内に入力が受信されない場合、システムは中断前のモードから自動的に再開します。メニューの待機中に Ctrl+C をもう一度押す**とすぐに終了します。コマンドモードで「`dashboard`」と入力すると、ダッシュボードに戻ります。メインループで予期しない例外が発生した場合、デフォルトでは **5 秒**後にダッシュボードに戻ります (**3 を押して終了します)。

デバッグ `run --task` ホワイトリスト

DEBUG モードでのみ、run --task TASK を介して手動でトリガーできます (--debug を使用した起動時、または debug を使用したシェル内)。

process_result
pre_open / open_market / close_market / post_close
refill (--args 経由で渡される引数)
diagnose_pending_orders

ブローカーのサブコマンド

broker status — ブローカー名、接続ステータスなどを出力します。
broker connect — アダプテーション層セッションを確立します (シミュレーターはフラグです)。
broker disconnect — セッションを切断します

予約済み: 同期

sync または pull-state 関数は、それらがまだ実装されていないことを示すエラーを表示します。次に例を示します。

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

意味: 実際の「証券会社からの同期保有/注文」はまだ統合されていません。このメッセージが表示されるのは予期された動作であり、誤動作ではありません。