使用說明書

AI Trade Flow — 圖文並茂操作指南

← 回到儀表板

本平台是一個 AI 驅動的自動交易系統:以視覺化「工作流」串接行情、技術指標/AI 訊號、風控與下單, 可回測、最佳化參數,並定時自動執行。第一個完整打通的市場是加密貨幣(紙上交易)。

1 · 系統架構

使用者(或排程器)觸發工作流引擎;引擎依序執行各節點:抓行情 → 產生訊號(技術指標或 AI)→ 經風控後下單。下單透過統一的 Broker 介面, 可在「紙上/真實」與「不同市場」間切換。

使用者 / 排程Web · APSchedulerWorkflow 引擎節點圖執行Data Source(行情)策略 / AI 訊號下單 + 風控Brokerpaper / live · ccxt交易所 / Claude

2 · 安裝與啟動

1
設定環境變數

複製範本並填入金鑰。TRADING_MODE 預設 paper(安全)。

cp .env.example .env
# 編輯 .env:設定 ANTHROPIC_API_KEY(AI 節點用)
2
用 Docker 一鍵啟動
docker compose up --build
# 後端  http://localhost:8000  (API 文件 /docs)
# 前端  http://localhost:3000
3
或本機分別啟動
# 後端
cd backend && python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]" && uvicorn app.main:app --reload

# 前端
cd frontend && npm install && npm run dev

3 · 介面導覽

儀表板(首頁)分為以下面板:

Market 行情

輸入代號看 K 線,按「AI Signal」取得 Claude 即時買賣建議。

Workflow Builder

拖拉節點組成交易流程,可 Save 儲存、Run 立即執行。

Backtest 回測

Run 單一回測、Compare all 比較策略、Optimize 最佳化參數。

Portfolio / Schedules / Notifications

即時現金、部位、損益、訂單;排程讓工作流自動執行;成交與訊號即時通知(可外送 webhook)。

4 · 建立並執行工作流

一條典型流程:Data Source → 策略 / AI → Order → Logger。節點以連線傳遞資料。

Data SourceBTC/USDT策略 / AIbuy/sell/holdOrder下單(風控)Logger記錄結果
1
加入節點
於 Workflow Builder 點 + data_source、+ strategy、+ order 等加入節點。
2
設定參數
在節點上填入 symbol(如 BTC/USDT)、策略名稱與參數、下單 quantity。
3
連線
從節點右側圓點拖到下一個節點左側,串成 data_source → strategy → order → logger。
4
執行或儲存
按 Run 立即執行(結果列在下方);按 Save 儲存以便排程。 訊號為 hold 時不會下單。

5 · 回測與參數最佳化

1
單一回測(Run)
選代號與策略、填參數,按 Run,看權益曲線與指標。
2
多策略比較(Compare all)
一次跑完所有策略,依報酬排名,🏆 標示最佳。
3
參數最佳化(Optimize)
對策略參數做網格搜尋,排名後可點「use」一鍵套用最佳參數。
指標解讀
  • Return:策略總報酬率
  • Buy & Hold:買入持有對照組
  • Max DD:最大回撤(越小越好)
  • Trades / Win%:交易次數與勝率

6 · 自動執行(排程)

1
先 Save 工作流
在 Workflow Builder 按 Save,取得工作流編號。
2
建立排程
於 Schedules 面板選擇該工作流、設定間隔秒數(最少 5 秒),按 Schedule。
3
監看與控制
表格顯示每個排程的最後執行時間與狀態,可隨時 running/paused 切換或刪除。

排程由後端 APScheduler 執行,每次觸發都會把結果寫入記錄。

7 · AI 訊號

AI 節點(或 Market 面板的「AI Signal」)會把精簡行情摘要交給 Claude, 回傳結構化的 buy/sell/hold、信心度與白話理由。預設模型 claude-opus-4-8, 需設定 ANTHROPIC_API_KEY。AI 訊號與技術指標策略在工作流中可互換。

8 · 安全須知

  • 預設紙上交易:TRADING_MODE=paper,需明確改為 live 才會真實下單。
  • 風控閘門:每筆下單前檢查單筆金額與部位總值上限,違規會被擋下。
  • 金鑰安全:所有金鑰只存於 .env(已被 git 忽略),切勿寫死或提交。
  • 務必先驗證:上線前以紙上交易與回測充分測試;真實交易具資金風險。

9 · 支援市場

市場券商狀態
加密貨幣Binance(ccxt)✅ 行情 + 紙上交易(可選真實)
台股元大證券⏳ 真實下單骨架;✅ 匯入 CSV 後可離線回測/紙上交易
美股元大複委託 / Firstrade⏳ 真實下單骨架;✅ 匯入 CSV 後可離線回測(Firstrade 為非官方 API)

台股/美股尚未串接真實券商前,可用儀表板的「匯入歷史資料」面板貼上 OHLCV CSV (表頭 timestamp,open,high,low,close,volume),即可選擇該市場進行回測與紙上交易。

更深入的開發者文件見專案 docs/ 目錄。