CLI 與 Trader 能力對照表

親愛的用戶，本章彙總 Trader Shell**（命令行界面）裏有哪些命令、分別解決什麼問題。Shell 裏 help 與即時輸出爲**英文；下表說明爲中文。

> 如何進入 Shell > qt.run(op, mode=0, ...) 且 live_trade_ui_type='cli'，或運行示例時加 --ui cli。進入後您可在提示符下輸入命令，像與交易員對話。

適用範圍

  • 進入方式：qt.run(op, mode=0, ...) 且 live_trade_ui_type='cli'``（或示例 ``--ui cli）

  • DEBUG 模式：run --task ... 及若干調試任務僅在 Trader debug=True 時可用（啓動加 --debug，或 Shell 內 debug 命令切換）

  • 用戶可見 help / 輸出爲 英文；本文檔說明爲中文

命令別名

Trader Shell 支持**短別名**，便於少打字。別名在 qteasy 內部 rewrite 爲正式命令名後再執行——help 與日誌仍以正式名爲準。下表僅列運維相關別名；完整命令面見後文「能力對照表」。

各列含義：**您輸入的別名**爲 Shell 接受的寫法；**內部命令**爲實際調用的 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 公有能力 與 Shell 命令 的主索引：左側是「qteasy 能做什麼」，中間是「您該輸入什麼」，右側是「當前版本是否已實現」。在 live 子系統中，CLI 是運維與冒煙的主入口之一；API 列供您在 Notebook 或腳本中調用同一能力。

各列含義：

  • 能力：Trader/Broker 側功能域

  • 典型用途：您何時需要用它（排錯場景）

  • 綁定 API（摘要）：Python 側入口（非完整簽名）

  • CLI 命令：Shell 中名稱；— 表示無直接 CLI

  • 狀態：已支持 / ``預留``（尚未實現）

如何使用：按「典型用途」找行——例如要找日誌目錄 → 找「查日誌文件落在哪」→ 用 artifacts。狀態爲 預留 時勿當作故障（如 sync）。

示例：啓動後想覈對 live 配置 → 典型用途「覈對當前 live 配置是否生效」→ 命令 liveconfig 或 live-config。

能力

典型用途

綁定 API（摘要）

CLI 命令

狀態

狀態 / 暫停 / 退出

看是否在跑、暫停/恢復、退出 Shell

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

已支持

Live 配置摘要

覈對當前 live 配置是否生效

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

已支持

在途單診斷

本地 vs 遠端在途單差異（只讀）

collect_pending_order_diagnostics

``run –task diagnose_pending_orders``（DEBUG）

已支持

日誌輪換

手動清理過期 CSV / risk 日誌

qt.rotate_trade_logs

rotatelogs / rotate-logs

已支持

Broker 會話

看模擬券商是否「已連接」

connect / disconnect / is_connected

broker status|connect|disconnect

已支持

遠端狀態同步

從真實券商拉狀態（尚未實現）

（預留 sync_from_broker 類 API）

sync / pull-state

預留

主循環生命週期

腳本/Notebook 側啓停

start / run / join

—

僅 Operator / Notebook

Dashboard 與 interactive 模式

啓動後默認進入 dashboard 模式：終端底部單行顯示下一任務倒計時、監視價與系統消息；Trader 主循環在後臺繼續運行。按 Ctrl+C 可切換模式或退出：

  • 1 — 進入 interactive（命令）模式，輸入 buy、config、artifacts 等

  • 2 — 回到 dashboard

  • 3 — 退出 Shell 並停止 Trader

5 秒內無輸入**自動恢復中斷前的模式；選單等待期間**再次按 Ctrl+C 立即退出。在命令模式下輸入 dashboard 可返回 dashboard。主循環若遇未預期異常，默認 5 秒**後回到 dashboard（按 **3 可退出）。

DEBUG run --task 白名單

僅在 DEBUG 模式下可通過 run --task TASK 手動觸發（啓動時 --debug 或 Shell 內 debug）：

  • process_result

  • pre_open / open_market / close_market / post_close

  • refill``（參數經 ``--args 傳入）

  • diagnose_pending_orders

Broker 子命令

  • broker status — 列印券商名、連接狀態等

  • broker connect — 建立適配層會話（simulator 爲標誌位）

  • broker disconnect — 斷開會話

預留：sync

sync / pull-state 執行時會提示尚未實現，例如：

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

含義：真實「從券商同步持倉/訂單」尚未接入；看到此提示是預期行爲，不是故障。

相關文檔