POC 日內交易系統:安裝與操作手冊(完整版)

版本:2026-11-04 | 適用:全套 zip 內所有元件

這本手冊從零開始,一步一步帶你把整套系統裝起來、每天怎麼用、出問題怎麼查。每一節開頭有「你需要什麼」和「做完會得到什麼」。沒有碰過主機也沒關係,照著打就好。


0. 全套有哪些東西、彼此怎麼接

資料夾 內容 跑在哪 用途
1_原版POC指標與EA/ poc_signal_原版.pine、POC_Intraday_EA.mq5 TradingView、MT5 看圖、MT5 回測
2_雲端機器人/ poc_bot/、poc_bot.zip Oracle 主機 24 小時產生信號,推播到 ntfy 與 Discord
3_獲利模組包/ modules_pack/(246 個資料夾)、POC獲利模組目錄.md TradingView、主機 每個模組獨立的指標與機器人設定
4_回測平台/ 回測中心、三個回測台 HTML 任何瀏覽器 看回測結果(不裝也能開)
5_文件/ 交接文件、策略手冊、安裝教學 — 參考
6_自架平台/ poc_web/、poc_web.zip Oracle 主機 帳號密碼登入的交易日誌+回測中心網站

資料怎麼流動:

幣安行情 ──► poc_bot(主機)──► ntfy 手機 App
                 │              └► Discord 機器人(/status /modules /report …)
                 ├─ backtest.py ──► backtest.json / report.html / modules.html
                 └─ 實盤紀錄 live_trades.jsonl ──► live.json
                                        │
poc_web(主機,8080 埠)◄───────────────┘ 自動讀取,顯示在回測中心
   ├─ 交易日誌(帳號密碼、截圖、筆記)
   └─ 回測中心(01 POC、02 EA、03 模組)
MT5 策略測試器 ──► 報告 .html/.xlsx ──► 02 EA 回測台(手動載入)

建議安裝順序:第 1 節(連主機)→ 第 2 節(機器人)→ 第 5 節(自架平台),其他依需要。


1. 連到你的 Oracle 主機

你需要什麼:Windows 電腦、金鑰檔 pocbot.key(在 C:\Users\USER\)、主機 IP 168.138.195.111。 做完會得到什麼:一個黑色視窗,開頭是 ubuntu@pocbot:~$,之後所有「在主機上」的指令都在這裡打。

1.1 開 PowerShell 並連線

  1. 按鍵盤「Windows 鍵」,輸入 PowerShell,按 Enter。
  2. 貼上這行,按 Enter: ssh -i $HOME\pocbot.key ubuntu@168.138.195.111
  3. 第一次會問 Are you sure you want to continue connecting (yes/no)?,輸入 yes 按 Enter。
  4. 看到 ubuntu@pocbot:~$ 就是連上了。

1.2 常見錯誤

畫面出現 原因 怎麼辦
No such file or directory 金鑰不在那個位置 執行 dir $HOME\*.key、dir $HOME\Downloads\*.key 找到檔案,把路徑換掉
UNPROTECTED PRIVATE KEY FILE / bad permissions 金鑰權限太寬 依序執行:icacls $HOME\pocbot.key /inheritance:r 再 icacls $HOME\pocbot.key /grant:r "$($env:USERNAME):(R)",然後重連
Connection timed out 主機沒開 到 Oracle 網頁 Compute → Instances,確認 pocbot 是綠色 Running,不是就按 Start
Permission denied (publickey) 金鑰不對或帳號打錯 確認帳號是 ubuntu、金鑰是建主機時下載的那把

1.3 把檔案傳上主機(之後會一直用到)

在電腦的 PowerShell(不是主機裡)執行,檔名.zip 換成實際檔名,zip 放在「下載」資料夾:

scp -i $HOME\pocbot.key $HOME\Downloads\檔名.zip ubuntu@168.138.195.111:~

看到 100% 就是傳好了。然後再用 1.1 的指令連進主機。

1.4 主機裡的基本操作


2. 雲端信號機器人 poc_bot

