比特幣研究快照差異比較器
工具會載入兩筆不可變的研究快照，把 payload 展開成欄位路徑，標示新增、刪除與變更的欄位。適合用來釐清兩次回測或兩份研究到底在參數、資料還是結果上有差別。
這個研究實驗室的互動介面目前以簡體中文提供；下方說明涵蓋所有輸入、方法與限制。
輸入項目
- 左側快照：bir_… ID 或快照連結
- 右側快照：bir_… ID 或快照連結（必須與左側不同）
- 欄位路徑篩選（選填，例如 settings 或 summary）
輸出結果
- 兩筆快照的標頭：標題、ID、資料版本與方法版本
- 差異總數，以及變更（changed）、新增（added）、刪除（removed）的欄位數
- 路徑、狀態、左值、右值的對照表（篩選後最多顯示 500 列）
- 完整差異 CSV，欄位為 path、status、left、right、left_type、right_type
使用步驟
- 在左側貼上第一筆快照的 ID 或連結，右側貼上第二筆。
- 按「Compare snapshots」載入兩筆公開紀錄。
- 先在標頭確認資料版本與方法版本，再看結果欄位。
- 在篩選框輸入關鍵字（先 settings、再 summary），先看參數、後看結果。
- 需要完整稽核時匯出完整差異 CSV，特別是含有大型陣列的 payload。
計算公式
每個 payload 會展開成葉節點值，路徑形如 settings.feeBps 或 cells[3].finalValue（鍵依字母排序，每個 payload 最多 50,000 個葉節點）。對每條路徑：added = 只存在右側；removed = 只存在左側；changed = 兩側都有但值或型別不同。完全相同的路徑不列出。
計算範例
左側 settings.buyPercentile = 25、summary.finalValue = 52,000；右側 settings.buyPercentile = 20、summary.finalValue = 49,500，而 settings.feeBps 兩側都是 10。工具列出 2 列 changed（buyPercentile 與 finalValue），略過 feeBps。期末價值差距為 49,500 − 52,000 = −2,500；工具只顯示兩個值，減法需自行計算。
如何解讀
- 資料版本或方法版本不同時，結果差異可能來自輸入，而不是策略本身。
- 只有在 settings 中的資金、每月投入、手續費與滑價都相同時，才解讀 summary 的變化。
- 同一陣列出現大量 added 或 removed，通常表示兩條序列長度或時間點不同。
注意事項
- 頁面只顯示篩選後前 500 列；完整稽核請使用 CSV。
- 數值差異不等於策略改善；請先確認資料、方法、現金流與成本是否一致。
- 超過 50,000 個葉節點的 payload 會被截斷，工具會加上一列 $truncated 提示。
常見問題
為什麼差異列這麼多？
陣列中的每個元素（例如資產曲線的每個點）都是獨立路徑。兩條序列只差幾週，也可能產生數百列；可用 settings 或 summary 篩選。
可以拿同一筆快照和自己比較嗎？
不行。工具要求兩個有效且不同的 ID。
比較會修改快照嗎？
不會。工具只讀取兩筆公開紀錄；快照是不可變的，無法編輯。