錯誤處理協議 —「大聲宣告」
運算與引擎堆疊是全新的且不斷演進。**每個失敗都必須遵循此協議。**切勿為了讓活動繼續進行而掩蓋錯誤——吞下一個錯誤比卡住某個階段更糟糕。虛構機制(編造引擎為何如此運作的原因)是最糟糕的失敗模式:活動中最糟糕的時刻,莫過於虛構調解事件、定價行為和預算行為。驗證,而不是假設。
先例:一個 totalBudget 超支部署錯誤(一本配置了 40% 預算的帳冊,在冷啟動時卻部署了約 96% 的 NAV)正是以這種方式被發現,並導致了數週的結果失效。一般的教訓是:隔離所有受到引擎缺陷影響的結果,並僅在行為修正後重新執行。
五個步驟(每次失敗皆適用)
- 停止並確認特徵——是配置(我的錯誤)、數據(來源端),還是引擎(NexusTrade)的問題?以最小化方式重現——找到能重現問題的最小作業/回測。
- 立即記錄在運行的
CAMPAIGN_LOG.md中,標題為⚠️ BUG/ISSUE:症狀、重現 ID、預期與觀察結果、當前假設(標記為 假設),以及它所阻礙的內容。 - 如果是真正的引擎/數據錯誤,請撰寫交接文檔,檔案名稱為
<NAME>_BUG.md,放在運行目錄中,並以references/BUG_TEMPLATE.md中的模板為藍本(一行摘要、預期與觀察結果、使用 ID 的重現方法、主要假設、需排除的其他可能性、檢查方向、對結果的影響)。 - 隔離受影響的結果——將所有在修復前執行的回測/研究標記為可疑/無效。修復後重新執行。如果錯誤導致槓桿膨脹,則回報率和最大回撤都會被誇大,且任何受其影響的掃描基因可能失去區分能力——需要全部重新驗證。
- **在聊天中,醒目地告知人類。**錯誤是該階段中與交易結果同等重要的交付物——不是需要繞過的尷尬事。
哪些情況不是錯誤(誠實信號失敗——無需建檔)
- 折返返回
NoEligibleCandidate= 這是一個誠實信號,不是錯誤。應擴大驗證範圍;不要降低認證門檻。 - 一個已下市/尚未上市的名稱(例如 2022 年的 SNDK)不存在或位於拒絕清單中,且沒有偽造值 = 正確的行為。引擎偽造一個未交易名稱的價格/指標值,則是一個錯誤(參見引擎健全性)。
- 單一 tick 的調解目標 = 即時策略會在日常再平衡中累積其餘部分——請如此說明,不要重新將其診斷為錯誤(參見部署閘門)。
驗證而非假設的檢查清單
在將任何關於引擎行為的主張寫入交付物之前,請使用以下任一方式進行驗證:query_backtest_events / query_portfolio_events、conditionFieldAudit,或一個最小化的重現方式。「引擎可能……。」不是證據。