你需要什麼:主機連線、手機裝好 ntfy App、(選用)Discord 伺服器、FRED API 金鑰。 做完會得到什麼:機器人 24 小時跑,手機和 Discord 會收到信號、套保、止盈、止損、暴漲暴跌警告。

2.1 第一次安裝

  1. 把 2_雲端機器人/poc_bot.zip 傳上主機(1.3)。
  2. 連進主機後執行: cd ~ && unzip -o poc_bot.zip && cd poc_bot && chmod +x install.sh && ./install.sh 會安裝 Python 環境、設定台北時區、建立開機自啟的服務 pocbot。
  3. 設定(見 2.3),然後 sudo systemctl restart pocbot。

2.2 更新到新版(已經裝過)

cp ~/poc_bot/config.yaml ~/config.backup.yaml
cd ~ && unzip -o poc_bot.zip
cp ~/config.backup.yaml ~/poc_bot/config.yaml
cd ~/poc_bot && ./venv/bin/pip install -r requirements.txt
sudo systemctl restart pocbot

第一行備份你的設定,第三行還原,這樣不會被新版的空白設定蓋掉。state.json(單號流水號、模組累計)會保留,不要刪。

2.3 設定檔 config.yaml 逐項說明

開啟:nano ~/poc_bot/config.yaml

區塊 欄位 填什麼
ntfy topic 必填。手機 ntfy App 訂閱的主題名稱,取別人猜不到的,例如 poc-k7x2m9q。
discord bot_token Discord 機器人 Token(見 2.5)。留空就不用機器人。
channel_id 要發信號的頻道 ID;留空會自動選名稱含「信號/signal」的頻道。
owner_ids 可用 /pause /resume 的使用者 ID;留空=伺服器管理員。
webhook_url 只想單向發訊息時改填 Webhook 網址(有 bot_token 就以機器人為主)。
news fred_key 建議填。到 https://fred.stlouisfed.org 免費註冊 → My Account → API Keys 申請。用來讀官方公布值。
impacts 監看的數據重要度,預設 [High]。
nq_hawk 數據偏鷹時納指與加密貨幣方向,預設 偏空。
morning_summary 每天早上 8 點推播今日數據。
products 每個商品 enabled: false 可關掉某商品。max_sl 只能更小不能更大(黃金 10、納指 100、BTC 1000、ETH 40)。納指 price_scale = MT5 US100 價格 ÷ 幣安 QQQUSDT 價格,偶爾更新。
modules track true=246 個模組在背景靜默累計。
live 要推播的模組 ID,例如 ["M002", "M017"];all=全部(很多)。
routes 模組專屬頻道,見 2.8。
strategy main_enabled false=不推主策略只推模組。其他參數是打法細節,預設即可。

存檔後一定要 sudo systemctl restart pocbot。

2.4 手機 ntfy 設定

  1. 手機安裝「ntfy」App(iOS App Store/Android Play 商店)。
  2. 打開 → 右下角「+」→ 輸入和 config.yaml 一樣的 topic → 訂閱。
  3. 在主機執行 cd ~/poc_bot && ./venv/bin/python bot.py --test,手機應收到「POC 測試」。
  4. 想讓朋友收信號:告訴他主題名稱,他訂閱同一個主題即可。要停掉他的權限只能換主題名稱。

2.5 Discord 機器人設定(從零開始)

  1. 瀏覽器開 https://discord.com/developers/applications → 登入 → 右上 New Application → 取名(例如 POC 信號)→ Create。
  2. 左欄 Bot → Reset Token → 複製 Token(只顯示一次,馬上貼到 config.yaml 的 bot_token)。
  3. 同頁往下,Privileged Gateway Intents 不需要開。
  4. 左欄 OAuth2 → URL Generator:
  5. Scopes 勾 bot 和 applications.commands
  6. Bot Permissions 勾 Send Messages、Embed Links、Attach Files、Read Message History
  7. 複製最下方的網址,貼到瀏覽器打開 → 選你的伺服器 → 授權。
  8. 取得頻道 ID:Discord 設定 → 進階 → 開「開發者模式」;回到伺服器,對想收信號的頻道按右鍵 → 複製頻道 ID → 貼到 channel_id。
  9. sudo systemctl restart pocbot,頻道會出現「POC 信號機器人啟動」。
  10. 在頻道輸入 / 應該看到指令清單(第一次同步可能要等 1 分鐘,或重開 Discord)。

