量化思維 · 圖解與手冊QuantTrader 畫面導讀手冊第四版 · 既有實機圖片含歷史介面，數值為畫面示例
QuantTrader4QuantTrader 3 戰情交易平台 · 完整操作手冊
第四版 · 2026-07-19
第四版 · 2026-08-17 安全與券商能力校正

從第一次啟動到安全送單
一步一步帶你完成

QuantTrader 3（簡稱 QT3）把 MultiCharts 圖表、部位風控、券商帳戶、交易白板、績效與 Web 監控放進同一個工作站。這份第四版手冊從零開始解釋每一個核心畫面，並把目前已完成的功能、預設關閉的金流能力、尚待實機驗證的限制清楚分開。

一句話定位：你決定交易策略；QT3 協助管理資料、部位、風控、出場與帳戶路由。任何實單功能都必須經過明確開關與安全閘，不能把畫面上的「已連線」誤解成「已允許自動交易」。

第一次閱讀，請選一條路線

完全新手：01 → 06 → 13 → 14先理解平台、完成設定、知道安全閘，再照每日流程操作。
MultiCharts 使用者：04 → 06 → 07 → 08專注檔案交換、圖表串接、風險試算與智慧出場。
白板／券商使用者：15 → 18 → 19學會工作空間、帳戶卡、下單路由與回報查核。
維運者：20 → 23處理 WebUI、資料新鮮度、備份與故障排除。

適合誰用？

📈MultiCharts 使用者已經在 MC 上跑訊號／指標，想要更聰明的部位與出場控管。
🛡️重視風險的交易者希望「以損定量」、每筆都先想清楚最多賠多少才進場。
🧩多策略玩家同時跑好幾套策略，想用權重把它們整合成一個總部位。
🌐有架站需求的人想把即時圖表嵌進自己的 WordPress 或網站分享給夥伴。
畫面版本說明：白板與主工作空間使用目前專案畫面；部分 MultiCharts 串接、商品／貨幣與舊圖表操作圖片沿用前版素材，主要用來說明流程。若按鈕位置或頁籤名稱不同，請以本手冊文字與目前程式顯示的繁體中文名稱為準。
⚡ QUICK START

⚡5 分鐘快速上手

沒時間讀完整份手冊？照這四步做，五分鐘內得到第一個正向回饋：看到部位數字即時跳動。之後再回頭補細節。

快速上手四步流程 匯入官方訊號、建立圖表專案、開始監控、看到部位跳動即成功。 ① 匯入官方訊號 MC 套用 @QuantTrader_Connect ② 建立圖表專案 新增圖表串接 GOrderID 兩邊一致 ③ 按開始監控 確認勾選啟動圖表交易 每 500ms 讀 Info.txt ④ 看到部位跳動 = 串接成功 ✓ 再學風控與安全閘 全程實單保持關閉——先看懂資料，再談交易。
快速上手 · 四步完成第一個圖表串接；任何一步卡住，對應章節都有完整排解（①→第 4 章、②→第 6 章、③→第 6 章、④→第 23 章）。
快速上手只做「資料串接」，不做交易。 這四步完成時實單與 AutoTrade 仍然是關閉的；要真正送單，請務必先讀第 13 章安全鐵律與「第一次實單前檢查清單」。
QuantTrader 3 工作空間示範畫面：卡片持續更新部位與損益
成功樣貌。 工作空間卡片持續更新部位與損益，即代表 MultiCharts → QT3 串接成功。
02 · OVERVIEW

02平台概觀

先看一張全貌圖，了解 QT3 由哪些「能力」組成。之後每一塊都會有專屬章節細說。

QuantTrader 3 平台架構心智圖 中心為 QuantTrader 3 戰情交易平台，向外延伸七大能力分支。 QuantTrader 3 戰情交易平台 你的風控副駕 🛡️ 風險控管 以損定量 · 動態部位 🎯 部位追蹤 即時損益 · 獲利峰值 🚪 智慧出場 停利停損 · 獲利回吐 🧩 策略整合 多策略加權 · DD 自動調整 📨 通知 Telegram 即時推播 🌐 對外嵌入 WordPress 圖表 iframe 📊 戰情總覽 績效 · 權益曲線
圖 1 · QuantTrader 3 七大能力一覽——所有功能都圍繞著「幫你管好風險與部位」這個核心。
核心：風控 部位追蹤 智慧出場 策略整合 戰情總覽 對外嵌入圖表
03 · HOME

03主畫面導覽

目前主畫面由四個固定區域組成：上方 Ribbon、左側可搜尋導覽列、中央工作區，以及底部全域狀態列。先學會看狀態，再開始操作。

QuantTrader 3 目前主畫面與交易白板
目前的工作空間。 左側工具列可新增卡片，中央卡片與連線代表帳戶、圖表、部位與工作流；上方紅框狀態帶顯示實單、自動化、外部訊號、斷路器與風險狀態。

左側導覽列有哪些頁面？

導覽項目用途
工作空間預設首頁，也就是交易白板。用卡片與連線整理帳戶、圖表、提醒、報價、工作流與交易紀錄。
圖表交易控制台單一圖表專案的詳細操作面板：風控設定、部位、停利停損、開始／停止監控。
策略整合與管理把多套策略用權重加總成一個總部位（策略管理模式）。
交易備忘錄記錄你的交易筆記、心得、待辦。
版本控制查看設定的歷史與版本紀錄。
導覽與 Ribbon 都會記住上次狀態。 左側搜尋框可輸入圖表名稱、商品分類或策略；收合／展開群組、最後選取頁面與 Ribbon 收合狀態會保存。要看總體績效，請按 Ribbon 的「首頁（戰情總覽）」。

底部全域狀態列怎麼看？

狀態你要確認什麼可做的動作
交易模式實單／預演／停用，以及是否啟用自動交易。點擊可前往帳戶與交易安全設定。
券商連線、未連線、設定不完整或錯誤原因。點擊開啟券商 API 帳戶設定。
監控圖表監控是否正在執行。點擊回到圖表交易控制台檢查專案。
Web 服務本機 WebUI 是否啟動、Port 是否可用。點擊開啟本機監控頁。
最後儲存最近一次自動或手動儲存時間。若長時間不更新，先停止操作並檢查 Log。
不要只看一顆綠燈。 「券商已連線」只代表通訊可用，不代表已開啟實單、自動交易或特定圖表監控。送單前至少同時核對交易模式、券商、監控、商品／帳戶與口數。
04 · HOW IT WORKS

04運作方式：和 MultiCharts 用「檔案」對話

QT3 和 MultiCharts（MC）不直接「連線」，而是透過幾個約定好的文字檔互相傳遞訊息——就像兩個人各自往同一個信箱投信、再各自去收信。

MultiCharts 與 QuantTrader 檔案交換方向圖 Info.txt 由 MultiCharts 傳給 QuantTrader；CurrentPos.txt 與停損停利檔由 QuantTrader 傳給 MultiCharts 執行。 MultiCharts 你的圖表 · 訊號 · 進場判斷 QuantTrader 3 風控 · 部位 · 出場決策 Info.txt 報價 · 指標 · 部位資訊 MC ➜ QT　（每 500 毫秒讀一次） CurrentPos.txt stoploss.txt · stopprofit.txt ＝下單與出場訊號 QT ➜ MC　（MC 讀取後執行） 方向是單向的：誰寫、誰讀，分得清清楚楚。
圖 2 · 兩個方向的檔案交換——上行是 MC 把資訊送給 QT；下行是 QT 把指令送回 MC 執行。
最重要的方向觀念： CurrentPos.txt 只由 QuantTrader 寫入，MultiCharts 只負責「讀取後執行」。請不要讓 MultiCharts 去寫 CurrentPos.txt，否則兩邊互相覆蓋，部位就會錯亂。

Info.txt 必須包含「完整 23 個欄位」

QT3 要靠 Info.txt 才知道現在的報價、指標、部位狀態。這個檔案必須依序包含以下 23 個欄位，少一個都會讓 QT3「讀不懂」而停止更新：

