Provider 演變回顧:依賴方向優先於派發方式
Provider 最早在 providers crate 建 dyn trait,後來改成 enum + match,後來又改成在 agent-core crate 建 Provider dyn trait
三個階段各自的理由
providers建dyn trait:做POC時,容易陷入的假設:「provider trait 由 provider crate 實現,並且實現開放性 」。enum + match:模型廠商按照實際市場收斂成四大種 protocol(Anthropic、Gemini、OpenAI、OpenAI 第三方相容),程式碼邏輯差異不大——封閉集合、行為趨同,用 enum 更優雅。agent-core建dyn trait:看到另一個維度——agent-core(核心迴圈)不該具體依賴providers(實作細節),且 enum 搬進agent-core解不了這點,因為 enum 的每個 variant 還是得裝具體 config 型別,agent-core還是被迫認識它們。只有把契約定義權交給agent-core、讓providers反過來impl agent_core::Provider,依賴方向才真正反轉。
只有第三步問對了問題:「這個型別該定義在哪個 crate、依賴箭頭指向誰」。
讓
agent-core能脫離providers獨立編譯測試,Provider依然是封閉集合(三個第一方實作:Anthropic、OpenAI、Gemini,組裝執行檔的appcrate 依使用者選的組裝其一)。
派發方式(static/dynamic)跟集合開放性(open/closed)決定的是局部效能與擴充成本;
依賴方向跟抽象邊界決定核心邏輯能不能獨立於實作細節存在、能不能被單獨測試——量級不同。
enum 比 dyn 省一次 heap allocation,但如果 trait/型別定義擺錯 crate,核心邏輯甩不開對細節的依賴,省下的那次配置毫無意義。
架構設計中,依賴方向與抽象邊界的正確性,優先於靜態/動態派發及開放/封閉集合所帶來的局部效能最佳化。
Rust 開發時應時刻留意的問題
依賴方向:這個型別/契約該屬於高層(核心邏輯)還是低層(實作細節)?現在的依賴箭頭,指向的是不是我想要的那個方向?