2.6 Discord 指令

指令 用途
/status 各商品最新價、盤面、持倉、數據是否更新
/positions 目前持倉與掛單(單號、入場、SL、TP、浮動損益)
/today 今天每一單與合計 R
/modules 246 個模組自機器人啟動以來的累計排行
/report 把實盤信號紀錄做成回測台報表(report_live.html、modules_live.html、live.json)上傳
/news 今日重要數據與判讀
/pause /resume 暫停/恢復發新信號(管理員)

2.7 看懂一則信號

【黃金|做多|#XAU-012】趨勢回測(VWAP/POC 共振+Delta)
MT5:XAUUSD
時間:11/04 21:35(美盤・流動性高)
標籤:① 維加斯順向・VWAP 斜率順向・強 Delta・常態日・帶內
入場:市價(參考 3995.20)
SL:−6.40 點(3988.80)
TP1:+9.60 點(1.50R)
TP2:+16.00 點(2.50R)
TP3:+22.40 點(3.50R)
套保:K 棒收盤達 +6.40 點 或 TP1 先到 → SL 移至入場 +0.64 點
出場管理:TP1 減倉 50%,TP2 後 SL 移至 TP1

2.8 賣信號/分流:模組專屬頻道

modules:
  live: ["M002", "M017"]
  routes:
    M002: {discord_channel: "頻道ID", ntfy_topic: "poc-m002-xxxx", only: true}
    "①":  {discord_channel: "頻道ID"}        # 整個打法 ① 的模組都發到這

only: true=只發專屬頻道,不混進主頻道。客戶買哪個模組就給他那個 ntfy 主題或 Discord 頻道。

2.9 日常維護指令

sudo systemctl status pocbot          # 是否運作中(active (running) 為正常)
sudo journalctl -u pocbot -n 50       # 最近 50 行日誌
sudo journalctl -u pocbot -f          # 即時看日誌(Ctrl+C 離開)
sudo systemctl restart pocbot         # 重啟
cd ~/poc_bot && ./venv/bin/python bot.py --test     # 測推播、行情、日曆、FRED
cd ~/poc_bot && ./venv/bin/python bot.py --replay   # 用最近 3 天歷史跑一遍印出信號

3. 回測(backtest.py)

你需要什麼:機器人已安裝(第 2 節)。 做完會得到什麼:report.html(主策略)、modules.html(246 模組)、backtest.json、trades.csv、modules_catalog.md;自架平台會自動顯示。

3.1 指令

cd ~/poc_bot
./venv/bin/python backtest.py --months 12 --discord         # 最近 12 個月,四商品,結果傳 Discord
./venv/bin/python backtest.py --start 2026-01 --end 2026-10  # 指定期間
./venv/bin/python backtest.py --products gold,nq             # 只跑部分商品(gold nq btc eth)
./venv/bin/python backtest.py --live --discord               # 不跑回測,把實盤信號紀錄做成報表
./venv/bin/python backtest.py --catalog                      # 只輸出模組目錄

第一次會下載幣安歷史 1 分 K(每商品每月約 5~10 MB),快取在 data/,第二次很快。12 個月四商品大約 5~15 分鐘。

3.2 怎麼看報表

3.3 結果怎麼解讀


4. TradingView 指標(原版與 246 模組)

你需要什麼:TradingView 帳號(免費版可),圖表開 XAUUSD/US100/BTCUSD/ETHUSD,5 分或 15 分。

4.1 安裝原版

  1. 圖表下方「Pine 編輯器」→ 開啟 → 新增 → 空白指標。
  2. 編輯器內 Ctrl+A 全選、Delete 刪光,再貼上 poc_signal_原版.pine 的全部內容(只貼一次,貼兩次會出現「2 declarations」錯誤)。
  3. 右上「儲存」→「加入圖表」。
  4. 齒輪設定:商品「自動判斷」通常可行,不行就手動選;BTC/ETH 用 15 分圖。
  5. 警報:圖表右上鬧鐘 → 建立警報 → 條件選「POC 日內信號 v2」→ 下拉選「任何 alert() 函數調用」→ 建立。免費版只能收 TradingView App 通知,真正 24 小時推播靠主機機器人。

