BibGenie 文件自訂模型
在 Zotero 中使用自訂模型、BYOK 或 Ollama、LM Studio 本地模型，掌控文獻閱讀與語義檢索的資料流向；API Key 本地儲存，不上傳 BibGenie 伺服器。
BibGenie 內建了針對文獻閱讀、理解和科研工具呼叫場景最佳化的官方模型，兼顧使用效果與價效比，無需配置 API Key，即可在 Zotero 中開始 AI 文獻閱讀。
如果你更關注科研資料隱私，或希望使用已有的模型服務，也可以透過自訂模型接入自己的 API Key（BYOK）、機構內部模型服務，或 Ollama、LM Studio 等本地模型，讓模型請求發往你指定的服務。
使用自訂模型時，傳送給該模型的對話內容、文獻上下文和 Embedding 文字會由本地 Zotero 外掛直接傳送至你配置的服務，不經過 BibGenie 伺服器。你填寫的 API Key 等模型連線配置僅儲存在本地 Zotero 中，不會上傳至 BibGenie 伺服器。如果希望模型計算也在本機完成，可以使用本地模型。
模型設定頁的 Add Model（新增模型） 提供兩個入口：
- Add chat model（新增對話模型）：配置用於聊天、閱讀論文和工具呼叫的模型。
- Add Embedding model（新增 Embedding 模型）：配置用於文獻語義索引和語義檢索的模型。
新增前的準備
使用雲端服務時，準備好服務商提供的 API Key、Model ID 和 API 地址。
使用本地模型時，先啟動模型服務，準備好對應模型，並確認服務地址和 Model ID。本地服務通常不需要 API Key。
新增模型
開啟新增視窗。 進入 設定 → 模型（Model Settings），在 Custom Models 區域點選 Add Model，再點選對應的新增入口。
填寫服務商和模型。 在 Provider ID 中搜索服務商，再在 Model ID 中選擇模型。選擇目錄項後，BibGenie 會自動補全可用的名稱、連線配置和模型資訊。找不到時，也可以手動輸入。
確認連線配置。 填寫 API Key，核對 Provider Type 和 Base URL 是否符合服務商要求。Model ID 是 API 實際呼叫的模型標識，Model Name 是在 BibGenie 中顯示的名稱。
測試並儲存。 點選 Test，看到 Connected 後點擊 Add Model 儲存。若測試失敗，根據錯誤提示檢查配置。新增 Embedding 模型時，向量維度可以留空，在測試或儲存時自動探測。
填寫時如需核對連線方式或模型引數，可展開以下說明：
使用新增的模型
對話模型
確認模型在模型設定頁中已啟用，再回到聊天頁面，在模型選擇器中選擇它。
如果希望新建對話時預設使用這個模型，進入 設定 → 聊天（Chat）→ 預設模型（Default Model），在下拉列表中選擇它。這裡僅顯示已啟用的對話模型。
Embedding 模型
確認模型已啟用，再進入 設定 → 文獻庫與索引（Library & Index）→ Semantic Index → Embedding Model，選擇新增的模型。
如果出現切換確認，點選 Switch and rebuild（切換並重建）。BibGenie 會為納入範圍的文獻庫重新生成語義索引，原始文獻不受影響。重建可能需要時間，並產生所選服務商的呼叫費用。索引狀態和失敗重試等操作見語義索引。