從來源檔名建商品,再核對下單大師接收設定
依序完成「匯入商品 → 商品整合 → 資金專案 → 商品映射 → 訊號檔接收」。先用隔離的練習資料夾確認每一段,再接收至模擬環境。
01 先準備命名一致的來源檔
先完成來源接線與貨幣設定。每個檔案都應可讀、符合六欄格式;建議檔名為 商品代碼_策略名稱.txt。以下只示範命名解析,不保證任何商品目前可交易。
| 來源檔名例子 | 自動建立的商品代碼 | 注意 |
|---|---|---|
| 2330_Trend01.txt | 2330 | 此步先建立數字商品代碼;不會自動變成股票期貨。 |
| DEMO_Trend01.txt、DEMO_Trend02.txt | DEMO | 兩個來源共用同商品,但來源 ID 不同。 |
| TWF.NVF HOT_Trend01.txt | NVF | 會去除報價命名中的 TWF. 與後段文字。 |
| NVF_Trend01.txt | NVF | 是否能補出股票期貨映射,要再查對照表。 |
空白、底線與連字號可被當作分段符號,避免把分段符號放進你想保留的商品代碼。中文檔名未必會被拒絕,但不能因此期待它一定對到期交所代碼;先以正式商品代碼命名較容易核對。
02 依檔名自動建立商品
- 按主畫面新增策略監控,開啟「新增策略來源」。
- 先選策略屬性分類與WFO 組別(選填)。沒有策略互斥需求就保留 WFO「未分類」。
- 勾依檔名自動建立商品。此時「商品代碼」欄停用,由檔名決定。
- 選好新商品的交易所代碼與計價貨幣代碼。本批若有不同交易所或貨幣,分批匯入。
- 按新增來源,選取這一批來源檔。系統在此時讀取內容並套用上面的設定,因此必須先設欄位再選檔。
- 檢查「策略來源匯入」結果,確認新增/更新策略數與略過檔案數符合預期。
- 按確認接受結果。若要放棄本次匯入與更新,按「取消」。
- 返回來源列表及商品設定,核對每個來源所屬商品、分類、貨幣與匯率,再完成商品整合設定。
| 結果 | 如何判讀 |
|---|---|
| 新增商品/既有商品 | 解析後找到既有商品會沿用;同商品多檔時,既有商品計數可重複累計,不等於不同商品總數。 |
| 新增策略來源/更新策略來源 | 以來源檔名辨識新舊;有更新時,檢查是否預期修改的那一筆。 |
| 略過檔案 | 可能是檔案讀取失敗、欄位不足、數字格式錯誤或無法取得名稱;不只是商品代碼問題。 |
新商品名稱與代碼先使用解析結果,報價自訂乘數與輸出部位加權起始為 1;匯率依所選貨幣帶入。既有商品主要沿用設定,空白欄位可能補上資料,匯率也會依貨幣更新,因此批次匯入後仍需核對。
03 先在資金專案確認商品,再做映射
自動建商品不會同時完成資金專案與下單大師設定。到資金管理專案核對商品分類、排序、動能門檻、數量與部位限制。商品是否進入專案列表,由監控時的條件決定。
「補齊映射」只處理這個專案目前商品列表中已有的商品。首次尚無商品時,可以保持外部輸出關閉,先做一次監控驗證,讓符合條件的商品進入列表;或直接在下單大師設定中用「新增映射」手動填入所需商品。
- 打開該資金專案,按訊號輸出設定。
- 在「檔案輸出目錄」按新增路徑,設定練習目錄,例如
D:\QBPractice\OrderMaster\ProjectA。 - 按下單大師設定,進入「下單大師訊號輸出設定」。先完成路徑、類型與映射核對,再勾啟用。
「啟用檔案輸出」控制一般商品 TXT;「啟用下單大師 Order 訊號檔輸出」控制本章 Order 訊號,兩者是獨立開關,但可使用同一組輸出目錄。測試 Order 訊號不必為此再啟用一般 TXT 輸出。
04 設定路徑與輪替檔名
| 欄位 | 如何設定與核對 |
|---|---|
| 啟用下單大師 Order 訊號檔輸出 | 本專案的下單大師輸出開關。第一次先關閉,完成映射與接收端設定後再啟用測試。 |
| 商品模式 | 選「股票」或「期貨/股期」。每筆映射可用「類型」覆蓋專案預設。 |
| 訊號檔名 | 只填 OrderMasterSignal.txt 時,寫入每個已設定輸出目錄;填完整路徑時,直接使用該路徑。 |
| 間隔(ms) | 控制輸出節奏;低於 1000 的設定仍以至少 1000 ms 處理。接收端需跟得上更新速度。 |
| 輪替檔數 | 可填 1~1024 整數。1 使用單一檔;大於 1 會依序輪流寫入帶編號的檔案。依接收端能力與訊號量規劃,不要只改 QB 這一邊。 |
| 股票種類/上市櫃/新倉平倉 | 依下單大師所要求的格式碼填寫;畫面常見值 A、Y、A 不是任意商品皆適用的保證,請對照接收端設定。 |
輪替檔數會改變你實際要監控的檔案
| 基礎檔名 | 輪替檔數 | 下單大師應監控 |
|---|---|---|
| OrderMasterSignal.txt | 1 | OrderMasterSignal.txt |
| OrderMasterSignal.txt | 3 | OrderMasterSignal_1.txt、OrderMasterSignal_2.txt、OrderMasterSignal_3.txt |
編號是輪流使用的位置,不是每個商品固定占一檔。從單檔改輪替或改回單檔時,畫面會要求確認;原檔可能仍留在資料夾,但不再更新。務必同步修改下單大師監控清單。
不同專案使用不同目錄或基礎檔名,例如 ProjectA 與 ProjectB 各一個子資料夾。多商品連續變化時,單檔可能在接收端讀取前已被覆蓋;輪替可增加讀取空間,但仍需用模擬接收紀錄確認沒有漏訊號。
05 建立商品映射,逐列確認商品與月份
股票直接交易
專案選「股票」,以「新增映射」逐列填入來源代碼、OM名稱、OM代碼與股票格式欄位。純股票代號不需要轉股票期貨;不要為了補表而勾選轉股期後直接接受結果。
股票代號或期貨報價代碼要對應股票期貨
- 按更新期交所取得股期對照,等待成功提示。
- 來源是股票代號、目的確實為股票期貨時,勾股票代號轉股票期貨。此欄在開啟視窗時預設勾選,應每次核對。
- 選「股期類型」,再按補齊映射。
- 核對每列來源代碼、OM名稱、OM代碼、類型與月份,以及未匹配數量。
- 按套用並離開,再完成外層訊號輸出設定的套用。
| 股期類型 | 意義 |
|---|---|
| 標準優先/小型優先 | 兩種都有時優先選指定規格;只有另一種可用時可能使用另一種。 |
| 只用標準/只用小型 | 只接受指定規格;對不到時不會改用另一規格。 |
已是明確期貨代碼的來源,應以該代碼核對實際規格;不要預期改「優先」選項就必然換成另一種合約。轉換的是商品識別資料,不會自動把股票股數換算成股期口數;口數、點值與合約規格仍要在上游逐層核對。
| 映射欄位 | 用途與注意 |
|---|---|
| 來源代碼/來源名稱 | 對應 QuantBrains 商品。以代碼匹配最容易核對;避免重複且互相矛盾的映射列。 |
| 類型 | 「跟隨專案」沿用預設;「股票」或「期貨/股期」覆蓋預設。 |
| OM名稱/OM代碼 | 接收端實際交易的商品識別。 |
| 月份 | 期貨可填 yyyy/MM,例如 2026/10 是格式例子。留白時使用商品的當前月份;手填後要自行維護。 |
| 股票種類/上市櫃/新平倉 | 個別商品的格式碼;留白時沿用專案值。 |
| 啟用 | 是否使用此列轉換。取消此勾選不等於停止該商品輸出,系統仍可能使用原商品名稱、代碼與專案預設。 |
期交所對照是平台共用;下單大師映射屬於個別資金專案。新專案、新進入列表的商品,要在對應專案重新補齊或新增。
06 用模擬接收確認訊號的真正含義
下單大師端依畫面提示設定Order_訊號時間變動下單/由訊號決定商品,監控本章確認的完整檔名清單。接收端版本的具體選單位置請依其手冊操作。
- 使用隔離測試目錄,先查看輸出內容,確認商品、月份、價格與數量。
- 把接收端連到模擬環境,核對它監控全部輪替檔。
- 在已驗證的練習流程中觀察一筆部位變化,對照專案操作紀錄、輸出檔和接收紀錄。
- 再測試減少部位、回到空手,以及不同商品接連變動的情況。
- 結束時停用測試輸出並保存設定,保留測試結果供核對。
股票格式:
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;是否填了完整路徑而非輸出目錄。 |
| 檔案沒有更新 | 專案和主監控、輸出啟用、路徑權限、部位是否真的變化,以及是否有保存失敗提示。 |
| 下單大師沒收到 | 模式是否為由訊號決定商品、全部輪替路徑是否正確、接收端是否正在讀取、時間欄與前次是否不同。 |
| 商品或月份錯誤 | 檢查映射啟用、來源匹配、類型覆寫和手填月份;商品對照不會替你完成換月維護。 |
| 期交所更新失敗 | 檢查網路,稍後重試;或以「新增映射」手動輸入已核對的商品資料。 |
| 程式恢復後出現待處理訊號 | 先對照接收端紀錄與目前部位,再處理畫面提示;不要為了讓檔案更新而反覆重啟或手改訊號時間。 |