#欄位#欄位
1最新報價13當筆交易最大虧損
2TickSize（最小跳動）14最大連續獲利交易次數
3一大點價值（每點價值）15最大連續虧損交易次數
4進場後最高點16最大連續虧損
5進場後最低點17圖表累計損益
6標準差18TL1 價位
7ATR19TL2 價位
8追蹤停損20TL0 價位
9自訂緩衝範圍21自訂條件1 數值
10平均進場價格22自訂條件2 數值
11未平倉損益23手續費
12當筆交易獲利峰值24保證金（選填）
強烈建議：別自己手寫這 23 個欄位。 直接在 MultiCharts 匯入官方提供的 @QuantTrader_Connect 訊號，它會自動把所有欄位正確輸出。手寫很容易漏欄位，結果就是「啟動監控後資料一直不更新」。
在 MultiCharts 匯入 @QuantTrader_Connect 訊號並設定參數
在 MultiCharts 套用官方訊號。 在圖表的 Format Signal 視窗加入 @QuantTrader_Connect，填入 GOrderID 等參數即可自動輸出完整 Info.txt。
05 · SETUP

05初次設定：三個步驟上手

第一次打開 QT3，先把這三件事設定好，後面就一路順暢。

啟動前檢查

項目需求為什麼
作業系統64 位元 Windows 10／11正式建置與券商元件以 x64 為主。
.NET.NET Framework 4.8桌面主程式的執行環境。
白板Microsoft Edge WebView2 Runtime交易白板使用內嵌 WebView2；缺少時可能呈現空白。
圖表串接MultiCharts 與官方 @QuantTrader_Connect 訊號輸出完整 Info.txt 並讀取 QT3 的部位／出場檔案。
資料目錄程式所在目錄可讀寫，磁碟空間足夠SQLite、WhiteboardSettings 與 GOrder 都會持續寫入。
券商元件依券商官方要求安裝並授權例如群益 SKCOM；只啟動 QT3 不會自動補齊券商環境。
使用正式發行資料夾。 不要只複製 QuantTrader.exe，也不要從其他版本拼湊 DLL。WebUI/、資料庫原生元件、DevExpress 相依檔與 GlobalVariable.dll 都必須與該版本配套。
STEP1

輸入授權驗證碼

在 Ribbon 找到「輸入驗證碼」，貼上你的授權碼後送出。成功後，主視窗左下角會顯示你的授權 ID 與使用期限——看到它就代表啟用完成。

STEP2

設定基準貨幣與匯率

如果你交易跨幣別商品（例如同時有台指與美股期），需要一個基準貨幣來把損益換算到同一個幣別比較。

  • 用 「新增貨幣」 加入你會用到的計價貨幣。
  • 用 「即時匯率助手」 一鍵自動下載最新匯率（含台幣）。
  • 若你只交易單一計價貨幣，這步可以略過。
STEP3

新增商品

告訴 QT3 你要交易哪些商品。每個商品需要：商品名稱、商品代碼、交易所代碼、計價貨幣、合約乘數（每點價值）。

商品代碼交易所計價貨幣合約乘數
E-mini S&P 500ESCMEUSD50
E-mini Nasdaq 100NQCMEUSD20
台指期TXTAIFEXTWD200
小台指MTXTAIFEXTWD50
輸入授權驗證碼畫面
Step 1 · 輸入授權驗證碼，成功後左下角顯示授權 ID 與期限。
基準貨幣與即時匯率助手
Step 2 · 貨幣設定與即時匯率助手，一鍵下載最新匯率。
新增商品畫面
Step 3 · 新增商品，填入代碼、交易所、計價貨幣與合約乘數。
06 · PROJECT

06建立圖表交易專案

「圖表交易專案」就是一個 MC 圖表和 QT3 之間的對接單位。每個專案有自己的資料夾、自己的部位、自己的風控設定。

STEP1

用「新增圖表串接」建立專案

設定 GOrderID（這會對應到磁碟上的資料夾名稱，要和 MC 端一致）、標籤（方便你辨識）、選擇商品，並勾選「啟動圖表交易」。

STEP2

在 MultiCharts 端輸出完整 Info.txt

在對應的 MC 圖表上套用官方 @QuantTrader_Connect 訊號（強烈建議匯入而非手寫），讓它持續輸出完整 23 欄的 Info.txt。

STEP3

按「開始監控」

回到 QT3，按下開始監控。系統就會每 500 毫秒讀一次 Info.txt，畫面開始即時更新部位與損益。

新增圖表串接
新增圖表串接。 建立專案、設定 GOrderID 與標籤、選擇商品。
圖表串接參數設定
對接參數。 在 MC 訊號設定中填入相同的 GOrderID 與商品代碼。
對不上資料？先檢查兩件事： ① GOrderID 兩邊是否一致；② Info.txt 欄位是否齊全（建議匯入官方訊號）。這兩點是「啟動後資料不更新」最常見的原因。
07 · RISK

07以損定量風控：先想「最多賠多少」

很多人開倉時想的是「我要賺多少」，QT3 要你反過來先想「這一筆我最多願意賠多少」。決定了願意承受的風險金額，系統就幫你算「該下幾口」。

以損定量計算示意 建議部位等於單筆可承受風險金額除以停損距離乘每點價值。 建議部位（口數） = 單筆可承受風險金額 ÷  ( 停損距離 × 每點價值 ) 風險金額 2000 元 / 筆 ÷ 停損距離 40 點 × 每點價值 50 元 / 點 = 建議部位 ≈ 1 口
圖 3 · 風險 2000 元、停損 40 點、每點價值 50 元 → 2000 ÷ (40 × 50) = 1，建議約下 1 口。
建議部位 = 單筆可承受風險金額 ÷ ( 停損距離 × 每點價值 )
算例：風險 2000 元、停損 40 點、每點價值 50 元 → 2000 ÷ (40 × 50) = 約 1 口。停損愈遠，能下的口數就愈少——這正是風控的用意。

停損的四種模式

模式說明適合
ATR依市場波動度自動設停損距離，行情狂時停損放寬、平靜時收窄。👍 新手首選
標準差用統計離散程度決定停損距離。量化偏好者
固定點數永遠停損固定的點數，最直覺。規則簡單者
TL[0]（趨勢線）以你在 MC 上畫的趨勢線當作停損依據。看圖派
新手建議： 停損模式選 ATR，倍數設 1.5～2.5，是穩健好用的起點。

出場位置追蹤的三種模式

進場後，停損的「基準點」要跟著什麼走？三種選擇：

  • 隨最後加碼點——停損跟著你最近一次加碼的價格移動。
  • 隨平均進場價格——停損跟著整體平均成本移動。
  • 進場後獲利創高點追蹤——賺愈多、停損跟得愈緊，鎖住利潤。（建議用這個）
主觀控制／風險與部位試算（既有介面）
主觀控制：風險與部位試算。既有介面畫面，非績效圖表。
08 · EXIT

08智慧出場：替你盯著每一個出場理由

進場容易、出場難。QT3 同時幫你盯好幾個出場條件，只要其中任何一個被觸發，就標記清倉訊號、寫回給 MC 執行。

智慧出場決策流程圖 持倉時逐一檢查目標停利停損、獲利回吐保護、指定時間清倉、趨勢線條件，任一觸發即標記清倉並寫回 MultiCharts。 持倉中？ 有部位才檢查 🎯 目標停利／停損 到達設定價位 📉 獲利回吐保護 回吐達設定 % ⏰ 指定時間清倉 日內避免留倉 📐 趨勢線 TL 條件 突破／跌破觸發 ⚑ 任一觸發 → 標記清倉 產生清倉／出場訊號 寫入 stoploss / CurrentPos 交給 MultiCharts 執行
圖 4 · 持倉時逐一檢查四類出場條件，任一觸發即標記清倉並寫回 MC 執行。

四種出場機制怎麼用

  • 目標價位停利／停損——到達你設定的價位就出場。
  • 獲利回吐保護——當帳上獲利從高點回吐達設定百分比（建議 20～30%）就保護出場；還沒獲利時不會誤觸發，所以可以放心開著。
  • 指定時間清倉——到設定時間自動出清，日內交易者用來避免留倉過夜風險。
  • 趨勢線 TL[1] / TL[2] 條件——直接在 MC 圖上畫趨勢線，突破／跌破時觸發出清或下單，還可以設定時段與通知。

趨勢線（TL）操作

趨勢線是「看圖派」最直覺的工具：你在 MC 圖上畫一條線，QT3 就會盯著價格有沒有碰到、突破或跌破它，並依你的設定動作（出清、下單、或只通知）。

在 MultiCharts 畫趨勢線 1
① 畫趨勢線。 在 MC 圖表上拉出你想監控的趨勢線。
設定趨勢線屬性與警示 2
② 設定條件。 圖上即時顯示 TL 價位（TL[0]/TL[1]/TL[2]）與條件數值。
趨勢線觸發動作 3
③ 觸發動作。 突破／跌破時，依設定出清、下單或發通知。