4.2 安裝某一個模組

  1. 打開 3_獲利模組包/modules_pack/,找要的資料夾(例如 M002_趨勢回測_順勢加碼版)。
  2. 同 4.1 步驟貼上 M002.pine。設定面板「0. 模組」已鎖好條件,不用改。
  3. 一張圖可以同時加好幾個模組指標,各自獨立出信號;標題會顯示模組編號。
  4. poc_module_base.pine 是通用版:加一次,在設定面板切換「打法」和各濾網,就能模擬任何模組。

4.3 紅色驚嘆號/不出信號


5. 自架平台 poc_web(交易日誌+回測中心)

你需要什麼:主機連線(第 1 節)。 做完會得到什麼:一個網址 http://168.138.195.111:8080/,每個人用自己的帳號密碼登入,有交易日誌、截圖、筆記、回測中心。

5.1 安裝

  1. 把 6_自架平台/poc_web.zip 傳上主機(1.3)。
  2. 主機上執行(邀請碼自己取,例如 poc2026;不想要就不填): cd ~ && unzip -o poc_web.zip && cd poc_web && chmod +x install_web.sh && ./install_web.sh 8080 poc2026 最後一行會印出網址。
  3. 開放 Oracle 防火牆(沒做這步外面連不進來):
  4. 登入 https://cloud.oracle.com → 左上選單 → Networking → Virtual Cloud Networks。
  5. 點 pocbot-vcn → 左欄 Security Lists → 點 Default Security List for pocbot-vcn。
  6. Add Ingress Rules:Source Type CIDR、Source CIDR 0.0.0.0/0、IP Protocol TCP、Destination Port Range 8080、Description pocweb → Add。
  7. 手機或電腦瀏覽器開 http://168.138.195.111:8080/,看到登入畫面就成功。
  8. 手機加到主畫面:iPhone Safari → 分享 → 加入主畫面;Android Chrome → 選單 → 安裝應用程式。

5.2 建立帳號與登入

5.3 交易紀錄怎麼用

  1. 左欄「交易紀錄」→ 右上「+ 新增一筆」。
  2. 由上而下:時間(預設現在)、狀態(進行中/已結束)、盤面、小數位(黃金 2、納指 1)。
  3. 點選商品、多空、打法、進場條件(可複選)。任何一組按「+ 新增選項」,輸入名稱,就會永久加到你的選項裡,下次直接點。
  4. 填進場價、SL、TP1~TP3、出場價。R 留空會自動算:(出場 − 進場)× 方向 ÷ |進場 − 止損|。
  5. 出場方式、情緒、標籤、檢討筆記。
  6. 截圖:把圖片拖進虛線框、點虛線框選檔,或在這個表單上直接 Ctrl+V 貼上剪貼簿裡的截圖(Windows 用 Win+Shift+S 截圖後直接貼)。可放多張,點縮圖放大,右上「移除」。
  7. 「儲存」。列表點任一列可再編輯;編輯畫面左下「刪除」要按兩次。
  8. 列表上方可依商品、打法、結果篩選與搜尋。

5.4 儀表板

勝率、合計 R、平均每筆、獲利因子、最大回撤、進行中單數、權益曲線,以及依商品/打法/進場條件/盤面/出場方式/情緒的拆解。只統計「已結束」且算得出 R 的單。

5.5 筆記頁(仿 Notion)

5.6 選項與設定

5.7 回測中心

左欄「回測中心(三台)」或網址 /backtest/: - 01 POC 回測台:自動讀主機 ~/poc_bot/backtest.json(第 3 節跑過就有)。頁首有「切換看實盤信號」,等同網址加 ?src=live,讀 live.json(用 Discord /report 或 backtest.py --live 產生)。 - 02 EA 回測台:載入 MT5 報告(第 6 節)。 - 03 獲利模組庫:同 01,顯示 246 模組。 - 入口頁底部顯示兩個 json 的更新時間。

