跳至主要內容

2 篇文章 含有標籤「release」

檢視所有標籤

LiteLLM 版本支援:聚焦最近四條穩定次版本線

Yuneng Jiang
Senior SWE @ LiteLLM

自 2026 年 6 月 29 日星期一起,LiteLLM 將只主動支援最近四條穩定次版本線。以下說明變更內容以及對您的影響。

我們為什麼這麼做

維護較舊的版本線,意味著必須將每個修正回補,以維持所有版本線一致。這項額外負擔會隨著我們保留的版本線數量增加,而不是隨著我們所做的修正數量增加。我們的重點是確保最新的產品提供內容穩定且能為您正常運作。因此,LiteLLM 接下來將聚焦於最近四條穩定次版本線。

滾動視窗如何運作

這項焦點轉移將於 2026 年 6 月 29 日星期一生效。

次版本線是一個以 1.89.x 這種格式表示的發布系列,涵蓋其中的所有 patch:1.89.0、1.89.1、1.89.2,以及任何後續版本。我們支援最近四條版本線,以及每條版本線中的所有 patch。

目前受支援的四條版本線是 1.89.x、1.88.x、1.87.x 和 1.86.x。所有 1.85.x 及更早版本都已達到生命週期結束,將不再主動接收更新。這個視窗會往前推進:當 1.90.x 發布時,1.86.x 會移出,受支援的組合就會變成 1.90.x、1.89.x、1.88.x 和 1.87.x。由於大約每週會有一條新版本線,因此每條版本線大約可獲得一個月的涵蓋範圍。

這對您意味著什麼

若要維持受支援狀態,請鎖定在某條版本線並套用其 patch,然後在其過時之前升級到更新的版本線。同一版本線內的 patch 可以直接套用;升級到更高版本線時,則需要查看發行說明中的變更內容。需要更長涵蓋範圍的企業客戶可以與我們聯絡,而對於罕見的高嚴重性問題,我們會依據判斷,並可能在視窗之外進行修補。

如何保持最新

隨時掌握這些變更的最佳方式,是將我們的 發行說明 加入書籤。我們會在新版本發布時更新它,因此您可以看到最新的穩定版本線,以及仍受支援的前三個前版版本線。

LiteLLM 版本發布版號制度正在變更:採用標準命名、每週發版升級 MINOR、hotfix 保留 PATCH

Yuneng Jiang
Senior SWE @ LiteLLM

最後更新:2026 年 7 月

main-stable 已淘汰;請遷移至 :latest

舊版 main-stable Docker 標籤仍會每週前進,因此現有部署可繼續運作。我們目標在 2026 年 9 月 1 日 停止發布它,不過該日期仍在透過 公開的淘汰討論 最終確認中,可能會因回饋而變動。未來,:latest 將是指向最新穩定映像的標準滾動指標;每次穩定版發布時會自動前進,並符合標準 Docker 慣例。

main-stable 沿用了先前的命名方案,且不符合現代慣例:它將「main」(通常是開發分支)與「stable」(發布通道)混在一起,而且沒有對應的 PyPI 版本。

遷移:

  • 滾動穩定版(Docker)ghcr.io/berriai/litellm:latest
  • 可重現固定版(Docker)ghcr.io/berriai/litellm:1.84.0
  • 可重現固定版(PyPI)pip install litellm==1.84.0

此橫幅會在時程確認後更新。

LiteLLM 發布版名稱正在變更。以下兩個痛點一直是推動因素:

1. -stable-nightly 後綴不是標準格式。

v1.83.3-stablev1.83.0-nightly 這類版本不符合 PEP 440(PyPI)或 SemVer 2.0(Docker / Helm)慣例。期待標準版本字串的使用者會感到困惑,而分類版本的工具也必須針對該後綴做特殊處理。

2. 每週發版一直在升級 PATCH,導致真正的 hotfix 沒有空間。

在舊模型下,每次排定的每週發版都會升級 PATCH 數字:1.83.0 -> 1.83.1 -> 1.83.2 -> 1.83.3。當 1.83.3 需要真正的 hotfix 時,下一個 PATCH(1.83.4)已經保留給下一週的發版。Docker 的變通作法是 v1.83.3-stable.patch.1 - 但 PyPI 不接受這種語法,因此同時需要 Docker 映像與 Python wheel 的 hotfix 沒有乾淨的發布方式。