跳至主要內容

離線回測 Pine Script:48 筆交易一致

方向、時間、價格及淨 P&L,與 TradingView 匯出檔逐列一致。

4,2004,4004,6004,800
8月22日8月23日
USDT

點一下或拖曳圖表,查看任一點的數值。

來源:探針 composite-vcp-fvg-active-zones-01,pineforge-corpus d75b4fa,2025-03-31 至 2026-05-01:CSV 檔案、策略畫廊。

以表格檢視圖表

同一支策略的連續 48 筆交易,畫在所在時段的 178 根 Binance ETHUSDT 永續合約 15 分鐘 K 線上。TradingView 的匯出資料與 PineForge 的成交列表逐列比對,多空方向、進出場時間、進出場價格與淨損益全部一致。

交易方向TradingView 進場PineForge 進場TradingView 出場PineForge 出場TradingView 淨 P&LPineForge 淨 P&L
4,100做多4,306.954,306.954,296.644,296.64−10.31−10.31
4,106做多4,279.174,279.174,276.804,276.80−2.37−2.37
4,112做多4,327.734,327.734,315.744,315.74−11.99−11.99
4,118做多4,272.714,272.714,242.194,242.19−30.52−30.52
4,124做多4,779.504,779.504,760.734,760.73−18.77−18.77
4,129做多4,749.874,749.874,738.934,738.93−10.94−10.94
4,135做多4,718.894,718.894,731.004,731.0012.1112.11
4,141做多4,723.344,723.344,718.714,718.71−4.63−4.63
4,147做多4,752.764,752.764,745.124,745.12−7.64−7.64
量測方式

探針 composite-vcp-fvg-active-zones-01,來自 pineforge-corpus 的提交 d75b4fa:Binance ETHUSDT 永續合約,15 分鐘 K 線,2025-03-31 至 2026-05-01。其中 PineForge 的成交列表,是引擎 v1.0.1 在 2026-10-02 產生的。查看 CSV 檔案,或在策略畫廊中開啟。

PineForge 不用 TradingView,用一個 Docker 映像檔離線回測 Pine Script,交易可重現。

為什麼離線?

瀏覽器回測適合圖表旁快速試錯。離線回測是下一步要押資金時該拿的:需要稽核軌跡、CI 要擋每次 commit、兩個月前的結果今天要能重現,交易一筆不差。

離線回測給你瀏覽器測試器做不到的:結果是具確定性 — 相同的腳本、資料與映像檔版本,得到相同的交易。你可以固定映像檔版本、把報告提交進儲存庫、比對不同提交之間的成交列表,並在 CI 中以無介面方式執行全部流程。你餵入的 CSV 屬於你,引擎在本機執行,報告也會記錄產生它的來源指紋。

實際能做到的事:固定映像檔版本,兩個月前的提交今天仍會得到同一份成交列表;使用你自己的資料,從交易所 K 線到用逐筆資料自行合成的 K 棒都行,只要是 OHLCV 就好;CI 檢查在出現迴歸時讓建置失敗;策略就是一個檔案,不被綁在單一平台上。

若你曾要跟同事分享回測結果,卻發現只能「截圖圖表」— 你缺的就是離線執行。

怎麼離線回測 Pine Script

PineForge 把 PineScript v6 轉譯成原生 C++,並透過單一 Docker 映像檔在你的機器上執行。

三個步驟。映像檔只需拉取一次,之後一切都離線執行。

步驟 1 — 拉下 runtime

一個映像檔:ghcr.io/pineforge-4pass/pineforge-release。不用 pip、不用金鑰、不用註冊:轉譯、編譯與回測全都在裡面離線完成。映像檔內的引擎採 Apache-2.0 授權;內建的轉譯器供個人交易免費使用。

步驟 2 — 把你的 Pine 轉成 C++

以僅轉譯模式執行映像檔,它就會在本機把你的 PineScript v6 轉成一份完整的 C++ 原始檔。回測時不會執行任何 Pine 直譯器:映像檔會把 C++ 編譯成原生碼。

docker run --rm --network=none \
  -e PINEFORGE_TRANSPILE_ONLY=1 \
  -v "$(pwd)/my_strategy.pine":/in/strategy.pine:ro \
  ghcr.io/pineforge-4pass/pineforge-release:1.12.0 > strategy.cpp

步驟 3 — 回測

把你的 OHLCV CSV 與產生的 C++ 放在一起掛載,然後執行映像檔。CSV 需要 timestamp,open,high,low,close,volume 這一列標頭,時間戳記以 UNIX 毫秒表示。引擎會逐根 K 線執行策略,並把 JSON 報告寫到 stdout。你也可以跳過步驟 2:改為掛載 strategy.pine,映像檔會先幫你轉譯。

docker run --rm --network=none \
  -v "$(pwd)/strategy.cpp":/in/strategy.cpp:ro \
  -v "$(pwd)/ohlcv.csv":/in/ohlcv.csv:ro \
  ghcr.io/pineforge-4pass/pineforge-release:1.12.0 > report.json

JSON 報告包含摘要區塊(總交易筆數、獲利與虧損筆數、勝率、淨損益、最大回撤)、完整成交列表(進出場時間、價格、數量、損益與 K 線索引)、獲利因子、夏普比率與索提諾比率等指標、權益曲線,以及這次執行背後引擎、轉譯器、輸入參數與資料的指紋(無法計算時為 null)。

流程就這樣。無 GUI、無反覆登入、無載圖。會跑 Docker,就會跑 PineForge 離線回測。

能回測什麼

簡答:任何能序列成 OHLCV 的東西。PineForge 不接行情商。你帶資料;engine 跑策略。

  • 來自交易所的加密資產。從 Binance、Bybit、Kraken 或任何 REST/WebSocket 交易所拉原始成交。聚合成策略時間框架。直接餵 CSV。用你實際會交易的商品與場所組合測試。
  • 由逐筆資料組成的 K 線。如果你用逐筆成交或委託簿資料自行組出 K 線,就以 OHLCV 格式餵進來。引擎不在乎 K 線從哪裡來。
  • 其他序列。引擎只讀取 timestamp、open、high、low、close 與 volume;多出來的欄位都會被忽略。情緒分數或鏈上指標,必須編碼進這些欄位才能回測。

畫廊中的 312 支策略來自公開策略集,每支都對照 TradingView 自家的匯出資料評級。在引擎 main 分支上,策略集檢查將其中 311 支鎖定為優異:交易筆數相同,第 90 百分位數的價格誤差在 0.01% 以內、損益在 1% 以內;其中 7 支使用 trail_* 出場的策略以正式環境設定檔評級,出場價格與損益的限制較寬。剩下 1 支是已宣告的異常。對於優異等級,當 TradingView 在完全相同的時間、價格和方向上顯示兩個或以上不同的進場 Signals 時,引擎也在該處顯示相同數量的獨立進場(獨立進場識別)。

下一步