指定價位條件

除了趨勢線，你也可以設定固定的指定價位：價格觸碰到就通知你、或執行動作。適合「我想盯某個關鍵價」的情境。

指定價位條件設定
指定價位條件。 設定觸價要做的動作（通知／出清／下單）。
主觀進場也可以。 除了讓策略決定，你也能在帳戶面板手動下達主觀進場。下單一律會走第 13 章的安全閘，需要你逐筆確認。
帳戶與主觀進場操作
帳戶／主觀進場。 手動操作部位時的操作面板。
風控與智慧出場（既有介面）
風控與智慧出場：追蹤、停利停損與獲利回吐。既有介面畫面，非績效圖表。
09 · STRATEGY

09策略整合：用權重把多套策略合成一個總部位

同時跑好幾套策略時，總不能各自為政。QT3 的「策略管理模式」讓每套策略各自報出部位，再依你給的「持有單位（權重）」加權加總，得到一個乾淨的總部位送進 MC 執行。

策略加權總部位示意 三個策略各自部位乘以持有單位後加總，寫入 CurrentPos.txt 交給 MultiCharts 執行；並有 DD 自動調整分支。 策略 A 部位 +2 口 × 權重 1.0 策略 B 部位 +1 口 × 權重 2.0 策略 C 部位 −1 口 × 權重 1.0 加權加總 = +3 口 CurrentPos.txt 總部位寫入 ➜ MC 執行 ⚙ DD 自動調整 某策略回撤達設定 % → 持有單位自動改為「待變更值」 設為 0 即等同暫停納入計算
圖 5 · 各策略部位 × 持有單位 → 加總成總部位寫入 CurrentPos.txt；DD 自動調整會在回撤過大時降低該策略權重。

DD 自動調整：自動降低「表現差」策略的權重

每套策略的權重叫做「持有單位」。你可以設定一個保護規則：當某策略的回撤（Drawdown，DD）達到你設定的百分比時，系統會自動把這套策略的「持有單位」改成你預先設定的「待變更值」。

  • 把「待變更值」設為 較小的數字 → 降低該策略影響力。
  • 把「待變更值」設為 0 → 等同暫停把這套策略納入總部位計算。
白話說： 哪套策略最近狀況不好（回撤太大），系統就自動幫你把它的聲量調小，避免它繼續拖累整體。
策略管理介面：策略清單含啟用、部位、持有單位數量與 DD%
策略管理介面。 每套策略的啟用狀態、目前部位、持有單位與 DD% 一目了然；在此調整持有單位數量。
戰情白板上的策略部位卡片
戰情白板。 用卡片呈現各圖表來源與旗下策略的部位與損益，一眼看清整體配置。
10 · NOTIFY

10通知：用 Telegram 即時掌握動態

當出場觸發、條件成立時，QT3 會主動把訊息推到你手機上。目前主要支援 Telegram。

STEP1

建立 Telegram Bot 取得 Token

在 Telegram 找官方的 @BotFather 建立一個機器人，它會給你一串 Bot Token。

STEP2

取得你的 Chat ID

Chat ID 代表「訊息要送到哪個對話」。取得後一起準備好。

STEP3

在「通知設定」新增

回到 QT3 的通知設定，填入 Bot Token 與 Chat ID，存檔後就能收到推播了。

LINE Notify 已於 2025 年 4 月終止服務。 已經無法再申請新的權杖，舊的也會失效。請改用 Telegram——本手冊不再提供 LINE 申請流程。
11 · EMBED

11對外嵌入網頁：把圖表放進你的網站

如果你有架站需求（例如 WordPress），QT3 內建一個小型 Web 伺服器，可以把即時圖表用 iframe 嵌進你的網站，分享給夥伴或讀者看。

STEP1

設定「對外嵌入 Token」

到 帳戶設定 → Web 伺服器，務必設定一組「對外嵌入 Token」。這就像一把鑰匙，沒有它，外部的人載得到頁面卻取不到資料。

STEP2

勾選「允許非本機存取」

同一個設定區內，勾選「允許非本機存取」，這樣別人的瀏覽器才連得進來。（你自己用 localhost 看不受影響、不需 token。）

STEP3

在網站 iframe 帶上 &k=Token

嵌入網址結尾要帶上你的 token。例如：

https://你的網域/embed_combined.html?id=專案ID&interval=5m&k=你的Token

embed_chart.html、showcase.html、performance.html、project.html 同理，都要在網址帶上 &k=Token。

對外嵌入三步流程 設定 Token、勾選對外存取、在 iframe 網址帶上 k 參數。 1 · 設定對外嵌入 Token 帳戶設定 → Web 伺服器 2 · 勾選允許對外存取 開放非本機連線 3 · iframe 帶 &k=Token 貼進你的網站
嵌入三步驟 · 設定 Token → 勾選對外存取 → 在 iframe 網址加上 &k=Token。
圖表是空白的？ 九成是沒設或沒帶 token。頁面本身載得出來，但因為沒有正確的 &k=Token，資料抓不到，看起來就是一片空白。
自己看不用 token。 在本機用 localhost 開啟時不受限制，不需要帶 token——token 只是用來保護「對外開放」的情境。
12 · DASHBOARD

12戰情總覽：一頁看懂整體績效

「戰情總覽」把你所有交易專案的權益與績效整合在一頁，讓你不必逐一翻看就能掌握全局。

指標它告訴你什麼
累積損益從開始到現在總共賺賠多少。
平均日損益平均每天的賺賠，看穩定度。
年化報酬率把績效換算成一年的報酬比例，方便橫向比較。
勝率賺錢的交易佔比。
夏普比率每承擔一分風險換到多少報酬，越高越「划算」。
最大回撤歷史上從高點掉到低點最慘的一段，衡量你要扛得住多大的痛。

除了數字，總覽還提供視覺化圖表：權益曲線、回撤圖、月度損益等，讓你一眼看出趨勢。

看的頻率建議： 績效每週看一次就好，避免被短期波動牽著情緒走。
13 · SAFETY

13下單安全鐵律：縱深防禦，預設不自動下單

不論交易意圖來自圖表、白板、外部訊號或 AI，都會收斂到同一組安全檢查。預設狀態下，實單與自動交易都關閉；只有你明確開啟 AutoTrade 時，受允許的自動路徑才可略過逐筆確認，其餘安全閘仍不可略過。

下單安全閘縱深防禦堆疊圖 交易意圖先依來源決定是否需要原生確認，再通過實單總開關、預演抑制、單筆最大口數、盤前風控、頻率限制與執行器能力，最後才到券商執行。 白板 / 手動 外部訊號（Python…） AI 提議 所有意圖收斂到同一條閘 ① 交易意圖 想做什麼動作（不等於成交） ② 來源與確認政策 一般／手動逐筆確認；AI／MCP 強制確認 ③ 實單總開關（預設：關） 沒手動打開，一切都只是模擬 ④ DryRun 預演 開啟時只試算與記錄，抑制真實送單 ⑤ 單筆最大口數 超過上限直接擋下 ⑥ 盤前風控規則 不符規則就不放行 ⑦ 連發斷路器 · Kill Switch 短時間異常連送或緊急停止時阻擋 ⑧ 券商執行 通過全部閘門才真正送單
圖 6 · 縱深防禦：確認政策只是其中一層；實單、DryRun、口數、風控、節流／斷路與券商執行能力都會獨立檢查。
四條鐵律請記住：
  • 實單送出預設關閉——你不主動打開，就不會有真單。
  • 一般與手動路徑預設逐筆確認；只有明確開啟 AutoTrade 的受允許自動路徑可略過該確認。
  • AI／MCP 動作永遠強制人工確認——AutoTrade 不適用；外部訊號也必須另行啟用、通過驗證與風控。
  • 回傳「可能已送達／結果未知」時絕對不要重送——先到委託／成交回報或券商端核對。

四種交易狀態不要混淆

