資料與研究 · Data Center Client

搜尋、下載資料,再匯出給回測工具

從 QuantBrains 開啟資料下載 Client,選商品、價格模式與資料期間,完成下載後匯出給 MultiCharts 或 AI。第一次先練習一個商品,確認檔案可以開啟,再擴大到多個商品。

新手操作適用目前隨附 Client校對:2026-09-14

01 從 QuantBrains 開啟 Client

1

打開「資料下載中心」

在 QuantBrains 左側選「資料下載中心」。確認「平台授權」為通過、「Client 檔案」為已就緒;按「重新整理狀態」可重查授權、執行狀態與 Server 連線。Server 就是提供資料的遠端服務。

2

按「啟動資料下載 Client」

會另外開啟 Data Center Client 視窗,並沿用 QuantBrains 授權,不需另外輸入會員姓名或 Control API Key。若 Client 已在執行,可先使用既有視窗;需要重新繼承平台授權時,先關閉既有 Client,再由 QuantBrains 啟動。

3

確認連線與下載位置

在 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 第一次下載:先選一個商品

  1. 將建構規則設為 Auto(建議)。位置在搜尋區上方。先使用預設規則,完成整個流程後再研究自訂。
  2. 開啟「快速下載」。用「全部/期貨/台灣股票/指數」及交易所篩選。預設顯示期貨;找不到時先選「全部」並清除交易所條件。
  3. 輸入商品代號或名稱。例如輸入 2330 查台積電股票,或 YM/小道瓊查期貨。核對商品類型與交易所,股票和同名股票期貨是不同商品。
  4. 勾選需要的價格模式。同一商品的「未調整」與「調整後」可能分成不同列。尚不清楚怎麼選,先看下一節的用途表。
  5. 查看起訖日、資料截止與處理日期。所需回測期間應落在實際涵蓋範圍內。「處理日期」較新,不表示行情一定包含今天。
  6. 確認儲存方式。想在 Client 查詢、匯出或交給 AI,先選「分析資料庫」;同時要保留 CSV 時,選「分析資料庫 + CSV」。下載位置可在連線設定確認。
  7. 按「下載選取商品」。快速下載會取得列上顯示的固定版本。等到「資料可使用」,再到「我的商品庫」核對本機資料,最後匯出。
搜尋只找資料,不會開始下載

切換「快速下載/全部商品」會清除勾選,請重新核對選取。第一次輸入關鍵字時可跨分類搜尋;手動選過分類後,會依您選定的分類搜尋。也可用 2330-TAI、TXF-TIX 這類完整代號。畫面與檔名可能省略後綴,仍要一起核對交易所。

快速下載沒有我要的商品

  1. 切到「全部商品」,保留或重輸入關鍵字,選正確的商品與交易所。
  2. 在資料設定選日期範圍、未調整/調整後及儲存方式;日期先用一段已結束的歷史期間,例如 2024-01-01 至 2025-12-31。這是練習範例,能否涵蓋仍以回應為準。
  3. 按同一個「下載選取商品」。有可用資料會先重用;缺少時,支援的商品會自動確認來源與合約、準備並驗證資料後接續下載,無需另找「準備資料」按鈕。
  4. 第一次可能需要較久。查看原工作的進度;若實際日期比要求短,改用可用範圍或聯絡管理員確認,不能把要求日期當成已完成範圍。
「資料來源待確認」的處理

系統支援自動確認的商品,按下載後會先進入來源確認;如果畫面明確不允許下載,或回報資料不足、商品衝突、授權問題,就依提示交由管理員處理。看到商品名稱不代表所有年份均有資料,也不需要自己猜月份合約。

第一次練習的成果

您能指出一個商品的類型、交易所、價格模式、實際資料範圍與下載位置,並在「本機可用資料」看到可匯出的資料列。

04 選價格模式、週期與期貨規則

選項主要用途使用時注意
股票:未調整 raw核對當時價格、成交價與費用。除權息前後可能有價格落差;用於跨事件損益研究時,需另外處理股息與股數變化。
股票:調整後 adjusted/還權研究較連續的價格走勢、指標與訊號。不是當時可成交價格,也不等同股利再投入總報酬;不要再次還權。
期貨:未調整 raw查看接續前後的原始價格水準。仍是接續的連續月資料,換月可能跳價;不能當作一張從頭持有到尾的實際合約。
期貨:Back Adjusted研究跨月價格趨勢與訊號。已處理換月價差,歷史價格可能改變;不能直接當作實際成交價。
指數觀察指數走勢。提供未調整資料,不套用期貨換月或股票還權。
1 分鐘/日線1 分鐘用於盤中研究,日線用於每日研究。選符合策略需求的週期;Data Center 的時間是交易所當地時間。

