核心流程 · 批次匯入與下單大師

從來源檔名建商品,再核對下單大師接收設定

依序完成「匯入商品 → 商品整合 → 資金專案 → 商品映射 → 訊號檔接收」。先用隔離的練習資料夾確認每一段,再接收至模擬環境。

適合多商品來源映射與訊號分開驗證

01 先準備命名一致的來源檔

先完成來源接線與貨幣設定。每個檔案都應可讀、符合六欄格式;建議檔名為 商品代碼_策略名稱.txt。以下只示範命名解析,不保證任何商品目前可交易。

來源檔名例子自動建立的商品代碼注意
2330_Trend01.txt2330此步先建立數字商品代碼;不會自動變成股票期貨。
DEMO_Trend01.txt、DEMO_Trend02.txtDEMO兩個來源共用同商品,但來源 ID 不同。
TWF.NVF HOT_Trend01.txtNVF會去除報價命名中的 TWF. 與後段文字。
NVF_Trend01.txtNVF是否能補出股票期貨映射,要再查對照表。

空白、底線與連字號可被當作分段符號,避免把分段符號放進你想保留的商品代碼。中文檔名未必會被拒絕,但不能因此期待它一定對到期交所代碼;先以正式商品代碼命名較容易核對。

來源名稱必須唯一平台用不含副檔名的檔名辨識來源,不以資料夾區分。再次匯入同名來源會更新它的路徑、商品、策略分類與 WFO,不會新增另一個來源。大量處理前先建立備份,並用少量檔案演練。

02 依檔名自動建立商品

  1. 按主畫面新增策略監控,開啟「新增策略來源」。
  2. 先選策略屬性分類與WFO 組別(選填)。沒有策略互斥需求就保留 WFO「未分類」。
  3. 勾依檔名自動建立商品。此時「商品代碼」欄停用,由檔名決定。
  4. 選好新商品的交易所代碼與計價貨幣代碼。本批若有不同交易所或貨幣,分批匯入。
  5. 按新增來源,選取這一批來源檔。系統在此時讀取內容並套用上面的設定,因此必須先設欄位再選檔。
  6. 檢查「策略來源匯入」結果,確認新增/更新策略數與略過檔案數符合預期。
  7. 按確認接受結果。若要放棄本次匯入與更新,按「取消」。
  8. 返回來源列表及商品設定,核對每個來源所屬商品、分類、貨幣與匯率,再完成商品整合設定。
結果如何判讀
新增商品/既有商品解析後找到既有商品會沿用;同商品多檔時,既有商品計數可重複累計,不等於不同商品總數。
新增策略來源/更新策略來源以來源檔名辨識新舊;有更新時,檢查是否預期修改的那一筆。
略過檔案可能是檔案讀取失敗、欄位不足、數字格式錯誤或無法取得名稱;不只是商品代碼問題。

新商品名稱與代碼先使用解析結果,報價自訂乘數與輸出部位加權起始為 1;匯率依所選貨幣帶入。既有商品主要沿用設定,空白欄位可能補上資料,匯率也會依貨幣更新,因此批次匯入後仍需核對。

03 先在資金專案確認商品,再做映射

自動建商品不會同時完成資金專案與下單大師設定。到資金管理專案核對商品分類、排序、動能門檻、數量與部位限制。商品是否進入專案列表,由監控時的條件決定。

「補齊映射」只處理這個專案目前商品列表中已有的商品。首次尚無商品時,可以保持外部輸出關閉,先做一次監控驗證,讓符合條件的商品進入列表;或直接在下單大師設定中用「新增映射」手動填入所需商品。

  1. 打開該資金專案,按訊號輸出設定。
  2. 在「檔案輸出目錄」按新增路徑,設定練習目錄,例如 D:\QBPractice\OrderMaster\ProjectA。
  3. 按下單大師設定,進入「下單大師訊號輸出設定」。先完成路徑、類型與映射核對,再勾啟用。

「啟用檔案輸出」控制一般商品 TXT;「啟用下單大師 Order 訊號檔輸出」控制本章 Order 訊號,兩者是獨立開關,但可使用同一組輸出目錄。測試 Order 訊號不必為此再啟用一般 TXT 輸出。

04 設定路徑與輪替檔名

欄位如何設定與核對
啟用下單大師 Order 訊號檔輸出本專案的下單大師輸出開關。第一次先關閉,完成映射與接收端設定後再啟用測試。
商品模式選「股票」或「期貨/股期」。每筆映射可用「類型」覆蓋專案預設。
訊號檔名只填 OrderMasterSignal.txt 時,寫入每個已設定輸出目錄;填完整路徑時,直接使用該路徑。
間隔(ms)控制輸出節奏;低於 1000 的設定仍以至少 1000 ms 處理。接收端需跟得上更新速度。
輪替檔數可填 1~1024 整數。1 使用單一檔;大於 1 會依序輪流寫入帶編號的檔案。依接收端能力與訊號量規劃,不要只改 QB 這一邊。
股票種類/上市櫃/新倉平倉依下單大師所要求的格式碼填寫;畫面常見值 A、Y、A 不是任意商品皆適用的保證,請對照接收端設定。

輪替檔數會改變你實際要監控的檔案

基礎檔名輪替檔數下單大師應監控
OrderMasterSignal.txt1OrderMasterSignal.txt
OrderMasterSignal.txt3OrderMasterSignal_1.txt、OrderMasterSignal_2.txt、OrderMasterSignal_3.txt