設定預設真正意義
Whiteboard.LiveTrading.Enabled關實單總開關。關閉時，任何路徑都不應送到真實券商。
Whiteboard.DryRun.Enabled關開啟後只走流程與記錄，不執行真實送單；適合驗證路由與風控。
Whiteboard.AutoTrade.Enabled關允許受控自動路徑略過逐筆確認；仍受實單、MaxQty、風控、節流、斷路器與執行器限制。
Capital.OverseaOrders.Enabled關只控制群益 OF 實盤下單／刪單；OF 帳戶、權益、持倉與報價查詢不靠這個開關。
圖表「啟動圖表交易」依專案這張圖表是否參與監控。即使實單總開關開啟，未啟動的圖表也不應接收外部部位驅動。
新手建議順序：先保持實單關閉 → 用本地／示範資料確認畫面 → 開 DryRun 驗證風控、帳戶與路由 → 小口數人工確認 → 最後才評估 AutoTrade。不要一次打開多個金流開關。

外部訊號、TradingView 與 AI

來源預設啟用前必做
MultiCharts／XQ 訊號檔旁路觀察；部位驅動關閉核對檔案路徑、訊息格式、Symbol 對應與圖表監控；Signal.DrivePositions.Enabled 必須明確開啟。
TradingView webhook未啟用設定高強度 passphrase、限制網路來源，先在實單關閉／DryRun 下驗證防重與時間戳。
外部訊號 API關閉同時啟用功能與 passphrase；不應把 Web Port 直接暴露到公開網路。
動態訊號外掛關閉、要求簽章只從信任目錄載入，核對簽署者 CN／Thumbprint；未審查 DLL 不得啟用。
AI 覆盤／盤況敘事依設定只提供唯讀摘要；不得把模型文字當成券商回報或成交證明。
AI／MCP 動作動作關閉開啟後仍強制原生人工確認；AutoTrade 不適用。
外部訊號開啟後仍不是「保證同步」。 圖表部位變更而券商鏡單因忙碌、未連線或路由問題被略過時，系統會警告你人工核對；請把這類差異當成事件處理，不要等待它自行消失。

第一次實單前檢查清單

實單總開關打開之前，請逐條確認。任何一條答「不確定」，就回到對應章節重做一次——這份清單的目的，是讓第一張真單「無驚喜」。

#檢查項通過標準
1資料串接監控中報價／部位持續更新至少一個完整交易時段，無欄位不足警告。
2DryRun 全程已在 DryRun 跑完至少 3 個交易日，進出場、出清、通知皆如預期。
3券商快照帳戶卡權益／保證金／持倉顯示正確且時間新鮮，無「狀態未知」。
4路由設定下單路由的券商、帳戶、商品代號、月份、口數比例已逐一核對，路由健康燈正常。
5MaxQty單筆最大口數設為你可承受的最壞情況（新手建議 1 口）。
6最小口數真單已用 1 口人工確認送過 1 筆，並在委託／成交回報核對到結果。
7Kill Switch 演練實際按過一次全部停用，確認意圖被阻擋且知道如何恢復。
8斷路器認知知道連發斷路器觸發時的畫面與解除方式。
9「可能已送達」SOP已演練過：不重送 → 查回報 → 對序號 → 人工處理。
10三方對帳MC、QT3、券商端部位一致，或差異已能解釋。
11備份完成QTDB.sqlite（含 -wal/-shm）、GOrder/、設定 JSON 已備份且驗證可還原。
12AutoTrade 仍關閉第一週實單保持逐筆人工確認；AutoTrade 等穩定後再評估。
全部打勾後，才打開實單總開關。 這不是形式——這 12 條每一條都對應一個真實發生過的事故類型。
14 · DAILY WORKFLOW

14每日操作流程：盤前、盤中、盤後

新手最安全的用法，是每天都照同一個順序操作。不要從「按下單」開始，而要從「確認資料與閘門」開始。

每日操作時間軸 盤前確認資料與閘門、盤中循環看核査記、盤後對帳收尾與備份。 🌅 盤前 · 先確認再啟動 🔁 盤中 · 一次只改一件事 🌙 盤後 · 安全收尾 1 啟動 QT3，看全域狀態列 2 盤前戰備卡：券商／報價／匯率 3 核對專案後按「開始監控」 4 對照 MC 與 QT3 部位一致 👀 看狀態資料新鮮？ ✅ 核五事商品向口帳路 🔍 查回報委託＋成交 📝 記原因日誌與備忘 有異常先停手，不要邊猜邊下單 1 三方對帳：MC／QT3／券商 2 停止監控，等背景安全收尾 3 查日誌稽核，標記待追查 4 完全關閉後執行備份 順序固定、一次一件事——把「想當然」從操作裡拿掉。
圖 7 · 每日時間軸：盤前 4 步確認 → 盤中「看核查記」循環 → 盤後 4 步收尾。詳細清單見下文。

盤前：先確認，再啟動

  1. 啟動 QuantTrader，確認授權資訊正常，主畫面沒有持續錯誤提示。
  2. 查看底部全域狀態列：交易模式、券商、監控、Web 服務與最後儲存時間。
  3. 開啟工作空間的盤前戰備卡，確認券商連線、報價、匯率、保證金、轉倉倒數、斷路器與下單路由。
  4. 進入「圖表交易控制台」，逐一確認 GOrderID、商品、計價貨幣與監控開關；再按 Ribbon 的開始監控。
  5. 對照 MultiCharts 與 QT3 的最新報價／目前部位。兩邊不一致時先處理，不要開始送單。
  6. 若今天會使用真實券商，先用 DryRun 或最小口數人工確認路由；AutoTrade 保持關閉，直到你完成實機驗證。

盤中：一次只改一件事

看狀態

先看資料是否新鮮

看到「資料過期」「狀態未知」「未連線」時，先查原因。不要把舊報價、舊部位或空資料當成目前狀態。

核對

下單前複誦五件事

商品、方向、口數、帳戶、路由。確認框是最後一道核對，不是形式上的「下一步」。

查回報

送出後看委託與成交

不要只看按鈕回應。到委託回報卡、下單流水卡或原生回報視窗確認是否掛單、部分成交、已成、已拒或未知。

記原因

在日誌與備忘錄留下脈絡

記錄進場理由、異常、手動介入與處理方式，盤後才能重建當時決策。

盤後：安全收尾

  1. 核對 MultiCharts、QT3 與券商端的最終部位；確認沒有未預期掛單。
  2. 停止監控，等待背景工作正常結束。關閉較慢時不要強制終止。
  3. 查看交易日誌、操作日誌、下單稽核與委託／成交回報，標記「未知」或需追查事件。
  4. 更新檢討卡／交易備忘錄；每週再看戰情總覽、回撤與策略貢獻。
  5. 在程式完全關閉後執行備份；更新程式前務必保留可回復副本。
安全完成的定義：不是「今天沒跳錯誤」，而是資料來源一致、所有委託有可解釋結果、部位已核對、設定已儲存，而且能從備份還原。
15 · WHITEBOARD

15交易白板完整教學

「工作空間」就是交易白板。它不是單純儀表板，而是把資料來源、帳戶、圖表、工作流、風控與覆盤關係畫在同一張板上。

交易白板目前畫面：圖表來源、圖表鏡像與到價工作流
白板操作模型。 左邊新增卡片，中央用連線表示關係；上方安全狀態帶永遠優先於單一卡片上的按鈕狀態。

第一次建立白板

STEP1

選擇或新增白板

左上方下拉可切換白板；按 ＋ 新增、✎ 改名、垃圾桶刪除。刪除無法復原，先存具名快照或匯出模板。

STEP2

放入圖表來源與圖表卡

先加入唯一的「圖表來源（MultiCharts）」卡，再從來源卡選擇既有圖表或新增圖表。圖表卡代表該 GOrderID 的部位、損益與控制參數。

STEP3

加入券商帳戶與監控卡

加入帳戶模組、盤前戰備、資金閘門、下單流水與委託回報。沒有完成券商設定時，帳戶卡會顯示未設定／未連線，而不是假資料。

STEP4

拖曳連線，建立關係

從卡片四周圓點拖到另一張卡。連線主要表達歸屬、彙整或工作流程；不是每一條線都會送單。能動到資金的操作一定還會經後端安全閘。

工具列功能

工具用途新手提醒
搜尋模糊搜尋卡片、帳戶或圖表並聚焦。Ctrl+K
精簡／完整切換卡片資訊密度；選擇會保存在本機。盤中用精簡，設定與排查時用完整。
示範模式使用本機模擬資料展示漂移報價、損益與稽核。不送指令、不保存示範期間的板面變更。
匯出圖片把目前視野輸出為 PNG，附時間戳；示範模式會標註 DEMO。適合交班與覆盤，不等同資料備份。
模板卡快速放入突破追價、停損停利、轉倉提醒、手動鏡單或部位對帳流程。模板只是鷹架，不會自動武裝交易。
匯出／匯入模板分享選取的卡片與連線。帳戶識別、即時損益與武裝狀態會被移除；匯入後仍未武裝。
快照／時段佈局保存具名版面，或盤前、日盤、夜盤、覆盤四種視角。快照保護版面；真正資料備份仍看第 22 章。
自動整理依卡片連線做左右或上下分層排列。只改座標，可用復原還原。

