zophos

← Notes · 01-Provider 演變回顧:依賴方向優先於派發方式.md

Provider 演變回顧:依賴方向優先於派發方式

Provider 最早在 providers crate 建 dyn trait,後來改成 enum + match,後來又改成在 agent-core crate 建 Provider dyn trait

三個階段各自的理由

  1. providers 建 dyn trait:做POC時,容易陷入的假設:「provider trait 由 provider crate 實現,並且實現開放性 」。
  2. enum + match:模型廠商按照實際市場收斂成四大種 protocol(Anthropic、Gemini、OpenAI、OpenAI 第三方相容),程式碼邏輯差異不大——封閉集合、行為趨同,用 enum 更優雅。
  3. 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,組裝執行檔的 app crate 依使用者選的組裝其一)。

派發方式(static/dynamic)跟集合開放性(open/closed)決定的是局部效能與擴充成本;

依賴方向跟抽象邊界決定核心邏輯能不能獨立於實作細節存在、能不能被單獨測試——量級不同。

enum 比 dyn 省一次 heap allocation,但如果 trait/型別定義擺錯 crate,核心邏輯甩不開對細節的依賴,省下的那次配置毫無意義。

架構設計中,依賴方向與抽象邊界的正確性,優先於靜態/動態派發及開放/封閉集合所帶來的局部效能最佳化。

Rust 開發時應時刻留意的問題

依賴方向:這個型別/契約該屬於高層(核心邏輯)還是低層(實作細節)?現在的依賴箭頭,指向的是不是我想要的那個方向?