編號是輪流使用的位置,不是每個商品固定占一檔。從單檔改輪替或改回單檔時,畫面會要求確認;原檔可能仍留在資料夾,但不再更新。務必同步修改下單大師監控清單。

不同專案使用不同目錄或基礎檔名,例如 ProjectA 與 ProjectB 各一個子資料夾。多商品連續變化時,單檔可能在接收端讀取前已被覆蓋;輪替可增加讀取空間,但仍需用模擬接收紀錄確認沒有漏訊號。

05 建立商品映射,逐列確認商品與月份

股票直接交易

專案選「股票」,以「新增映射」逐列填入來源代碼、OM名稱、OM代碼與股票格式欄位。純股票代號不需要轉股票期貨;不要為了補表而勾選轉股期後直接接受結果。

股票代號或期貨報價代碼要對應股票期貨

  1. 按更新期交所取得股期對照,等待成功提示。
  2. 來源是股票代號、目的確實為股票期貨時,勾股票代號轉股票期貨。此欄在開啟視窗時預設勾選,應每次核對。
  3. 選「股期類型」,再按補齊映射。
  4. 核對每列來源代碼、OM名稱、OM代碼、類型與月份,以及未匹配數量。
  5. 按套用並離開,再完成外層訊號輸出設定的套用。
股期類型意義
標準優先/小型優先兩種都有時優先選指定規格;只有另一種可用時可能使用另一種。
只用標準/只用小型只接受指定規格;對不到時不會改用另一規格。

已是明確期貨代碼的來源,應以該代碼核對實際規格;不要預期改「優先」選項就必然換成另一種合約。轉換的是商品識別資料,不會自動把股票股數換算成股期口數;口數、點值與合約規格仍要在上游逐層核對。

映射欄位用途與注意
來源代碼/來源名稱對應 QuantBrains 商品。以代碼匹配最容易核對;避免重複且互相矛盾的映射列。
類型「跟隨專案」沿用預設;「股票」或「期貨/股期」覆蓋預設。
OM名稱/OM代碼接收端實際交易的商品識別。
月份期貨可填 yyyy/MM,例如 2026/10 是格式例子。留白時使用商品的當前月份;手填後要自行維護。
股票種類/上市櫃/新平倉個別商品的格式碼;留白時沿用專案值。
啟用是否使用此列轉換。取消此勾選不等於停止該商品輸出,系統仍可能使用原商品名稱、代碼與專案預設。
補齊後仍要逐列檢查補齊會保留既有非空的文字欄位,但會把找到的映射重新設為啟用。若要停用整個下單大師輸出,使用專案上方輸出開關;若要排除個別商品,應回資金專案調整納入規則。不要把「關閉」當作必然撤銷映射表的所有編輯。

期交所對照是平台共用;下單大師映射屬於個別資金專案。新專案、新進入列表的商品,要在對應專案重新補齊或新增。

06 用模擬接收確認訊號的真正含義

下單大師端依畫面提示設定Order_訊號時間變動下單/由訊號決定商品,監控本章確認的完整檔名清單。接收端版本的具體選單位置請依其手冊操作。

  1. 使用隔離測試目錄,先查看輸出內容,確認商品、月份、價格與數量。
  2. 把接收端連到模擬環境,核對它監控全部輪替檔。
  3. 在已驗證的練習流程中觀察一筆部位變化,對照專案操作紀錄、輸出檔和接收紀錄。
  4. 再測試減少部位、回到空手,以及不同商品接連變動的情況。
  5. 結束時停用測試輸出並保存設定,保留測試結果供核對。

股票格式:

OM名稱,OM代碼,股票種類,上市櫃#yyyy/MM/dd HH:mm:ss,增減數量,價格

期貨/股期格式:

OM名稱,OM代碼,月份,新倉平倉#yyyy/MM/dd HH:mm:ss,增減數量,價格
專案部位變化訊號增減數量
0 → 2+2
2 → 1-1
-2 → 0+2

Order 訊號傳的是本次變化量,不是目標總部位;數量單位與買賣解讀要與接收端模式一致。沒有部位變化時,不應期待檔案只因報價跳動就一直更新。訊號檔也不是完整歷史清單,檔案寫出成功不代表委託成交。

07 常見問題與完成判斷

問題先檢查
補齊映射沒有新增專案目前商品列表是否有商品、期交所對照是否成功、股票轉股期選項與規格是否適合、是否已有非空映射。
找不到基礎檔名輪替檔數是否大於 1;實際檔名是否為 _1~_N;是否填了完整路徑而非輸出目錄。
檔案沒有更新專案和主監控、輸出啟用、路徑權限、部位是否真的變化,以及是否有保存失敗提示。
下單大師沒收到模式是否為由訊號決定商品、全部輪替路徑是否正確、接收端是否正在讀取、時間欄與前次是否不同。
商品或月份錯誤檢查映射啟用、來源匹配、類型覆寫和手填月份;商品對照不會替你完成換月維護。
期交所更新失敗檢查網路,稍後重試;或以「新增映射」手動輸入已核對的商品資料。
程式恢復後出現待處理訊號先對照接收端紀錄與目前部位,再處理畫面提示;不要為了讓檔案更新而反覆重啟或手改訊號時間。
本章完成來源商品、專案建議部位、映射商品、實際訊號檔名及模擬接收結果五者一致;增減方向與單位正確,多商品連續測試也沒有漏接。正式運作前再完成開盤前檢查清單。

相關操作