鍵盤快捷鍵

Ctrl+K 搜尋 Ctrl+J AI 管家 F 縮放全覽 Ctrl+Z 復原 Ctrl+Y 重做 Delete 刪除選取 Ctrl+Shift+P 效能 HUD
AI 管家是輔助閱讀，不是交易代理。 盤況敘事與覆盤功能是唯讀分析；涉及修改規則或下單的 MCP／AI 動作仍會強制原生確認，AutoTrade 不適用。
16 · CARD CATALOG

16白板卡片與連線：每張卡做什麼

先分辨「純顯示」「可改設定」「可能產生交易意圖」三類。卡片看起來相近，權限與副作用卻不同。

白板卡片關係圖譜 以圖表來源與帳戶模組為兩大樞紐，實線為資料流、虛線為可能產生交易意圖的控制流，所有意圖都收斂到資金閘門。 圖表來源（MultiCharts） 白板唯一一張 · 唯讀彙整 帳戶模組（券商） 權益／保證金／持倉／轉倉 圖表鏡像卡部位／損益／鏡單關係 全局權益卡60 日權益＋今日貢獻 報價卡／報價板即時報價 · 可長出工作流 投資組合卡多帳戶績效彙整 委託回報卡掛單／部成／已成／已拒 轉倉提醒／轉倉中心到期倒數 · 純顯示 ⚡ 工作流卡 到價／手動觸發 → intent 🛡 資金閘門卡 確認／實單／MaxQty／風控／斷路 盤前戰備卡開盤前全檢 下單流水卡意圖稽核流 警示／風控面板異常集中看 AI 盤況敘事卡唯讀摘要 交易日誌卡事件＋覆盤 備忘卡／檢討卡筆記與回顧 實線＝資料流（唯讀） 虛線＝可能產生交易意圖（必經安全閘）
圖 8 · 卡片圖譜：兩大樞紐向外展開；只有「工作流／圖表鏡像的手動下單」會產生意圖，且一律先過資金閘門。連線 ≠ 授權。
卡片主要用途會不會直接送單
圖表來源（MultiCharts）彙整本地圖表與策略損益；白板唯一一張。不會，唯讀來源。
帳戶模組（券商）顯示權益、保證金、持倉、連線，並提供受控下單／轉倉入口。操作可能產生意圖，必走安全閘。
投資組合卡連接多個帳戶，計算總損益、回撤、Sharpe、Sortino、Calmar、勝率與貢獻。不會，統計用。
全局權益卡近 60 交易日權益、今日／本月損益與各圖表貢獻；可產生唯讀 AI 覆盤。不會。
備忘卡盤中筆記、待辦與操作提醒，隨白板保存。不會。
報價卡顯示單一商品即時報價，可建立到價工作流。報價不會；工作流另受安全閘。
報價板同時監看多商品，以數字與 ▲▼ 表示漲跌。不會。
工作流卡設定 ≥／≤ 觸發、買賣別、口數與帳戶；可手動或到價觸發。可能；送出的是 intent，後端仍檢查。
轉倉提醒卡顯示單一商品最後交易日與倒數，三天內示警。不會。
轉倉中心卡總覽商品、持倉、建議次月、自動轉倉狀態與下次觸發。不會，純顯示。
交易日誌卡彙整本次連線的進場、成交、平倉、洗價與轉倉事件，可加入覆盤註解。不會。
檢討卡填寫期間、做得好、待改進與下一步。不會。
AI 盤況敘事卡根據白板狀態產生異常、風險與不一致摘要。不會，READ only。
資金閘門卡顯示確認、實單、MaxQty、風控、連發斷路、Kill Switch 與稽核鏈。不會；點列只開對應設定／視窗。
盤前戰備卡檢查券商、報價、匯率、保證金、轉倉、斷路器、自動化與路由。不會。
下單流水卡顯示今日意圖來源、確認、風控、結果與被擋原因；未知時標示勿重送。不會。
委託回報卡顯示掛單中、部分成交、已成、已拒與成交回報。不會；刪改單只在原生視窗。
圖表鏡像卡代表一個圖表專案，可查看部位、損益、控制參數與鏡單關係。手動下單／鏡單可能產生意圖。
警示／風控面板集中呈現資料陳舊、轉倉、斷路與規則問題。不會。

連線的三種常見語意

  • 來源 → 圖表：這張圖表屬於哪個 MultiCharts 來源或帳戶彙整。
  • 帳戶 → 投資組合：把多個帳戶的圖表績效合併計算。
  • 圖表／報價 → 工作流：用特定商品或圖表建立到價流程；是否送單仍取決於工作流設定與後端閘門。
連線不等於授權。 把工作流卡連到帳戶卡，不會自動開啟實單、AutoTrade 或該券商執行器。安全設定與路由能力各自獨立。
17 · BROKERS & ACCOUNTS

17券商與帳戶設定

從 Ribbon 的券商設定或底部券商狀態開啟「帳戶與連線設定」。密碼與 API 金鑰會以目前 Windows 使用者的 DPAPI 加密，存放在程式目錄的 WhiteboardSettings.json。

目前內建能力

來源／券商帳戶資料下單／刪單現況
本地（MultiCharts 圖表）由 QT3 圖表專案彙整不直連券商；透過 MC 檔案協定可用
群益 TF 國內期貨帳號與權益可用；持倉查詢保守處理下單／刪單已接線但仍受實單、風控、稽核與路由檢查多帳號必須明確選帳號，不會自動選第一個；持倉橋接預設關
群益 OF 海外期貨帳號／權益查詢已依官方 31 欄格式接線Capital.OverseaOrders.Enabled=false 預設擋下 OF 實盤下單／刪單OF 查詢能力 ≠ OF 實盤下單能力；啟用前需實機驗證權限、商品、委託別與回報
幣安 Binance真實 REST API，需 HTTPS base URL 與 API Key下單與刪單已接線503 unknown、逾時或 post-dispatch 例外會顯示 Unknown；不要重送，先查委託／成交
元大期貨示範空殼尚未實作不可視為可實單券商
其他券商槽位／外掛依外掛實作依外掛能力預設停用，且要求簽章；未驗證外掛不得啟用

設定順序

STEP1

選擇券商並填入憑證

只在原生設定視窗輸入。儲存後會就地重新連線，不需要重啟程式。若儲存失敗，畫面應明確顯示，不要假設已保存。

STEP2

確認帳戶與市場別

群益帳號要確認國內／國外市場別；帳戶卡與下單路由應顯示一致帳號。多帳號 provider 必須明確選帳號，系統不會用第一個帳號代替你決定。帳號清單仍空白時不要自行輸入猜測值。

STEP3

保持實單關閉，先看快照

確認權益、保證金、持倉與資料時間。空資料可能是未連線或尚未回報，不等於帳戶真的空手。

STEP4

回到圖表設定下單路由

選擇券商、帳戶、商品、月份／交易所與口數比例；看路由健康燈，再做 DryRun。

匯率與保證金

  • 基準貨幣：預設 TWD。跨幣別績效會用匯率換算；預設超過 24 小時視為陳舊。
  • 保證金：商品保證金可手動匯入或自動更新；預設超過 48 小時視為陳舊。
  • 陳舊不是零：系統會保留最後可用值並示警；下單前仍應核對最新交易所／券商資料。

自動轉倉

自動轉倉預設關閉。啟用時要同時設定商品白名單、禁止新開近月的倒數天數、實際轉倉倒數與觸發時間；預設參考值分別為 3 天、1 天與 13:30。轉倉中心與提醒卡只顯示資訊，真正排程仍由主程式監控流程執行。

  1. 確認目前持倉的真實合約代碼、最後交易日與建議次月代碼。
  2. 確認券商帳戶快照新鮮、商品解析器就緒、次月合約可交易。
  3. 理解轉倉是「平近月＋開次月」兩腿，不保證市場上同時成交；任何一腿未知都先核對。
  4. 保持實單與 AutoRollover 關閉，先用提醒卡與 DryRun 觀察至少一個完整流程。
  5. 啟用後每天盤前查看轉倉中心；不要把排程當成無人值守保證。