想同時研究股票訊號與交易成本,可下載 raw 和 adjusted。兩者應分開保存與命名,使用時核對共同期間與時間對齊;不把兩種價格混到同一個 MultiCharts 商品。Client 的「回測使用說明」可查更完整的資料用途。

以實際範圍為準

部分商品的較早歷史無法取得,Auto 可能提供最近一段通過驗證的連續資料。完成提示若顯示早期未涵蓋,回測就從實際起日開始;不要補造缺少的 K 棒或把無行情等同尚未掛牌。

需要比較換月方式時,再建立自訂規則

  1. 開啟「建構規則」,按「新增規則」,輸入清楚的名稱,例如「成交量交叉確認 2 日」。
  2. 選換月方式與參數。成交量交叉的確認天數可設 1–10 日;最後交易日、結算日、首次通知日(FND)的提前天數可設 0–60 日。
  3. 按「儲存規則」。看到「尚未儲存變更」表示還是草稿;只有儲存後才會供下載選用。「還原已存」會放棄目前草稿。
  4. 回到資料下載中心,在搜尋區上方選剛才的規則,再勾選期貨與日期,按「下載選取商品」。
  5. 完成後核對「自訂:規則名稱」及獨立資料目錄。比較兩組規則時,各自匯出並記下規則與版本。

「檢查期貨適用性」可先檢查商品條件;缺少合約日期時會無法建構。您仍可先儲存規則模板,但不代表每個商品都能使用。Auto 是唯讀預設,不能改名、刪除或覆寫;自訂規則可複製、改名及刪除。

自訂只影響期貨

混合下載股票、指數與期貨時,自訂接續規則只套用期貨。自訂結果獨立保存,不覆蓋 Auto,也不自動加入其他使用者的公共快速下載。規則不適用時請處理原原因,不要把另一組 Auto 資料當成同樣的自訂結果。

05 股票資料:下載後先看這些提示

股票「還權」會調整較早的歷史價格,減少除權息造成的落差。後來有新事件,舊日期的調整後價格也可能更新;要重現回測,請保存當次匯出的檔案與完整版本。成交量不隨還權價格改變。

在「資料與匯出」選股票後,查看下方的收盤定義、最後一日狀態、還權基準日與來源說明:

畫面提示下一步
部分交易日最後一天可能未收齊;先排除這一天的完成日訊號,待更新後重新確認。
時段已結束,完整性尚未驗證不能因此判定全日行情或官方收盤已核對;依研究所需選擇已確認資料。
未提供驗證資訊舊資料可能缺少說明。保留未知狀態,必要時向管理員確認或取得新版本。
日線最後一筆價格不一定是官方收盤價

目前日線 Close 取自最後取得的分鐘資料,尚未逐日核對官方收盤。若您的策略依賴官方收盤或完整交易日,先確認這項限制。檔案下載成功、名稱含 adjusted,都不能代替完整性檢查。

盤中要求今天的還權資料

系統以台灣時間 14:00 作為當日參考資料確認門檻。盤中包含今天的調整後/雙模式要求,可能先提供前一日以前的已確認歷史;14:00 後仍須通過來源與資料驗證,不保證立即有當天成品。原始資料單獨下載不受這個還權門檻影響,仍以下載結果的實際截止為準。

使用 raw/adjusted 共同回測時,先核對日期時間與成交量能對應,保存各自的版本編號;兩者編號不必相同。不要在回測軟體再次打開價格自動調整,也不要因使用還權報酬而重複加入同筆股利。完整的成交與公司行動處理,交由符合該研究需求的回測工具完成。

06 確認完成,並分清楚停止範圍

看到的狀態代表什麼您要做什麼
排隊 queued/執行 running遠端服務還在準備資料。在工作診斷追蹤原工作,不重複提交。
工作成功 succeeded遠端資料準備完成。仍需確認 Client 的下載與本機處理。
ZIP 已下載完成壓縮檔已存好並完成完整性檢查。可按「開啟 ZIP 位置」;等待背景解壓與匯入。
資料可使用/本機可匯出所選儲存方式的本機資料已完成。核對期間、模式、週期與列數,再匯出。
失敗 failed這一階段未完成。查看處理紀錄,依錯誤修正,再重試未完成的項目。
100% 下載不等於可以開始回測

解壓、驗證及匯入可能比下載更久。沒有可可靠計算的總量時,畫面只顯示目前階段與耗時,並非卡住。可按「查看處理紀錄」看最近進度;批次下載會分商品顯示結果,成功的商品不需重做。

