搜尋、下載資料,再匯出給回測工具
從 QuantBrains 開啟資料下載 Client,選商品、價格模式與資料期間,完成下載後匯出給 MultiCharts 或 AI。第一次先練習一個商品,確認檔案可以開啟,再擴大到多個商品。
01 從 QuantBrains 開啟 Client
打開「資料下載中心」
在 QuantBrains 左側選「資料下載中心」。確認「平台授權」為通過、「Client 檔案」為已就緒;按「重新整理狀態」可重查授權、執行狀態與 Server 連線。Server 就是提供資料的遠端服務。
按「啟動資料下載 Client」
會另外開啟 Data Center Client 視窗,並沿用 QuantBrains 授權,不需另外輸入會員姓名或 Control API Key。若 Client 已在執行,可先使用既有視窗;需要重新繼承平台授權時,先關閉既有 Client,再由 QuantBrains 啟動。
確認連線與下載位置
在 Client 按「檢查連線」。到「連線與授權」確認 Server Base URL 與下載資料夾,調整後儲存。連線網址使用完整發布包的預設值或管理員提供的 HTTPS 網址;下載資料夾選有足夠空間、目前 Windows 帳號可寫入的位置。
Client 主畫面可以顯示授權狀態並載入商品清單。QuantBrains 啟動器顯示「未啟用(尚無 Client 設定檔)」時,先啟動 Client 完成第一次設定;不代表一定無授權。
按 QuantBrains 的「開啟下載資料夾」,會開啟 Client 設定的目錄;尚未設定時使用「我的文件」下的 DataCenter。Client 開啟後獨立運作,關閉 QuantBrains 本頁或主程式不會中斷 Client 的下載。
平台授權通過,Client 卻顯示尚未核准或裝置不符
先關閉 Client,再從 QuantBrains 開啟一次。若仍顯示授權未登記、尚未核准或硬體不符,保存錯誤文字,請管理員核對授權登記與目前電腦。平台授權通過與資料服務的裝置核准需要分別確認。不要改用其他人的授權,也不需把完整金鑰貼到 AI 對話。
02 認識畫面上常用的位置
| 位置 | 什麼時候使用 |
|---|---|
| 資料下載中心 → 快速下載 | 挑選已備妥的固定版本。第一次下載從這裡開始。 |
| 資料下載中心 → 全部商品 | 快速下載找不到,或要按條件準備資料時使用。系統可能需要先確認來源與建構資料。 |
| 我的商品庫 | 查看自己加入或下載的商品;選商品後按「資料與匯出」。 |
| 建構規則 | 查看 Auto 建議規則,或儲存自己的期貨換月規則。 |
| 背景處理 | 查看 ZIP 下載後的解壓、驗證與本機匯入,暫停、停止或重試。 |
| 上方工作列 → 工作診斷 | 查看遠端資料準備的排隊、執行、完成或失敗原因。 |
| AI Agent 對接 | 查看隨附 AI 連接工具是否就緒、最近連線與活動。 |
清單太小,或下方按鈕看不到
可拖曳搜尋區、商品庫與「下載進度與結果」之間的分隔線調整大小。按「放大商品庫」可集中看長清單,再按「返回搜尋」回到下載畫面;按「還原版面」恢復預設配置。窄視窗會改成上下排列,可捲動查看。切換版面會保留目前搜尋與勾選。
03 第一次下載:先選一個商品
- 將建構規則設為 Auto(建議)。位置在搜尋區上方。先使用預設規則,完成整個流程後再研究自訂。
- 開啟「快速下載」。用「全部/期貨/台灣股票/指數」及交易所篩選。預設顯示期貨;找不到時先選「全部」並清除交易所條件。
- 輸入商品代號或名稱。例如輸入
2330查台積電股票,或YM/小道瓊查期貨。核對商品類型與交易所,股票和同名股票期貨是不同商品。 - 勾選需要的價格模式。同一商品的「未調整」與「調整後」可能分成不同列。尚不清楚怎麼選,先看下一節的用途表。
- 查看起訖日、資料截止與處理日期。所需回測期間應落在實際涵蓋範圍內。「處理日期」較新,不表示行情一定包含今天。
- 確認儲存方式。想在 Client 查詢、匯出或交給 AI,先選「分析資料庫」;同時要保留 CSV 時,選「分析資料庫 + CSV」。下載位置可在連線設定確認。
- 按「下載選取商品」。快速下載會取得列上顯示的固定版本。等到「資料可使用」,再到「我的商品庫」核對本機資料,最後匯出。
切換「快速下載/全部商品」會清除勾選,請重新核對選取。第一次輸入關鍵字時可跨分類搜尋;手動選過分類後,會依您選定的分類搜尋。也可用 2330-TAI、TXF-TIX 這類完整代號。畫面與檔名可能省略後綴,仍要一起核對交易所。
快速下載沒有我要的商品
- 切到「全部商品」,保留或重輸入關鍵字,選正確的商品與交易所。
- 在資料設定選日期範圍、未調整/調整後及儲存方式;日期先用一段已結束的歷史期間,例如 2024-01-01 至 2025-12-31。這是練習範例,能否涵蓋仍以回應為準。
- 按同一個「下載選取商品」。有可用資料會先重用;缺少時,支援的商品會自動確認來源與合約、準備並驗證資料後接續下載,無需另找「準備資料」按鈕。
- 第一次可能需要較久。查看原工作的進度;若實際日期比要求短,改用可用範圍或聯絡管理員確認,不能把要求日期當成已完成範圍。
系統支援自動確認的商品,按下載後會先進入來源確認;如果畫面明確不允許下載,或回報資料不足、商品衝突、授權問題,就依提示交由管理員處理。看到商品名稱不代表所有年份均有資料,也不需要自己猜月份合約。
您能指出一個商品的類型、交易所、價格模式、實際資料範圍與下載位置,並在「本機可用資料」看到可匯出的資料列。
04 選價格模式、週期與期貨規則
| 選項 | 主要用途 | 使用時注意 |
|---|---|---|
| 股票:未調整 raw | 核對當時價格、成交價與費用。 | 除權息前後可能有價格落差;用於跨事件損益研究時,需另外處理股息與股數變化。 |
| 股票:調整後 adjusted/還權 | 研究較連續的價格走勢、指標與訊號。 | 不是當時可成交價格,也不等同股利再投入總報酬;不要再次還權。 |
| 期貨:未調整 raw | 查看接續前後的原始價格水準。 | 仍是接續的連續月資料,換月可能跳價;不能當作一張從頭持有到尾的實際合約。 |
| 期貨:Back Adjusted | 研究跨月價格趨勢與訊號。 | 已處理換月價差,歷史價格可能改變;不能直接當作實際成交價。 |
| 指數 | 觀察指數走勢。 | 提供未調整資料,不套用期貨換月或股票還權。 |
| 1 分鐘/日線 | 1 分鐘用於盤中研究,日線用於每日研究。 | 選符合策略需求的週期;Data Center 的時間是交易所當地時間。 |
想同時研究股票訊號與交易成本,可下載 raw 和 adjusted。兩者應分開保存與命名,使用時核對共同期間與時間對齊;不把兩種價格混到同一個 MultiCharts 商品。Client 的「回測使用說明」可查更完整的資料用途。
部分商品的較早歷史無法取得,Auto 可能提供最近一段通過驗證的連續資料。完成提示若顯示早期未涵蓋,回測就從實際起日開始;不要補造缺少的 K 棒或把無行情等同尚未掛牌。
需要比較換月方式時,再建立自訂規則
- 開啟「建構規則」,按「新增規則」,輸入清楚的名稱,例如「成交量交叉確認 2 日」。
- 選換月方式與參數。成交量交叉的確認天數可設 1–10 日;最後交易日、結算日、首次通知日(FND)的提前天數可設 0–60 日。
- 按「儲存規則」。看到「尚未儲存變更」表示還是草稿;只有儲存後才會供下載選用。「還原已存」會放棄目前草稿。
- 回到資料下載中心,在搜尋區上方選剛才的規則,再勾選期貨與日期,按「下載選取商品」。
- 完成後核對「自訂:規則名稱」及獨立資料目錄。比較兩組規則時,各自匯出並記下規則與版本。
「檢查期貨適用性」可先檢查商品條件;缺少合約日期時會無法建構。您仍可先儲存規則模板,但不代表每個商品都能使用。Auto 是唯讀預設,不能改名、刪除或覆寫;自訂規則可複製、改名及刪除。
混合下載股票、指數與期貨時,自訂接續規則只套用期貨。自訂結果獨立保存,不覆蓋 Auto,也不自動加入其他使用者的公共快速下載。規則不適用時請處理原原因,不要把另一組 Auto 資料當成同樣的自訂結果。
05 股票資料:下載後先看這些提示
股票「還權」會調整較早的歷史價格,減少除權息造成的落差。後來有新事件,舊日期的調整後價格也可能更新;要重現回測,請保存當次匯出的檔案與完整版本。成交量不隨還權價格改變。
在「資料與匯出」選股票後,查看下方的收盤定義、最後一日狀態、還權基準日與來源說明:
| 畫面提示 | 下一步 |
|---|---|
| 部分交易日 | 最後一天可能未收齊;先排除這一天的完成日訊號,待更新後重新確認。 |
| 時段已結束,完整性尚未驗證 | 不能因此判定全日行情或官方收盤已核對;依研究所需選擇已確認資料。 |
| 未提供驗證資訊 | 舊資料可能缺少說明。保留未知狀態,必要時向管理員確認或取得新版本。 |
目前日線 Close 取自最後取得的分鐘資料,尚未逐日核對官方收盤。若您的策略依賴官方收盤或完整交易日,先確認這項限制。檔案下載成功、名稱含 adjusted,都不能代替完整性檢查。
系統以台灣時間 14:00 作為當日參考資料確認門檻。盤中包含今天的調整後/雙模式要求,可能先提供前一日以前的已確認歷史;14:00 後仍須通過來源與資料驗證,不保證立即有當天成品。原始資料單獨下載不受這個還權門檻影響,仍以下載結果的實際截止為準。
使用 raw/adjusted 共同回測時,先核對日期時間與成交量能對應,保存各自的版本編號;兩者編號不必相同。不要在回測軟體再次打開價格自動調整,也不要因使用還權報酬而重複加入同筆股利。完整的成交與公司行動處理,交由符合該研究需求的回測工具完成。
06 確認完成,並分清楚停止範圍
| 看到的狀態 | 代表什麼 | 您要做什麼 |
|---|---|---|
| 排隊 queued/執行 running | 遠端服務還在準備資料。 | 在工作診斷追蹤原工作,不重複提交。 |
| 工作成功 succeeded | 遠端資料準備完成。 | 仍需確認 Client 的下載與本機處理。 |
| ZIP 已下載完成 | 壓縮檔已存好並完成完整性檢查。 | 可按「開啟 ZIP 位置」;等待背景解壓與匯入。 |
| 資料可使用/本機可匯出 | 所選儲存方式的本機資料已完成。 | 核對期間、模式、週期與列數,再匯出。 |
| 失敗 failed | 這一階段未完成。 | 查看處理紀錄,依錯誤修正,再重試未完成的項目。 |
解壓、驗證及匯入可能比下載更久。沒有可可靠計算的總量時,畫面只顯示目前階段與耗時,並非卡住。可按「查看處理紀錄」看最近進度;批次下載會分商品顯示結果,成功的商品不需重做。
要停止哪一件事?
| 動作 | 影響範圍 | 恢復方式 |
|---|---|---|
| 停止本次下載 | 停止目前前景下載/等待;未送出的商品不再送出。先前已排入的背景工作不受影響。 | 等「正在停止…」結束,再核對原工作及保留檔案後重試。 |
| 背景處理 → 停止這筆處理 | 停止選取商品的解壓或匯入,保留 ZIP。 | 排除問題後在背景處理手動重試;重開 Client 不自動續跑明確停止的項目。 |
| 暫停後續處理 | 稍後再處理後續背景項目。 | 回背景處理繼續。 |
| 工作診斷 → 取消選取 | 只針對目前仍可取消的遠端工作。 | 送出後等最終狀態;「取消中」尚未停止。 |
| 取消等待 | 停止自己等待共用更新。 | 稍後查原更新結果;不會終止其他使用者共用的處理。 |
關閉 Client 會結束目前本機下載或等待,保存未完成的背景項目;下次使用相同下載目錄可接續。遠端已接受的工作可能仍在進行,重開後先查原工作編號。
下載完成,但本機資料檔使用中或匯入失敗
Client 會短暫等待占用解除。仍失敗時,從處理紀錄確認檔案位置,關閉正在讀取該檔案的分析工具,檢查磁碟空間與目錄權限,再到背景處理重試該商品。ZIP 會保留,通常不必重新下載;若背景清單沒有項目,重新執行下載會先檢查能否沿用相同版本 ZIP。不要為本機檔案問題反覆要求遠端重建。
07 在商品庫查看與匯出
「我的商品庫」一個商品顯示一個主列,展開後可查看原始/調整模式與版本紀錄。股票、股票期貨及小型期貨仍分開。選商品後按「資料與匯出」,或雙擊、使用右鍵選單,會開啟相同視窗。
選本機可用的資料
在「本機可用資料」分頁選價格模式與週期,核對期間、完整版本及可用操作。背景處理剛完成時按「重新讀取」。只有標示可匯出的列才繼續。
選格式與輸出目錄
一般表格工具選「CSV(含欄位名稱)」;交給 MultiCharts 選「MultiCharts ASCII」。確認輸出目錄後按「匯出選取資料」。此入口匯出該列完整本機資料,保留原時間。
找到匯出的檔案
完成後記下列數與完整路徑,按「開啟匯出資料夾」。用檔案開頭、結尾確認日期與欄位,再依回測練習匯入 MultiCharts。
儲存方式與匯出格式不是同一件事
| 下載時的儲存方式 | 何時選用 |
|---|---|
| 分析資料庫 | 在 Client 查資料、交給 AI 或後續匯出。通常從這個選項開始即可。 |
| 分析資料庫 + CSV | 除了 Client 查詢,也要保留給舊工具使用的 CSV;會佔更多空間。 |
| 只保留 CSV | 主要搭配既有 CSV 工具。完成後可查看 CSV;AI 的本機分析清單可能不會列出尚未匯入的資料。 |
一般匯出檔預設在下載根目錄的 exports。ZIP 保存在商品資料夾的 packages;用「開啟資料夾」或「開啟 ZIP 位置」可找到,不必手動尋找內部分析檔案。
只匯出一段日期,或給 AI/Python 使用
- 在資料工作區選已下載的資料集列,開啟進階匯出面板。
- 選「Parquet(AI / Python)」或「MultiCharts ASCII」,設定日期與輸出目錄。
- 一般先保留原時間。只有您的匯入規則明確需要時,才勾選「Time shift +1 分鐘」。
- 匯出後核對實際起訖與列數。ASCII 檔名以
_ASCII.txt結尾,欄位依序為Date, Time, Open, High, Low, Close, TotalVolume。
已有可讀的本機資料時,匯出不需再連線遠端服務,也不需再下載。
下載記錄還在,為什麼不能匯出那個舊版本?
「下載記錄 / 版本」是歷史紀錄,不保證所有版本檔案都留在本機。同一資料目錄中的相同商品/模式/週期,使用目前啟用的本機版本。要使用舊版,在記錄按「重新下載此筆記錄」,或改選實際可用的版本;遠端已移除舊版時會顯示原因。移除商品庫記錄不會刪除已下載檔案。
自訂規則結果放在獨立資料目錄;請從該結果的「開啟商品資料夾」辨識,並核對規則名稱。保存回測時,另外保留匯出檔、完整版本及規則,不依賴清單永久保留舊版。
08 下次要更新資料時
- 先看目前資料截止。若已有版本涵蓋研究期間,可直接使用本機資料。
- 重新整理快速下載清單。已出現較新版本時,核對模式與截止日後下載。
- 需要的日期仍未涵蓋時,使用商品的進階更新操作。確認商品、日期與模式後送出要求,追蹤等待、處理、發布或失敗狀態。
- 完成後重新整理並下載新版本。更新要求被接受,不等於新資料已在本機;仍要等下載及本機處理完成。
- 另存研究紀錄。保留前次回測匯出檔,記下新版本和實際日期;還權與接續歷史可能因更新而改變。
在「全部商品」準備成功,快速下載還沒出現
一般 Auto 成品通過驗證後,仍要完成背景發布與打包才會加入共用清單。查看原結果的發布狀態,完成後重新整理「快速下載」,並清除類型/交易所篩選。若發布失敗,保存原工作與錯誤給管理員,不需重新建構同一批行情。
自訂規則、待人工確認或只有原始月份合約的結果,不會自動列入一般快速下載。其他人發布成功的商品可供已授權使用者搜尋下載,但不會自動加入您的「我的商品庫」。
09 選用:主程式的「合約轉換調整」
這是 QuantBrains 主程式內處理既有歷史文字檔的工具,適用於您已確認接點價格,想把一份舊資料移到指定價格基準,或調整報價小數點尺度的情境。它與 Client 的自訂換月規則是兩個入口;一般 Data Center 下載不必使用這個工具。
- 先保存原始檔。檔案應按日期時間排列,前七欄依序是日期、時間、開、高、低、收、成交量,以逗號分隔;成交量使用整數。
- 回 QuantBrains 主程式上方的「資料下載中心」功能區,按「合約轉換調整」,再按「匯入歷史資料」選檔。
- 確認畫面顯示匯入完成,檢查接受與略過筆數。表頭可能被略過,但資料列異常也會被略過;略過數超出預期時先檢查檔案。匯入失敗時先重新選正確檔案,不直接繼續調整。
- 「新倉合約價(接點)」會先帶入最後一筆有效資料的收盤價;改成您已核對的新接點。只做價格接續時,「乘數(小數點調整)」保留 1;需要尺度轉換才填其他大於 0 的值。
- 按「進行調整」,等按鈕顯示「調整完畢!」。到 QuantBrains 程式目錄的
BackAdjustedData找BA_原檔名。 - 抽查輸出第一筆、最後一筆與日期時間,另存研究紀錄,再按「離開」。同名輸出會更新,需保留前次結果時先另存。
數字練習:原檔最後收盤 100,接點填 102,乘數為 1,整份歷史價格會向上移 2,最後收盤成為 102;日期、時間與成交量不變。乘數是價格尺度設定,不是下單口數。
此工具不會替您搜尋合約、下載新行情或自動匯入 MultiCharts。已經是 Back Adjusted 的資料若再處理,價格會再次改變;請保留原檔、接點與乘數。輸出失敗時先看提示,核對程式目錄的寫入權限與檔案占用,排除後再試。
10 選用:讓 AI 幫您查資料與做研究
Client 已隨附 AI 連接工具(MCP)與操作說明(Skill)。它能讓支援的 AI 搜尋、下載、查詢和匯出資料;圖表、統計與回測報告則需 AI 本身具備相應的程式執行能力。
- 先完成 Client 啟用與一次下載。使用與 AI 相同的 Windows 帳號。
- 找到完整 Client 發布包的 Install2Agent 資料夾。將完整路徑交給 AI,貼上下面的安裝指示。找不到時,請取得包含此資料夾及相鄰
ai-agent的完整發布包。 - 依 AI 所用軟體的提示重新啟動連接工作階段。回到 Client 的「AI Agent 對接」確認安裝狀態與最近活動。
- 把選定資料交給 AI。在「資料與匯出」選一列,按「複製 AI 資料摘要」再貼到對話。
請讀取這個 Install2Agent 目錄,依照 AI_AGENT_SETUP.md 安裝 Data Center MCP 與 Skill。
我已在同一個 Windows 帳號完成 Client 啟用,請沿用加密設定,不要向我索取任何金鑰。
安裝後先列出目前本機可用資料,確認商品、期間及價格模式。先比對摘要中的資料目錄和 AI 正在讀取的目錄,再確認背景匯入是否完成。只有 ZIP/CSV、還沒匯入分析資料,或放在自訂規則目錄的內容,可能不在預設清單。請 AI 依隨附說明使用正確目錄,不要把另一組 Auto 資料當成指定自訂結果。
可以直接複製的三個練習
情境一:檢查台積電日線,再做研究
請使用我提供的 AI 資料摘要,檢查 2330 在 2024-01-01 至 2025-12-31 的 raw 與 adjusted 日線。
先閱讀隨附回測使用說明,回報實際可用日期、完整版本、缺漏與最後一日是否完整。
確認兩種資料可對齊後,再用已完成 K 棒產生訊號、下一根可交易 K 棒模擬執行。
請列出成本假設、資料限制與結果檔案位置;沒有實際執行就明確說明。成功產出包括資料檢查摘要、使用的版本與期間,以及實際執行才產生的研究結果。代號與日期只是操作示範。
情境二:匯出 YM/GC 給 MultiCharts
請找出 YM 與 GC 在 2025 年的 1 分鐘連續月資料,先核對交易所、Auto 規則、實際期間與版本。
檢查重複時間與缺漏,分開匯出未調整、Back Adjusted 的 MultiCharts ASCII,保留原時間。
請提供檔案位置、版本與檢查摘要,不把匯出完成寫成已完成 MultiCharts 匯入。取得檔案後,由您依下一頁的回測練習完成 MultiCharts 匯入與抽查。
情境三:準備目前還沒有的新商品資料
請搜尋 2357 的股票資料,先確認是否已有符合 2024 至 2025 年的可用版本。
缺少時依工具支援流程下載並追蹤原工作,完成後確認本機可用與共用發布狀態。
請保存實際商品、模式、日期、完整版本與匯出路徑。若只能提供部分期間,先列出缺口,不反覆提交同一工作。一般已驗證成品發布後,其他已授權使用者可從快速下載尋找;不代表所有商品或所有年份一定能取得。
11 常見問題與處理順序
找不到 Client,或啟動按鈕不能按
先看「平台授權」與「Client 檔案」。授權未通過先處理平台授權;檔案未安裝時,以完整 QuantBrains 發布包修復或更新,不只複製單一 EXE。更新前關閉 Client,更新後重新啟動。
無法繼承授權
關閉已開啟的 Client,再由 QuantBrains 啟動。若顯示平台金鑰未載入,重啟 QuantBrains 並確認授權。設定無法寫入時核對目前 Windows 帳號與目錄權限;未登記、到期或裝置被停用,請管理員處理。
Server 無法連線
檢查網路、Client 的 HTTPS 網址與連線狀態,按「檢查連線」;網址不確定時請管理員提供。不要把管理用內網 HTTP 地址當作正式 Client 網址。已有可讀的本機資料時仍可匯出。
商品找不到,或只有舊資料
改選「全部」、清除交易所,使用短代號或完整名稱,再查「全部商品」。快速下載只列已發布版本,舊版可下載不代表最新資料也能建構。若來源待確認或日期不支援,保留商品、條件與畫面原因給管理員。
工作很久沒有完成
開「工作診斷」看是排隊、執行還是失敗,再查看 Client「背景處理」。沒有百分比時查看階段與耗時。持續沒有新進度或顯示 stalled,記下原工作編號與最後訊息請管理員查詢;不要因等待就重複送出。
自訂換月規則被拒絕
核對確認天數/提前天數是否在畫面允許範圍;首次通知日、結算日或最後交易日的資料缺少時,請管理員確認是否支援。若只是要完成一般資料練習,可另選 Auto,但必須把它記成不同的規則結果。
裝置額度或今日商品額度已滿
以「連線與授權」顯示的額度、期限與有效裝置為準。裝置限制由管理員核對;每日商品額度已滿時,可先用本機資料,或等台灣時間午夜重置。同日同商品的重複下載與兩種價格模式不重複計算。
舊手冊的 ZIP 清單在哪裡?
目前入口已改成獨立 Client。請使用「資料下載中心 → 快速下載/全部商品」操作;不再沿用舊版「取得最新數據」與程式旁「歷史資料」清單。
Client 版本、商品與交易所、所選日期/模式/規則、出錯階段、工作編號,以及處理紀錄中的錯誤文字。畫面涉及帳號或完整授權內容時先遮蔽;不需提供完整金鑰。