群益診斷抽屜只供判讀。 它會顯示 market scope、目前查詢單位、已知帳號數、最後成功／錯誤與快照年齡，幫你判斷是帳號、TF/OF、市場別或橋接問題；它不提供新的下單設定入口。
群益 CapitalBridge 預設關閉。 它用獨立子行程隔離 SKCOM 持倉查詢的原生錯誤，但同帳號雙登入是否互踢尚未經真實環境完整驗證。不要只為了「看起來更穩」就開啟；先確認券商端登入政策、帳號狀態與實機流程。
換機注意：DPAPI 憑證綁定 Windows 使用者與機器環境。複製 WhiteboardSettings.json 到另一台電腦後，密碼／金鑰通常無法解密，必須由新機上的使用者重新輸入。
18 · MANUAL ORDER & ROUTING

18手動交易與下單路由

圖表交易控制台已依任務重新分區。操作時先從左側導覽選圖表，再按頁籤順序處理，不要在未確認專案的情況下直接按買進／賣出。

頁籤導讀

頁籤用途套用後是否可能影響交易
01 手動交易風險試算、初始出場、買進／賣出、加碼、出清、即時狀態與進出場紀錄。買賣／加碼／出清會。
02 風控與智慧出場停損、停利、獲利回吐、定時清倉等規則。規則在監控中觸發時會影響部位。
TL1／TL2 畫線條件設定趨勢線觸發條件與動作。啟用並命中時會。
指定價位設定特定價格的進出場條件。啟用並命中時會。
自訂條件 1／2使用 MC 輸出的自訂值組合條件。啟用並命中時會。
策略管理新增策略、調整持有單位與總部位。合成部位變更時會。
通知清單選擇通知對象與事件。不送單，但會對外傳送通知。
下單路由把圖表目標部位映射到券商帳戶與商品。啟用鏡單／自動化後會。
操作日誌查看套用、觸發、拒單、錯誤與寫檔結果。不會，唯讀追查。

手動下單標準流程

  1. 確認左側選取的圖表名稱、GOrderID、商品與最新報價。
  2. 確認目前部位、平均進場價、券商真實部位與路由意圖部位沒有未解釋差異。
  3. 輸入口數；新手先用 1 口。檢查 MaxQty 與預計最壞風險。
  4. 選擇買進、賣出、加碼或出清。閱讀原生確認框的商品、方向、口數與帳戶。
  5. 送出後立即查看委託回報與下單流水；不要只看畫面部位數字。

下單路由欄位

欄位說明常見錯誤
券商／帳戶真正接收委託的 provider 與帳號。選到未連線、空殼或錯誤市場別帳號。
商品代號券商認得的下單商品；可與圖表顯示名不同。把暱稱當成真實合約代碼。
月份／交易所期貨合約月份與市場資訊。近結算仍用舊月份；海外交易所留白。
口數比例每 1 口圖表部位對應幾口券商部位。比例放大後超過 MaxQty 或風險上限。
啟用是否參與鏡單計畫。設定完成卻忘記啟用，或測試後忘記關閉。
意圖部位系統記住的路由目標影子帳；不一定等於真實券商部位。把意圖當成交；未對帳就繼續鏡單。
白板下單被券商未連線或不支援擋下
被擋是安全結果。 畫面顯示券商未連線／不支援時，交易意圖沒有被當成成功。先修正路由與連線，不要重複點擊。
意圖、委託、成交是三件事。 按下按鈕只產生意圖；收到券商委託序號才表示委託被接收；看到成交回報才代表部位真的改變。任何逾時或未知回傳都先核對，絕不重送。Binance 503 unknown 也是 Unknown，不是「失敗可重下」。
19 · RECORDS & AUDIT

19委託回報、下單稽核與交易備忘錄

遇到「到底有沒有送到？」時，依證據層級查：券商回報 → 下單稽核 → 圖表操作日誌 → 交易備忘。不要憑畫面按鈕的顏色猜。

工具能回答的問題保留範圍
委託回報卡／原生回報視窗掛單中、部分成交、已成、已拒、成交明細；原生視窗可進行受控刪單。依券商與本次連線／當日資料。
下單流水卡／稽核視窗意圖來源、確認、實單開關、風控、結果、被擋原因與雜湊鏈健康。今日摘要；完整視窗供追查。
圖表操作日誌規則套用、條件觸發、檔案讀寫、監控與路由訊息。依圖表專案。
交易日誌卡本次連線的進場、成交、平倉、洗價、轉倉事件與個人註解。事件流＋保存到白板的覆盤內容。
交易備忘錄交易計畫、分類、搜尋、心得、待辦與人工決策脈絡。資料庫持久化。
檢討卡／AI 覆盤期間性總結與異常摘要。白板保存；AI 內容仍需人工判讀。

看到異常時的處理順序

  1. 先停止重複操作。 尤其是「可能已送達」「逾時」「結果未知」。
  2. 查看券商原生／API 回報，確認是否已有委託序號、掛單或成交。
  3. 打開下單稽核，閱讀是哪一道閘放行、拒絕或失敗。
  4. 核對圖表真實部位、券商真實部位與路由意圖部位；需要時使用「對帳／同步意圖」的 state-only 功能，確認它不會送單。
  5. 把時間、商品、帳戶、方向、口數、訊息與最後處理結果記入交易備忘錄。
稽核健康復原：雜湊鏈可偵測竄改（tamper-evident），不是不可變儲存。若下單稽核顯示鏈斷裂或 durable write 失敗，先停止實單、備份 OrderAudit/ 與相關 log、修復磁碟/權限/防毒阻擋後重新驗證；OrderAudit.FailClosedOnWriteFailure=true 時 live admission 會 fail-closed。
刪單是金流操作。 白板卡只顯示回報；真正刪單必須在原生委託／成交回報視窗執行，並經券商能力與安全檢查。
20 · WEBUI & KLINE

20WebUI、分享與 K 線資料

QT3 內建本機 Web 監控頁，可看專案卡、K 線、訊號、權益與績效。預設 HTTP Port 是 7878、HTTPS Port 是 7879。

本機使用

  1. 確認底部「Web 服務」狀態正常；或從 Ribbon 開啟 Web 監控。
  2. 瀏覽 http://localhost:7878/。專案列表會背景更新，不應反覆清空閃爍。
  3. 點專案卡進入詳情，檢查 K 線、買賣訊號、權益與資料時間。
  4. 看到載入失敗、尚無資料或資料過期時，按頁內「重試」並檢查來源檔，而不是一直重新整理整頁。

K 線目錄與週期

GOrder/{ProjectID}/Klines/{interval}.csv
內建記錄週期：1m、5m、15m、30m、60m、1d。每個 ProjectID 必須與圖表專案一致。

日線 business date 會以 UTC midnight 序列化；API 讀取採 bounded-tail，不會為了顯示近端 K 線保留整份歷史 CSV。

圖表空白通常不是瀏覽器壞掉。 先檢查對應專案的 Klines 目錄、CSV 格式、資料筆數與時間順序；再看 WebUI 的錯誤 overlay。

對外分享的安全順序

STEP1

建立長且不可猜的 Embed Token

在帳戶設定的 Web 伺服器頁設定。Token 屬於秘密，會以 DPAPI 加密保存。

STEP2

限制來源與網路

預設 AllowExternal=false，只允許本機。真的要對外時，限制 AllowedOrigins、防火牆與反向代理，不要直接暴露整個桌面環境。

STEP3

分享唯讀連結

保留網址中的 k token；白板可使用 ?readonly=1 隱藏操作 UI，並只輪詢唯讀快照。

MCP 動作預設關閉。 WebServer.Mcp.AllowActions 預設為 false。即使開啟，AI／MCP 提議修改規則或下單也必須回到 QuantTrader 原生視窗人工確認。
21 · STATUS & FRESHNESS

21狀態與資料新鮮度

第四版介面把狀態文字統一成可判讀語言。數字存在不代表它仍有效；每次決策都要連同時間與來源一起看。

