我們的券商模擬器在成交時,用下一根 K 棒的開盤價檢查保證金;TradingView 則是在訊號時,用當根收盤價檢查。兩個價格只差 3 美分,就足以讓一筆用滿全部權益的訂單被拒絕。六支隔離探針如何把一支社群策略的損益漂移,一路追查到這道保證金檢查。
本文數據量測於 2026年5月9日,並保留當時的原貌。最新結果請參閱我們如何衡量一致性。
我們對齊語料庫裡有一支叫 IES 的社群 Pine 策略。我們用嚴格門檻替每一支策略評定等級之後,它是唯一一支對 TradingView 的對齊等級落在 moderate 的策略。交易筆數對得上,進場價對到分,出場價也對到分。但到了 2026 年 4 月,兩邊的累積損益已經相差約 29,000 美元。
這篇文章記錄我們如何找到原因:一個晚了一根 K 線才執行的保證金檢查。
不對稱的指紋
在我們開始深挖之前,verify_corpus.py 對這支策略的報告如下:
community/IES (pre-fix)
Profile: strict
TV trades: 2668 (raw 2668)
Engine trades: 2663 (raw 2663)
Matched: 2632 (98.7% of TV)
Count delta: 0.1874% (OK)
Entry-price p90 delta: 0.0000% (OK)
Exit-price p90 delta: 0.0000% (OK)
PnL p90 delta: 2.5412% (X)
-> moderate
光是這一行,就很有診斷價值。當交易筆數、進場價與出場價全部一致,每筆交易的損益卻漂移了 2.5%,你面對的就不是訊號邏輯的 bug,也不是成交價的 bug。兩個引擎在同樣的價格選了同樣的交易,只是部位大小算得不一樣。
接近比對區間尾聲時,引擎在每一筆吻合交易上的 qty,都大約是 TradingView 的 97.3%,和兩個帳戶的權益比例相同。分歧出在 strategy.equity——每一條部位計算公式都依賴的遞迴回饋變數——而不在任何一筆交易的算術上。
我們先試了什麼(以及為什麼都沒用)
在找到正確的假設之前,我們接連押錯了三個。這些值得說一說,因為這才是除錯的真實樣貌:大部分的工作是推翻假設,而不是證實假設。
指標暖機期不一致。 引擎會在比對區間開始前,先用五個月的 OHLCV 替技術分析堆疊暖機;TradingView 圖表的歷史資料未必有那麼長。我們做了一套逐根 K 線追蹤技術指標的工具,過程中還真的找出九個指標 bug——ta.pivothigh / ta.pivotlow 的語意、ta.iii 公式、ta.tsi 的 codegen 與縮放、ta.cog 權重、ta.bbw 百分比、ta.vwap 的每日錨點、ta.supertrend 的線值、ta.pivot_point_levels 的前一根 K 線 HLC,以及 ta.cross 略過平手的語意。九個全都修好了,卻沒有一個能讓 IES 脫離 moderate。
停損/限價的成交時機。 另一支社群策略(scalping-wunder-bots)有個很明確的模式:引擎比 TradingView 早一根 K 線出場。我們假設引擎在進場那根 K 線上就評估了 strategy.exit 的停損,而 TV 則延到下一根。於是我們做了 parity-probe-01-stop-limit-timing,專門隔離這一點。結果是 778 筆交易中有 778 筆吻合,四道嚴格門檻全部通過。假設被推翻了。
CHoCH/BOS 波段追蹤。 還有一支策略(VCP)在 2025-05-12 12:15 多出一筆不該出現的進場,我們懷疑是樞紐點狀態的演變出現分歧所致。我們做了 parity-probe-02-choch-bos-isolator,完全複製它的樞紐點特徵。1026 筆中有 1026 筆吻合。 又被推翻了。
三個假設試下來,IES 毫無起色,倒是多了一條新的方法論:寫出最小的 Pine 策略、一次只隔離一個假設,遠比在一支 700 行的社群腳本裡追內部變數快得多。於是我們寫了第三支探針。
揪出問題的那支探針
parity-probe-03-equity-mirror 的巧妙之處在於,下單數量本身就編碼了 strategy.equity:
//@version=6
strategy("Parity probe 03 - equity mirror",
shorttitle="par_p03", overlay=true, initial_capital=1000000,
default_qty_type=strategy.fixed, default_qty_value=1,
pyramiding=0, process_orders_on_close=false,
commission_value=0, slippage=0)
bool fire = dayofweek == 2 and hour == 0 and minute == 0
and strategy.position_size == 0
float qty_dyn = math.round(strategy.equity / close * 1000) / 1000
if fire and qty_dyn > 0
strategy.entry("E", strategy.long, qty=qty_dyn)
if strategy.position_size > 0 and bar_index >
strategy.opentrades.entry_bar_index(0)
strategy.close("E")
qty = round(strategy.equity / close * 1000) / 1000 四捨五入到小數點後三位,這代表 TradingView「交易清單」CSV 匯出的 Size (qty) 欄,會逐根 K 線把 TV 端的 strategy.equity 數值透露出來。依進場時間戳記把引擎和 TV 的交易配對、把 qty 欄並排,就能直接從 diff 讀出權益的分歧。
前八筆吻合的交易:
2025-03-31 00:15 eng_qty=553.1490 tv_qty=553.1490 diff=+0.000%
2025-04-14 00:15 eng_qty=612.9970 tv_qty=612.1600 diff=+0.137%
2025-04-21 00:15 eng_qty=623.1630 tv_qty=622.3110 diff=+0.137%
2025-08-25 00:15 eng_qty=207.2020 tv_qty=209.8110 diff=-1.244%
2025-11-03 00:15 eng_qty=242.4760 tv_qty=251.9860 diff=-3.774%
2025-11-24 00:15 eng_qty=339.1820 tv_qty=361.0170 diff=-6.048%
2025-12-22 00:15 eng_qty=307.0180 tv_qty=330.5680 diff=-7.124%
2026-01-05 00:15 eng_qty=295.2650 tv_qty=320.1020 diff=-7.759%
第 1 筆交易完全吻合,兩邊都從 100 萬美元的權益起步。從第 2 筆開始,兩邊的 qty 欄就分道揚鑣,再也沒有收斂回來。到第 8 筆時,差距穩定在 7.76% 左右。
原因不是計算上的漂移,而是漏掉了一筆交易。原本應該是第 2 筆的那次進場(2025-04-07),出現在 TV 的交易清單裡,卻沒有出現在引擎的清單裡。TV 接下了這筆交易,吃下 1,345 美元的虧損,權益降到約 984k 美元。引擎始終沒有進場,所以權益停在約 985k 美元。接下來兩筆交易,引擎的部位都比 TV 大 0.137%;在那之後,兩邊接受和拒絕的週一各不相同,累積虧損沿著不同的權益路徑分岔,差距從此再也沒有消失。
幽靈成交
我們在 strategy_entry、process_pending_orders、enter_market_from_flat 和 apply_market_order_fill 裡加上 std::cerr log,並全部用環境變數控制開關,免得這些雜訊混進其他測試。
在訊號 K 線,2025-04-07 00:00:
[entry CALL] ts=1743984000000 bar=16236 id=E is_long=1 qty=627.312
pending_orders.size=0 pos_qty=0 pos_side=0
strategy.entry 被呼叫了,訂單也進了佇列。到目前為止都沒問題。
在成交 K 線,2025-04-07 00:15:
[ppo] ts=1743984900000 bar=16237 pass=0 i=0 id=E type=0 is_long=1
qty=627.312 eligib=FILL_TRY
-> fill.kind=0 fill_price=1566.69
-> AFTER apply: pos_qty=0 pos_side=0 pyramid.size=0 trades.size=14
fill.kind=0 就是 FillEvaluation::Kind::Fill。價格評估器說要成交,apply_filled_order_to_state 也被呼叫了,部位狀態卻沒有更新。一筆幽靈成交。
再加一行除錯輸出,這次放在 enter_market_from_flat 裡,印出保證金防線的輸入值:
[margin] ts=1743984900000 qty=627.312 fill_px=1566.69 margin_pct=100
required=982803 available_equity=982785 net_profit_sum=-17215.4
initial=1e+06 block=YES
所需保證金:982,803 美元。可用權益:982,785 美元。保證金防線要求的金額比帳戶現有的多出約 19 美元,於是提早 return,沒有更新任何狀態,也沒有產生錯誤或任何公開的 log。從策略的角度來看,這筆交易根本不存在。(這次除錯執行是從暖機資料的一開始就進行交易,所以它的權益和 qty,跟下面那次比對執行略有出入。)
為什麼 TradingView 接下了同一筆交易
相關的兩根 K 線 OHLC 如下:
04-07 00:00 (signal): O=1579.98 H=1585.57 L=1566.00 C=1566.66
04-07 00:15 (fill): O=1566.69
探針以訊號收盤價計算下單數量:qty = round(985319.43 / 1566.66 * 1000) / 1000 = 628.93。以訊號收盤價計算的所需保證金,只比可用權益多出四美分;以下一根 K 線的開盤價計算,則超出 18.91 美元。
| 使用的價格 | 所需保證金 | 權益 | 超出金額 |
|---|---|---|---|
| 訊號收盤價($1566.66) | $985,319.47 | $985,319.43 | +$0.04 |
| 成交開盤價($1566.69) | $985,338.34 | $985,319.43 | +$18.91 |
ETH 只動了三美分,乘上 628.93 張合約,就多出 18.87 美元的所需保證金,總共超出 18.91 美元。引擎的保證金檢查發生在成交時,用的是成交價——於是拒絕了。我們這時認為,TradingView 的券商模擬器是在訊號時用訊號收盤價做同樣的檢查——於是放行,因為在 985k 美元的部位上,四美分的差距低於 TV 在邊界上採用的浮點數容差,不論那個容差是多少。
再用三支探針交叉定位
為了證明這不是單筆交易的巧合,而且這個 bug 確實只跟 1 倍權益邊界有關,我們又做了三支探針,從不同距離把這個邊界夾住:
| 探針 | 部位計算 | 保證金壓力 |
|---|---|---|
parity-probe-04-percent-of-equity-sizing | default_qty_type=percent_of_equity, default_qty_value=99 | 約 99% 權益 |
parity-probe-05-small-equity-fraction | qty = round(equity / close * 100) / 1000 | 約 10% 權益 |
parity-probe-06-edge-margin-sizing | qty = round(equity * 0.5 / close * 1000) / 1000 | 約 50% 權益 |
我們將三支探針的引擎交易清單,分別與 TradingView 交易清單(Strategy Tester › List of trades)比對:
parity-probe-04: TV=57 engine=57 matched=57/57 (100.0%) PnL p90=0.0006% → excellent
parity-probe-05: TV=57 engine=57 matched=57/57 (100.0%) PnL p90=0.0698% → excellent
parity-probe-06: TV=57 engine=57 matched=57/57 (100.0%) PnL p90=0.0700% → excellent
只要部位大小沒有釘在 1 倍保證金邊界上,引擎和 TV 在每支探針的全部 57 筆交易上都完全一致。這個 bug 只在邊界上現形:訊號收盤價和成交開盤價之間的滑價,足以翻轉保證金檢查的結果。
修正方式
把保證金檢查從 enter_market_from_flat(在成交時執行,使用成交價)移到 strategy_entry(在訊號時執行,使用當根 K 線的收盤價):
void BacktestEngine::strategy_entry(const std::string& id, bool is_long,
double limit_price, double stop_price,
double qty, ...) {
if (!trading_is_active(...)) return;
+
+ // TradingView broker rule: market-entry orders are admitted only
+ // when qty * <signal-bar close> * margin_pct/100 <= equity. Check
+ // happens HERE at signal time with current_bar_.close, NOT later
+ // in apply_market_order_fill where fill_price is the next bar's
+ // open. Verified empirically by parity-probe-{03..06}.
+ if (!std::isnan(qty) && std::isnan(limit_price) && std::isnan(stop_price)) {
+ double margin_pct = is_long ? margin_long_ : margin_short_;
+ if (margin_pct > 0.0 && !std::isnan(current_bar_.close)) {
+ double required = std::abs(qty) * current_bar_.close * (margin_pct / 100.0);
+ double available = current_equity();
+ double epsilon = std::max(1e-9, std::abs(available) * 1e-12);
+ if (required > available + epsilon) {
+ return;
+ }
+ }
+ }
...
strategy_entry 裡大約十幾行(實際的 commit 附有更長的註解),外加從 enter_market_from_flat 刪掉對應的八行。在 IES 上重跑:
community/IES (post-fix)
TV trades: 2668 (raw 2668)
Engine trades: 2643 (raw 2643)
Matched: 2618 (98.1% of TV)
Count delta: 0.9370% (OK)
Entry-price p90 delta: 0.0000% (OK)
Exit-price p90 delta: 0.0000% (OK)
PnL p90 delta: 0.7809% (OK) ← was 2.5412%
-> excellent
損益漂移從 2.54% 降到 0.78%,IES 從 moderate 升到 excellent。當時語料庫的其餘部分:168 支策略中有 165 支是 excellent、2 支是 strong、0 支是 moderate,probe-03 則是 weak(見下文);16 個 ctest 執行檔全部通過,313 個 codegen pytest 測試案例也全部通過,其他 161 支策略都沒有出現任何迴歸。
劇情反轉
修正之後,parity-probe-03-equity-mirror 本身和 TV 仍然沒有完全吻合。引擎進場 25 次,TV 進場 24 次,其中只有 13 次重疊。Probe-03 的設計本來就是剛好貼在 1 倍權益邊界上,所以兩套實作在容差上的任何分歧,都會最先在這裡浮現。
比對區間內共有 57 個週一,我們針對每一個週一計算 qty * signal_close - equity,並記下 TV 接受或拒絕的決定。以下是其中八個:
| 週一 | 以訊號收盤價計算的超出金額 | TV 的動作 |
|---|---|---|
| 2025-04-07 | +$0.04 | TAKE |
| 2025-04-14 | -$0.76 | TAKE |
| 2025-04-21 | -$0.19 | TAKE |
| 2025-04-28 | +$0.34 | REJECT |
| 2025-05-12 | -$0.18 | REJECT(低於權益,卻被拒絕) |
| 2025-05-26 | -$0.89 | REJECT(低於權益,卻被拒絕) |
| 2025-08-18 | +$0.24 | REJECT |
| 2025-11-10 | +$0.24 | TAKE(超出金額相同,結果相反) |
8 月 18 日和 11 月 10 日的超出金額同樣是 +$0.24,結果卻完全相反。任何單純的保證金檢查規則——不論門檻或容差怎麼設——都不可能產生這種模式。TV 的券商模擬器在這個邊界上,取決於某種在任何有文件記載的 Pine 變數裡都看不到的東西:可能是圖表載入的歷史、使用者發布時 K 線對策略變得可見的順序,或某種我們無從觀察的內部隱藏狀態。
坦白說,我們的解讀是:這是 TradingView 券商模擬器裡一個沒有文件記載的邊角情況,只有在部位大小精準釘在 1 倍權益邊界上時才會出現。實際的策略很少剛好落在這條邊界上。最接近的是 community/IES:它依照一筆不大的風險預算和停損距離來計算每筆交易的部位,所以有些訂單幾乎用掉了帳戶的全部權益,而修正之後它仍然達到 excellent。我們預期這個邊角情況在實際使用上影響不大。我們選擇保留這次修正,並把 probe-03 記錄為已知限制。診斷用探針的等級在帳面上被調降,換來 IES 的改善,這個代價很公道。
這次除錯教會我們的六件事
1. 不對稱的數據指紋,能指出 bug 屬於哪一類。 當交易筆數、進場價和出場價全都一致,損益卻在漂移,你面對的就是部位計算的 bug。我們早該先去看部位計算相關的程式碼,再來審查指標公式。
2. 隔離探針比追蹤大型策略更好擴展。 六支小型 Pine 探針,每支只測一個假設,就找到了 bug。要是在一支帶有權益回饋計算的 700 行社群腳本裡追蹤每一個內部變數,花的時間會更長,雜訊也更多。這和我們寫單元測試、而不是只在整合層除錯,是同樣的道理。
3. TradingView 的 qty= 參數採用訊號時的保證金語意。 檢查用的是呼叫 strategy.entry 的那根 K 線,而不是成交的那根。Pine 的參考文件沒有寫到這一點。任何要實作 Pine 相容券商模擬器的人都應該比照辦理;直覺的實作會把檢查放在成交時(這時成交價已知),然後悄無聲息地出錯。
4. 邊界上的浮點數永遠是敵人。 讓 probe-03 兩條權益路徑分岔的那一筆交易,只不過是在 985k 美元的部位上超出了四美分。正式上線的策略應該保留 1% 到 5% 的保證金緩衝(在部位計算公式裡加上 * 0.99 或 * 0.95),根本不要貼著邊界走。
5. 複利會放大單筆交易的遺漏。 在 probe-03 裡,光是 04-07 那一筆漏掉的交易,就是 1,345 美元;到了第 8 筆交易,兩邊的部位大小已經相差 7.76%,之後也一直維持在這個差距,因為每一筆漏掉的交易都會改變權益路徑,進而改變下一次的部位計算,再進而改變下一次接受或拒絕的決定。在 IES 上,同樣的規則套在 13 個月的交易上,累積出約 29,000 美元的差距。帶有權益回饋的策略,對零星的執行缺口毫不寬容。
6. 有時候 bug 在對面,那就老實記錄下來。 TV 在 1 倍邊界上的行為,是一個我們無法從自己這一側修正的真實邊角情況。坦白記錄下來,勝過默默追逐一個根本對不上的指標。
這套方法論不只適用於這個 bug。對齊探針和我們的 PyneCore 交叉驗證掃描互補:PyneCore 告訴我們,我們的引擎什麼時候和另一個引擎不一樣;對齊探針則告訴我們,它為什麼和 TradingView 不一樣。現在每發現一個新缺口,我們的標準流程就是:寫出能重現它的最小 Pine 腳本、diff 交易清單、替引擎加上觀測輸出、修正分歧,再把無法調和的 TV 邊角情況記錄下來。
接下來可以做什麼
- 從 Claude 或 Cursor 轉譯並回測:本機 MCP 伺服器的
transpile_pine工具,會回傳 PineForge 從你的 Pine 原始碼產生的 C++;保證金檢查本身是在引擎的 runtime 裡執行,不在那段產生出來的程式碼裡。 - 瀏覽畫廊:開放語料庫目前的 312 支策略,每一支都和 TradingView 逐筆交易比對過。
- 我們如何衡量對齊:目前的結果與資料來源。