觀點 · 資訊分享

Open WebUI 0.10.0：升級前要先備份資料庫，預設改用原生工具呼叫，還新增資料夾分享與長對話壓縮

自架 AI 介面 Open WebUI 在 6/29 釋出 0.10.0：新增資料夾分享、長對話自動壓縮、事件與 webhook、記憶系統改版，也修了一批權限問題。但資料庫會做遷移、升級後不支援降版，工具呼叫預設也改了。

一句話看懂：Open WebUI 在 6 月 29 日釋出 0.10.0，加了資料夾分享、長對話自動壓縮等新功能，也修了一批權限問題；但資料庫會遷移、升級後不能降版，工具呼叫的預設也改了，升級前要先備份。

Open WebUI 0.10.0 重點整理資訊圖卡：新增資料夾分享與長對話壓縮，但升級前要先備份資料庫

先用白話講：Open WebUI 是什麼？

想像你在家裡架了一個「AI 客服窗口」：窗口後面接的是你自己電腦上的模型（例如 Ollama），家人或同事用瀏覽器就能跟它聊。Open WebUI 就是這個窗口的網頁介面，負責帳號、對話紀錄、知識庫與各種外掛。

這次的釋出說明內容很多，其中也列了不少「升級要小心」的地方。

Open WebUI 團隊在 6 月 29 日釋出 0.10.0，同一天又補了修正共享資料夾登出問題的 0.10.1。這一版同時帶來新功能、預設值調整與安全修正。

資料庫會遷移：官方明說要先備份，而且遷移後不支援降版
原生工具呼叫變成預設：沒有明確選過模式的聊天與模型，都改用 Native（依賴模型內建的工具支援）；舊的做法改名為 Legacy。如果你的模型依賴舊行為，要在聊天、模型，或全域預設參數裡切回 Legacy
事件會自動觸發：新的事件系統會在啟動、登入、設定變更等情況發出事件，你以前設定的 webhook，升級後可能開始收到這些新事件，要檢查事件設定

功能	說明
資料夾分享	可以把資料夾與裡面的聊天分享給特定使用者、群組或所有人，有讀取或寫入權限；管理員用「Folders Sharing」權限控制，預設關閉
長對話自動壓縮	對話超過設定的 token 門檻就自動摘要，以免超出模型上下文；管理員可調整門檻與摘要提示詞，預設關閉
Open WebUI Computer	可連到 Open WebUI Computer，讓聊天在你自己的機器上執行有檔案、終端機、git 與網路存取的代理工作階段
混合搜尋變快	pgvector 環境下，混合搜尋改在資料庫內執行，不再把整個集合載入記憶體
外部知識庫	知識庫可以接外部的檢索來源
記憶系統改版	分成長期的個人記憶與單次對話的脈絡，用新增、更新、刪除的結構化流程管理
Event 函式與 webhook	新的外掛類型，可以在登入、設定變更、檔案上傳等系統事件發生時執行你自己的 Python

官方釋出說明有「Security Advisory」：這版包含安全與存取控制修正，建議正式環境儘早更新，並且說明不一定列出全部修正，有些可能暫時保留一小段時間，讓管理員有時間升級。列出的項目包括：

環境變數 ENABLE_RAG_LOCAL_WEB_FETCH 改名為 ENABLE_LOCAL_WEB_FETCH，舊名稱仍可用但已列為棄用；You.com 搜尋金鑰偏好 YDC_API_KEY，舊的 YOUCOM_API_KEY 仍可當備援
LDAP 與 OAuth/OIDC 設定搬到管理介面獨立的「Authentication」頁面
原本依賴 Pyodide 存取同源 Open WebUI 端點的程式碼，現在做不到了
同一天的 0.10.1 修正：讀取共享資料夾裡的聊天，不會再被誤判為登入逾時而登出

我平常在家用本地模型，Open WebUI 這類介面是日常會碰的東西，所以對這種「新功能多、升級要小心」的版本，我的習慣很簡單：先備份，再升級，最後逐項檢查預設值被改了什麼。這次最容易踩雷的是兩個預設：工具呼叫改成 Native，以及 webhook 開始收到新事件。

另一個提醒是，新功能如資料夾分享與長對話壓縮都是預設關閉，這個設計是對的：先讓管理員自己決定要不要開，不會一升級就改變所有人的使用方式。團隊用的話，先在測試環境跑一輪再正式升級。

Open WebUI 是什麼？

是一套開源、可自己架設的 AI 聊天介面，可以連接 Ollama 等本地模型或其他相容的 API，常用來在自己的主機上提供類似 ChatGPT 的網頁介面給自己或團隊使用。

升級要注意什麼？

先備份資料庫（官方說遷移後不支援降版）。升級後檢查三件事：模型是否依賴舊的工具呼叫方式、已設定的 webhook 是否開始收到新事件、以及用到的環境變數名稱有沒有更名。

原生工具呼叫是什麼？

讓 AI 工具的呼叫直接使用模型本身內建的工具支援，而不是由 Open WebUI 用提示詞「教」模型怎麼叫工具。支援度好的新模型通常更穩定，但較舊或較小的模型可能表現不同，可以在聊天、模型或全域預設改回 Legacy。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。