資料新鮮度狀態機 狀態會自動轉移：尚無資料、載入中、運行中、資料過期、失敗重試、狀態未知；unknown 不會自動變 ok。 尚無資料 尚未收到第一筆 載入中 背景讀取未完成 運行中 ✓ 服務啟動＋資料流動 資料過期 超過新鮮度門檻 失敗／重試 本輪讀取失敗 狀態未知 ⚠ 無法證明目前狀態 開始讀取 收到資料 逾門檻（匯率 24h／保證金 48h） 讀取失敗 重試成功 快照消失／心跳過期 來源恢復 → 重新載入 關鍵觀念：「運行中」只代表服務活著；要確認資料仍在新鮮度門檻內才算有效。未知 ≠ 0 ≠ 空手。
圖 9 · 新鮮度狀態機——狀態會隨時間與讀取結果自動轉移；看到過期／未知時先更新來源，不要拿舊值決策。
狀態代表什麼建議行動
運行中服務／監控已啟動，未必代表資料正在變動。再看最後更新時間與報價。
已停用使用者或預設設定關閉。確認是否真的需要啟用；不要為消除灰燈而亂開金流功能。
資料過期有舊值，但超過允許時間。更新來源並核對；不要直接以舊值試算或送單。
尚無資料尚未收到第一筆有效資料。查連線、ProjectID、檔案與帳戶權限。
狀態未知系統無法證明目前狀態。以保守方式處理；不要把 unknown 當成 0 或空手。
載入中背景讀取尚未完成。等待；若長時間不結束再查 Log。
失敗／重試本輪讀取或服務呼叫失敗。閱讀頁內原因，修正後使用重試。

常見新鮮度來源

  • 報價：只有價格真的更新才刷新時間；券商停跳後不能永遠覆蓋仍在更新的圖表價。
  • 帳戶快照：看 asOfUtc 或畫面最後更新；橋接快照不存在或心跳過期時應顯示未知。
  • 匯率：預設陳舊門檻 24 小時；跨幣別損益可能失真。
  • 保證金：預設陳舊門檻 48 小時；部位與風險試算可能失真。
  • 總體績效／白板權益：屬於較低頻推送，不應期待每個 tick 都更新。
Fail-closed 的意思：真實送單路徑若無法完成必要風控、路由或執行器判定，應拒絕送單。看到拒絕原因要修正前置條件，不要用另一條路徑繞過。
22 · BACKUP & UPGRADE

22備份、移機與版本更新

QT3 同時使用 SQLite、設定 JSON 與檔案式圖表資料。只複製單一資料庫，可能遺漏 GOrder 部位／K 線與加密設定。

備份拓樸圖 QuantTrader 行程寫入五類資料：QTDB.sqlite、GOrder 目錄、WhiteboardSettings.json、WhiteboardLayout.json 與自訂資料檔，全部都要一起備份。 QuantTrader 執行中的寫入來源 QTDB.sqlite（＋-wal／-shm） 專案／商品／策略／績效／備忘／白板 GOrder／ 整個目錄 Info／CurrentPos／Record／Klines WhiteboardSettings.json 設定＋秘密（DPAPI 綁 Windows 使用者） WhiteboardLayout.json 相容／備援佈局（若存在） 自訂資料檔 RolloverDates／Signals／匯入資料 Backup／2026-07-19／ 程式完全關閉後整組複製 紅框＝絕對不能漏（漏了部位或紀錄就找不回來）；黃框＝換機後秘密欄位要重填（DPAPI 預期行為）。
圖 10 · 備份拓樸——QT3 的資料分散在資料庫、GOrder 檔案與設定 JSON；只備其中一項等於沒備份。

完整備份清單

項目內容注意
QTDB.sqlite專案、商品、貨幣、策略、績效、交易備忘與多白板資料。若有 -wal／-shm 必須一起複製。
GOrder/各 ProjectID 的 Info、CurrentPos、Record、Strategies 與 Klines。部位資料是檔案式，不只在資料庫。
WhiteboardSettings.json白板／Web／券商／安全開關等設定。秘密欄位綁定 Windows DPAPI，換機後要重填。
WhiteboardLayout.json無資料庫白板儲存時的相容／備援佈局。若存在就一起備份。
通知、轉倉與自訂資料檔例如 RolloverDates、Signals 與使用者匯入資料。依實際部署目錄一併保存。

安全備份步驟

  1. 停止監控，確認沒有正在送單、寫檔或資料匯入。
  2. 正常關閉 QuantTrader，等待行程完全結束。
  3. 複製上述檔案與目錄到有日期的備份資料夾，例如 Backup/2026-07-19/。
  4. 檢查檔案大小，不要只看資料夾已建立。
  5. 更新後先在實單關閉狀態啟動，核對專案、白板、帳戶與 GOrder 路徑。
GlobalVariable.dll 的正確觀念： 它是 MultiCharts 的原生 Win32 DLL（用來讀取 MC 全域變數），不是授權元件——授權驗證由主程式以加密設定獨立完成，與此 DLL 無關。目前版本程式碼中它唯一的呼叫點已被註解，屬於保留的相容檔案。更新時仍建議以正式發行包為單位整包配套，不要從其他電腦任意拼湊 DLL。
還原測試比備份本身更重要。 定期在隔離副本上確認資料庫可開啟、GOrder 對應正確、白板可載入。無法還原的備份不能算完成。
23 · TROUBLESHOOTING

23故障排除：先判斷是哪一層

用「畫面 → 資料 → 路由 → 券商 → 回報」順序定位。一次只改一個條件，改完留下時間與結果。

故障排除決策樹 從症狀出發分四支：資料不更新、白板空白、下單被擋、回報未知，各自收斂到第一檢查點。 🔍 症狀是什麼？ 先分流，再動手 📡 資料不更新 報價／部位靜止 ① 查 GOrderID 兩邊一致 ② 查 Info.txt ≥ 23 欄 ③ 查「啟動圖表交易」已勾 → 仍不行：看操作日誌鎖檔 🖥 白板空白／卡不見 載入失敗或誤刪 ① 等前端 ready 再操作 ② 查 WebView2 與發布檔 ③ Ctrl+Z／快照還原 → 仍不行：查主程式 Log 🚫 下單被擋 意圖遭拒絕 ① 讀下單流水的拒絕原因 ② 對照第 13 章各閘預設 ③ 修正前置條件 → 被擋是安全結果，勿繞道 ⚠ 可能已送達 逾時／結果未知 ① 絕對不要重送 ② 查委託／成交回報 ③ 與券商端核對序號 → 確認無單才人工下一步 都不像？→ 收集資訊再回報 時間／版本／GOrderID／截圖／Log（秘密遮罩） 一次只改一個條件，並記下「改了什麼、結果如何」——這是能否被支援的分水嶺。
圖 11 · 排除決策樹：先分流到四支之一，照順序查；每支的詳細說明見下方對應問答。
監控已啟動，但報價／部位不更新

先確認該圖表真的勾選「啟動圖表交易」，再核對 MC 與 QT3 的 GOrderID。檢查 GOrder/{ID}/Info.txt 是否存在、是否持續更新、是否至少含 23 欄且數字用小數點格式。最後看圖表操作日誌是否有檔案鎖定或格式錯誤。

白板載入空白或卡片不見

先等前端 ready，不要連續切頁。確認 WebUI/whiteboard 發布檔存在、WebView2 Runtime 可用；再切換白板、清除搜尋與檢查縮放。誤刪／誤移可用 Ctrl+Z 或具名快照還原。仍無法載入時查主程式 Log 與資料庫白板紀錄。

券商顯示未連線或帳戶清單空白

確認券商已啟用、憑證已成功儲存、Windows 時間正確、網路可用、帳號具有對應市場權限。群益要核對國內／國外市場別；幣安要確認 API Key 權限與 Base URL。元大目前是空殼，不會因重連變成可實單。

下單被擋

依下單流水的拒絕原因檢查：實單關閉、DryRun、MaxQty、風控規則、交易時段、Kill Switch、連發斷路器、路由未啟用、券商未連線、商品／月份無法解析、執行器不支援。被擋是預期安全結果，不要換入口繞過。

送單逾時或顯示「可能已送達」

不要重送。 立即到委託／成交回報視窗與券商端查詢，記下時間、商品、方向、口數與可能的序號。只有在確認券商沒有任何委託或成交後，才依人工程序決定下一步。

WebUI 無法啟動或 Port 被占用

看底部 Web 狀態與 Log，確認 WebServer.Enabled、7878／7879 是否被其他程式使用。需要改 Port 時從設定調整並重新載入 Web 服務；防火牆與 AllowExternal 是不同層，不要為了排查直接對外開放。

換機後券商密碼／Token 變空

這是 DPAPI 的預期行為。秘密欄位以原 Windows 使用者加密，不能直接搬到新機解密。請在新機帳戶設定重新輸入並儲存；不要把明文寫回 App.config。

