2. 模擬實盤交易——CLI 功能清單

本文從命令與能力清單角度說明 CLI 中的模擬實盤功能。 如需按步驟操作，請閱讀 tutorials/8-live-trade-risk-and-broker-walkthrough.md。

2.1. 0. 文档边界

• 本頁是命令能力索引，不是逐步教程

• 重點回答“有什麼命令、看什麼反饋、跳到哪裏排查”

2.2. 1. 命令能力分组

• 運行控制：啓動、暫停、恢復、結束

• 交易操作：買入、賣出、撤單

• 狀態查詢：訂單、成交、持倉、賬戶

• 診斷與日誌：系統消息、錯誤提示、任務狀態

2.3. 2. 核心反馈语义

• 拒單時可看到英文摘要（含 rule_id / reason）

• 分批成交狀態更容易在查詢結果中識別

• 收盤後處理行爲通過統一 Broker API 協調

2.4. 2.1 手工下單的訂單類型語義（buy/sell）

• buy/sell ... -p 正數：按限價單提交（order_type='limit'）

• buy/sell ...（不帶 -p）或 -p 0：按市價單提交（order_type='market'），CLI 會在下單前使用最新實時價補齊價格字段

在 SimulatorBroker 中，撮合判定的關鍵差異如下：

訂單類型	主要成交條件（簡化）
limit 限價單	賣單：實時價 >= 掛賣價（含偏差）；買單：實時價 <= 掛買價（含偏差）
market 市價單	實時漲跌幅位於非漲跌停區間時優先按市價撮合；若接近漲跌停，成交概率顯著下降

示例（用戶可見反饋）：

Order rejected by risk rule [MAX_ORDER_QTY]: order quantity exceeds limit

2.5. 3. 快速问题分流（CLI 视角）

• 下單後沒有訂單記錄：優先檢查風控拒單提示

• 有訂單但無成交：檢查 broker 回報與行情條件

• 狀態長時間不變：檢查回報是否持續到達

2.6. 4. 命令-文档映射

關注點	先看哪裏
運行是否配置正確	live_trading/2-configuration-and-run.md
訂單爲何被拒或未成交	live_trading/3-risk-and-order-lifecycle.md
日誌如何排查	live_trading/5-artifacts-and-troubleshooting.md
完整實操路徑	tutorials/8-live-trade-risk-and-broker-walkthrough.md

2.7. 5. 跳转导航

• 機制說明：live_trading/3-risk-and-order-lifecycle.md

• 排錯手冊：live_trading/5-artifacts-and-troubleshooting.md

• API 参考：api/api_reference.rst