5.8 維護、備份、重設密碼

sudo systemctl status pocweb          # 狀態
sudo journalctl -u pocweb -f          # 日誌
sudo systemctl restart pocweb         # 重啟

6. MT5 EA 與 EA 回測台

你需要什麼:MT5(Exness)、MetaEditor。

6.1 安裝 EA

  1. MT5 → 工具 → MetaQuotes 語言編輯器(或按 F4)。
  2. 檔案 → 開啟資料夾,會跳出 MQL5 資料夾;把 POC_Intraday_EA_UTF16_給MetaEditor.mq5 複製到 MQL5\Experts\。
  3. 回到 MetaEditor,左側導航 → Experts → 雙擊檔案 → 上方「編譯」。下方「錯誤」分頁應為 0 errors。
  4. 回到 MT5,導航 → EA 交易 → 把 POC_Intraday_EA 拖到 XAUUSD M5 圖表。

6.2 參數

6.3 回測並匯出報告

  1. 檢視 → 策略測試器(Ctrl+R)。
  2. 設定:EA 選 POC_Intraday_EA、商品 XAUUSD、週期 M5、日期自訂、模型「每個 tick 基於真實 tick」、存款、槓桿。
  3. 輸入分頁:執行模式改 RUN_TRADE,其餘預設。
  4. 開始。跑完切到「回測」分頁 → 右鍵 → 報告 → 儲存為 HTML 或 Open XML (xlsx)。
  5. 四個商品各跑一次、各存一份。

6.4 用 EA 回測台看

  1. 開 /backtest/ea.html(自架平台)或 4_回測平台/POC_EA回測台.html。
  2. 右上「MT5 伺服器時區 UTC」改成券商時區(Exness 通常 0)。
  3. 「載入 MT5 回測報告」選檔,可連續載入四份合併。
  4. 打法欄來自訂單註解 POC L|趨勢回測,所以要用這版 EA 跑出來的報告才分得出打法。

7. 每天怎麼用(建議流程)

  1. 早上 08:00:Discord 收到今日數據與預期值,知道幾點要小心。
  2. 盤中:信號來了 → 看模組標籤與盤面 → 決定做不做 → 在 MT5 用點數下單 → 到自架平台「新增一筆」,貼上截圖、勾進場條件。
  3. 套保/TP/止損訊息都帶單號,照著改 SL、減倉。
  4. 收盤後:把交易補上出場價與出場方式、寫檢討;儀表板看今天。
  5. 每週:Discord /modules 看模組排行;/report 產生實盤報表,和回測台比較哪些打法偏離。
  6. 每月:主機 backtest.py --months 12 --discord 重跑,調整 modules.live 與 strategy 開關。

8. 疑難排解總表

症狀 檢查 解法
手機收不到信號 --test 有沒有成功;主題名稱大小寫 重新訂閱主題;sudo systemctl restart pocbot
Discord 沒有啟動訊息 sudo journalctl -u pocbot -n 40 有無「Discord 頻道設定失敗」 Token 重設、機器人有沒有被邀請、頻道權限、channel_id 其實是使用者 ID(改留空)
/ 指令沒出現 邀請時沒勾 applications.commands 重新用 URL Generator 邀請一次
日誌出現「取得數據失敗」 幣安連線 通常短暫;連續 20 次會推播警告,看網路
回測台顯示「還沒有 backtest.json」 主機沒跑過 backtest.py 第 3 節
自架平台連不上 Oracle 安全清單 8080、sudo systemctl status pocweb 5.1 第 3 步;sudo iptables -L INPUT -n 有沒有 8080
截圖上傳失敗 檔案 > 15 MB 或不是圖片 用 PNG/JPG,截圖通常不到 1 MB
兩個人看到同一份資料 用了同一個帳號 各自註冊
Pine 貼上出現 2 declarations 貼了兩次 Ctrl+A → Delete → 只貼一次
EA 編譯錯誤 用了 UTF-8 版 用 _UTF16_給MetaEditor 那份
Oracle 扣了 35 元 信用卡驗證預授權 會退回,Always Free 不收費;預算警示 $1 已設

9. 安全與法規提醒