高 DPI、多螢幕或遠端桌面顯示異常

先收合 Ribbon／導覽並確認 Windows 顯示比例。專案已支援 DPI 與硬體加速自動偵測，但 100%、125%、150%、200%、多螢幕與 RDP 仍需要實機驗收。請記錄螢幕、比例、主題與畫面截圖再回報。

回報問題時請附上

  • 發生時間（含時區）、版本、Windows 顯示比例與是否遠端桌面。
  • 圖表 GOrderID、商品、券商、帳戶遮罩、方向與口數。
  • 全域狀態列、下單流水／回報畫面截圖與相關 Log；秘密欄位必須遮蔽。
  • 你預期什麼、實際看到什麼、是否可重現、已嘗試哪些步驟。

常見狀態訊息與拒單原因對照表

看到紅字或拒絕時，先查這張表。共通原則：被擋是安全結果，不要換入口繞過。

訊息／現象底層原因絕對不要正確動作
可能已送達／結果未知網路逾時或回報未完成，系統無法確認券商是否收到。重送查委託／成交回報與券商端，核對序號後人工處理。
實單關閉Whiteboard.LiveTrading.Enabled 未開啟（預設關）。為了「試一下」直接開實單先用 DryRun 驗證；確認後再開總開關。
DryRun 預演中Whiteboard.DryRun.Enabled 開啟，只記錄不送單。以為沒送單是故障這是預期行為；要真單請關 DryRun 並完成實單前檢查清單。
超過 MaxQty單筆口數超過設定的最大口數。拆多筆繞過上限降低口數，或評估後調整 MaxQty 並記錄理由。
風控規則拒絕盤前風控（時段／部位／商品／自訂）不符合。關掉風控規則硬送理解是哪條規則、為什麼存在；必要時調整規則而非繞過。
Kill Switch／全部停用緊急停止狀態仍生效。反覆嘗試送單確認停用原因，解除後先小單驗證。
連發斷路器觸發短時間內送單過於頻繁或異常。換一張卡繼續點停下來看流水：是誰在連發？修掉來源再恢復。
券商未連線／執行器不支援券商連線中斷，或該券商尚未實作此功能（例如元大空殼）。以為重啟程式就好查券商設定與帳號權限；空殼券商不可實單。
資料過期匯率（24h）／保證金（48h）／報價超過新鮮度門檻。拿舊值試算或送單更新來源（匯率助手／保證金匯入／確認報價）再繼續。
狀態未知快照不存在或心跳過期，系統無法證明目前狀態。把未知當 0 或空手以保守方式處理；查連線與橋接狀態。
商品／月份無法解析路由商品代號或合約月份券商認不得。把暱稱當真實代碼再試核對券商認得的實際合約代碼與月份。
24 · GLOSSARY

24新手術語表

介面與手冊統一使用下列繁體中文術語。理解這些詞，可以避免把資料、意圖與真實資金狀態混在一起。

術語白話說明
圖表交易專案一個由 GOrderID 識別的 MC 圖表與 QT3 風控／部位設定集合。
監控QT3 持續讀取圖表資料、更新狀態並評估規則。監控開啟不等於實單開啟。
交易意圖（intent）「想執行什麼」的請求；尚未代表券商收到，更不代表成交。
委託券商已接收的訂單，可能掛單、部分成交、已成或已拒。
成交市場實際撮合，才會改變真實券商部位。
意圖部位／影子帳系統為鏡單路由記住的目標；必須與真實部位對帳，不能當成交證明。
實單總開關允許真實送單的最高層明確開關，預設關閉。
DryRun／預演走流程與記錄但抑制真實送單，用於驗證設定。
AutoTrade允許受控自動路徑略過逐筆確認；不是略過所有安全檢查。
Fail-closed必要判定失敗時拒絕真實送單，保守停下而不是猜測放行。
Kill Switch／全部停用緊急停止自動化／金流路徑的總控狀態。
斷路器短時間連續或異常送單時自動阻擋，避免失控連發。
資料新鮮度某筆報價、帳戶、匯率或保證金距離最後有效更新多久。
MaxQty單筆允許的最大口數；超過就拒絕。
盤前風控送單前依交易時段、部位、商品與自訂規則做的檢查。
回撤（Drawdown）權益從高點往下跌的幅度，用來衡量策略最痛的期間。
基準貨幣把不同計價幣別損益換算到同一單位，預設 TWD。
25 · FAQ

25常見問題

遇到狀況先看這裡，多數問題都有快速解法。

啟動監控後，資料一直不更新？

最常見的原因有兩個：

① Info.txt 欄位不足——它必須包含完整的 23 個欄位。請在 MultiCharts 匯入官方 @QuantTrader_Connect 訊號來自動輸出，不要手寫。
② 沒勾選「啟動圖表交易」，或兩邊的 GOrderID 不一致。確認後重新開始監控即可。

Telegram 收不到通知？

請逐一確認：Bot Token 是否正確、Chat ID 是否正確、機器人是否已經和你（或群組）建立過對話。三者都對通常就能收到推播。

LINE 通知沒反應？

LINE Notify 已於 2025 年 4 月終止服務，無法再申請或使用權杖。請改用 Telegram（見第 10 章），這是目前主要支援的通知管道。

對外嵌入的圖表是空白的？

幾乎都是 token 問題。請確認：① 已在「帳戶設定 → Web 伺服器」設定對外嵌入 Token；② 嵌入網址結尾有帶 &k=你的Token。頁面載得出來但沒資料，就是少了這把鑰匙。（本機 localhost 自己看不用 token。）

要怎麼備份我的資料？

請在程式完全關閉後，備份 QTDB.sqlite（以及同目錄的 -wal／-shm）、整個 GOrder/、WhiteboardSettings.json，以及存在時的 WhiteboardLayout.json。資料庫保存專案與紀錄，GOrder 保存檔案式部位與 K 線，缺一不可。完整清單見第 22 章。

程式關閉很慢、好像卡住了？

這通常是正常的。關閉時，QT3 會等背景的監控工作安全收尾，可能需要幾秒鐘。請耐心稍候，不要強制結束，以免資料沒存好。

我可以手動（主觀）進場嗎？

可以。在圖表交易控制台或受支援的帳戶／白板入口可手動下達主觀進場。手動路徑預設逐筆原生確認，而且實單總開關預設是關的。送出後仍要到委託／成交回報核對結果。

開啟 AutoTrade 後，所有確認與風控都會消失嗎？

不會。AutoTrade 只讓受允許的自動路徑略過逐筆確認；實單總開關、DryRun、單筆最大口數、盤前風控、連發限制、Kill Switch、路由健康與券商執行器能力仍會檢查。AI／MCP 動作仍強制人工確認。

為什麼畫面顯示「可能已送達，勿重送」？

代表系統無法確認券商是否收到委託，例如網路逾時或回報未完成。請勿再次按下單。 先到委託／成交回報視窗與券商端查詢，核對商品、方向、口數、時間與委託序號，再依人工程序處理。

停損模式那麼多，新手該選哪個？

建議停損用 ATR、倍數 1.5～2.5；出場位置追蹤選 「進場後獲利創高點追蹤」；獲利回吐保護設 20～30%。這組設定穩健、好理解，是很好的起點，之後再依你的風格微調。

APPENDIX A · SHORTCUTS

A快捷鍵總表

手冊與程式中用得到的快捷鍵一次收齊。白板快捷鍵在白板聚焦時生效；手冊快捷鍵在本頁生效。

交易白板（工作空間）

按鍵功能備註
Ctrl+K搜尋卡片／帳戶／圖表並聚焦模糊搜尋，Enter 跳轉。
Ctrl+J開關 AI 管家（盤況敘事／覆盤）唯讀分析；唯讀模式下停用。
F縮放至全覽（fit view）找不到卡片時按一下。
Ctrl+Z復原誤刪、誤移卡片可還原。
Ctrl+Y重做搭配復原使用。
Delete刪除選取的卡片／連線可先快照再刪。
Ctrl+Shift+P效能 HUD顯示渲染與推送效能指標。

本手冊

按鍵功能備註
/聚焦全文搜尋框在輸入框以外任何位置按。
Enter跳到第一個搜尋命中章節搜尋框聚焦時。
Esc清除搜尋／關閉放大圖／關閉目錄抽屜依目前焦點而定。
提示：列印本頁（或整份手冊）可用瀏覽器 Ctrl+P；手冊已內建列印樣式，會自動展開問答、隱藏導覽。