BibGenieBibGenie 文件

錯誤排查

BibGenie 常見錯誤的診斷與解決方案

在使用 BibGenie 過程中，您可能會遇到一些錯誤提示。本頁面將幫助您快速定位問題原因並找到解決方案。

請先更新到最新版本

在排查問題之前，請先確認 BibGenie 已更新到最新版本。很多模型、Zotero 相容性和網路呼叫問題，可能已經在新版本中修復。

錯誤資訊很重要

錯誤對話方塊中通常會包含詳細的錯誤資訊，請仔細閱讀這些資訊，它們能幫助您更快地定位問題。

ModelNotSupported

錯誤描述

對話框出現以 "ModelNotSupported" 為標題的錯誤提示。

問題原因

選擇的模型不支援當前輸入型別。通常發生在使用者輸入圖片，但所選模型不支援圖片輸入時。

解決方案

更換支援圖片的模型

切換到支援視覺輸入的模型，例如：

  • GLM-4V
  • GPT-4o
  • Claude 3.5 Sonnet
  • 其他支援 Vision 的模型

檢查自訂模型配置

如果您確信所選模型支援圖片輸入但仍出現此錯誤，請檢查自訂模型配置是否正確將模型標記為 Vision 模型。

AI_APICallError

錯誤描述

對話框出現以 "AI_APICallError" 為標題的錯誤提示。

問題原因

模型 API 呼叫失敗。可能的原因包括：配置錯誤、金鑰無效、端點錯誤、呼叫超時等。

常見錯誤資訊

金鑰格式不正確或已過期時，會出現類似以下錯誤資訊：

Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)
Model: deepseek-reasoner
Request URL: https://api.deepseek.com/v1/chat/completions
Incorrect API key provided: ''.
You can find your API key at https://platform.openai.com/account/api-keys.
Failure reason: [{"error":{"code":400,"message":"Missing Authorization header.","status":"INVALID_ARGUMENT"}}]

解決方案

NetworkError

錯誤描述

對話框出現以 "Error" 為標題的錯誤，內容為 TypeError: NetworkError when attempting to fetch resource.

問題原因

連線模型 API 時網路請求失敗。

可能的原因

使用 Ollama、LM Studio 等本地模型時：

  • 模型 API 地址配置不正確
  • 本地模型服務未啟動
  • 埠被佔用或防火牆阻止

排查步驟：

  1. 確認本地模型服務已啟動
  2. 在瀏覽器中存取模型 API 地址進行測試
  3. 查閱 Ollama 或 LM Studio 官方文件

需要更多幫助？

如果以上方案無法解決您的問題，歡迎加入我們的 Discord 社群 取得支援。

On this page