要停止哪一件事?

動作影響範圍恢復方式
停止本次下載停止目前前景下載/等待;未送出的商品不再送出。先前已排入的背景工作不受影響。等「正在停止…」結束,再核對原工作及保留檔案後重試。
背景處理 → 停止這筆處理停止選取商品的解壓或匯入,保留 ZIP。排除問題後在背景處理手動重試;重開 Client 不自動續跑明確停止的項目。
暫停後續處理稍後再處理後續背景項目。回背景處理繼續。
工作診斷 → 取消選取只針對目前仍可取消的遠端工作。送出後等最終狀態;「取消中」尚未停止。
取消等待停止自己等待共用更新。稍後查原更新結果;不會終止其他使用者共用的處理。

關閉 Client 會結束目前本機下載或等待,保存未完成的背景項目;下次使用相同下載目錄可接續。遠端已接受的工作可能仍在進行,重開後先查原工作編號。

下載完成,但本機資料檔使用中或匯入失敗

Client 會短暫等待占用解除。仍失敗時,從處理紀錄確認檔案位置,關閉正在讀取該檔案的分析工具,檢查磁碟空間與目錄權限,再到背景處理重試該商品。ZIP 會保留,通常不必重新下載;若背景清單沒有項目,重新執行下載會先檢查能否沿用相同版本 ZIP。不要為本機檔案問題反覆要求遠端重建。

07 在商品庫查看與匯出

「我的商品庫」一個商品顯示一個主列,展開後可查看原始/調整模式與版本紀錄。股票、股票期貨及小型期貨仍分開。選商品後按「資料與匯出」,或雙擊、使用右鍵選單,會開啟相同視窗。

1

選本機可用的資料

在「本機可用資料」分頁選價格模式與週期,核對期間、完整版本及可用操作。背景處理剛完成時按「重新讀取」。只有標示可匯出的列才繼續。

2

選格式與輸出目錄

一般表格工具選「CSV(含欄位名稱)」;交給 MultiCharts 選「MultiCharts ASCII」。確認輸出目錄後按「匯出選取資料」。此入口匯出該列完整本機資料,保留原時間。

3

找到匯出的檔案

完成後記下列數與完整路徑,按「開啟匯出資料夾」。用檔案開頭、結尾確認日期與欄位,再依回測練習匯入 MultiCharts。

儲存方式與匯出格式不是同一件事

下載時的儲存方式何時選用
分析資料庫在 Client 查資料、交給 AI 或後續匯出。通常從這個選項開始即可。
分析資料庫 + CSV除了 Client 查詢,也要保留給舊工具使用的 CSV;會佔更多空間。
只保留 CSV主要搭配既有 CSV 工具。完成後可查看 CSV;AI 的本機分析清單可能不會列出尚未匯入的資料。

一般匯出檔預設在下載根目錄的 exports。ZIP 保存在商品資料夾的 packages;用「開啟資料夾」或「開啟 ZIP 位置」可找到,不必手動尋找內部分析檔案。

只匯出一段日期,或給 AI/Python 使用

  1. 在資料工作區選已下載的資料集列,開啟進階匯出面板。
  2. 選「Parquet(AI / Python)」或「MultiCharts ASCII」,設定日期與輸出目錄。
  3. 一般先保留原時間。只有您的匯入規則明確需要時,才勾選「Time shift +1 分鐘」。
  4. 匯出後核對實際起訖與列數。ASCII 檔名以 _ASCII.txt 結尾,欄位依序為 Date, Time, Open, High, Low, Close, TotalVolume。

已有可讀的本機資料時,匯出不需再連線遠端服務,也不需再下載。

下載記錄還在,為什麼不能匯出那個舊版本?

「下載記錄 / 版本」是歷史紀錄,不保證所有版本檔案都留在本機。同一資料目錄中的相同商品/模式/週期,使用目前啟用的本機版本。要使用舊版,在記錄按「重新下載此筆記錄」,或改選實際可用的版本;遠端已移除舊版時會顯示原因。移除商品庫記錄不會刪除已下載檔案。

自訂規則結果放在獨立資料目錄;請從該結果的「開啟商品資料夾」辨識,並核對規則名稱。保存回測時,另外保留匯出檔、完整版本及規則,不依賴清單永久保留舊版。

08 下次要更新資料時

  1. 先看目前資料截止。若已有版本涵蓋研究期間,可直接使用本機資料。
  2. 重新整理快速下載清單。已出現較新版本時,核對模式與截止日後下載。
  3. 需要的日期仍未涵蓋時,使用商品的進階更新操作。確認商品、日期與模式後送出要求,追蹤等待、處理、發布或失敗狀態。
  4. 完成後重新整理並下載新版本。更新要求被接受,不等於新資料已在本機;仍要等下載及本機處理完成。
  5. 另存研究紀錄。保留前次回測匯出檔,記下新版本和實際日期;還權與接續歷史可能因更新而改變。
在「全部商品」準備成功,快速下載還沒出現

一般 Auto 成品通過驗證後,仍要完成背景發布與打包才會加入共用清單。查看原結果的發布狀態,完成後重新整理「快速下載」,並清除類型/交易所篩選。若發布失敗,保存原工作與錯誤給管理員,不需重新建構同一批行情。

自訂規則、待人工確認或只有原始月份合約的結果,不會自動列入一般快速下載。其他人發布成功的商品可供已授權使用者搜尋下載,但不會自動加入您的「我的商品庫」。

09 選用:主程式的「合約轉換調整」

這是 QuantBrains 主程式內處理既有歷史文字檔的工具,適用於您已確認接點價格,想把一份舊資料移到指定價格基準,或調整報價小數點尺度的情境。它與 Client 的自訂換月規則是兩個入口;一般 Data Center 下載不必使用這個工具。

  1. 先保存原始檔。檔案應按日期時間排列,前七欄依序是日期、時間、開、高、低、收、成交量,以逗號分隔;成交量使用整數。
  2. 回 QuantBrains 主程式上方的「資料下載中心」功能區,按「合約轉換調整」,再按「匯入歷史資料」選檔。
  3. 確認畫面顯示匯入完成,檢查接受與略過筆數。表頭可能被略過,但資料列異常也會被略過;略過數超出預期時先檢查檔案。匯入失敗時先重新選正確檔案,不直接繼續調整。
  4. 「新倉合約價(接點)」會先帶入最後一筆有效資料的收盤價;改成您已核對的新接點。只做價格接續時,「乘數(小數點調整)」保留 1;需要尺度轉換才填其他大於 0 的值。
  5. 按「進行調整」,等按鈕顯示「調整完畢!」。到 QuantBrains 程式目錄的 BackAdjustedData 找 BA_原檔名。
  6. 抽查輸出第一筆、最後一筆與日期時間,另存研究紀錄,再按「離開」。同名輸出會更新,需保留前次結果時先另存。

數字練習:原檔最後收盤 100,接點填 102,乘數為 1,整份歷史價格會向上移 2,最後收盤成為 102;日期、時間與成交量不變。乘數是價格尺度設定,不是下單口數。

調整後再匯入回測工具

此工具不會替您搜尋合約、下載新行情或自動匯入 MultiCharts。已經是 Back Adjusted 的資料若再處理,價格會再次改變;請保留原檔、接點與乘數。輸出失敗時先看提示,核對程式目錄的寫入權限與檔案占用,排除後再試。

10 選用:讓 AI 幫您查資料與做研究

Client 已隨附 AI 連接工具(MCP)與操作說明(Skill)。它能讓支援的 AI 搜尋、下載、查詢和匯出資料;圖表、統計與回測報告則需 AI 本身具備相應的程式執行能力。

  1. 先完成 Client 啟用與一次下載。使用與 AI 相同的 Windows 帳號。
  2. 找到完整 Client 發布包的 Install2Agent 資料夾。將完整路徑交給 AI,貼上下面的安裝指示。找不到時,請取得包含此資料夾及相鄰 ai-agent 的完整發布包。
  3. 依 AI 所用軟體的提示重新啟動連接工作階段。回到 Client 的「AI Agent 對接」確認安裝狀態與最近活動。
  4. 把選定資料交給 AI。在「資料與匯出」選一列,按「複製 AI 資料摘要」再貼到對話。
請讀取這個 Install2Agent 目錄,依照 AI_AGENT_SETUP.md 安裝 Data Center MCP 與 Skill。
我已在同一個 Windows 帳號完成 Client 啟用,請沿用加密設定,不要向我索取任何金鑰。
安裝後先列出目前本機可用資料,確認商品、期間及價格模式。
AI 找不到本機資料時

先比對摘要中的資料目錄和 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 版本、商品與交易所、所選日期/模式/規則、出錯階段、工作編號,以及處理紀錄中的錯誤文字。畫面涉及帳號或完整授權內容時先遮蔽;不需提供完整金鑰。

下一步

帶著匯出的 ASCII 檔完成回測練習,再把策略訊號接回 QuantBrains。