Tencent WorkBuddy 目前提供可視化的自訂模型設定。按照下面的順序新增 BearLab，不需要手動修改官方帳號 Provider。欄位與行為以 WorkBuddy 官方 Model Configuration 文件為準。
WorkBuddy 不同版本的欄位可能變化。請以目前版本的“Model Configuration”頁面為準；儲存後還要在原生會話中收到回覆，並核對 BearLab 請求日誌。
第一步：安裝並登入 WorkBuddy
- 開啟 Tencent WorkBuddy 官方安裝說明。
- 下載與你系統和處理器架構相符的版本。
- 完成安裝並啟動 WorkBuddy。
- 使用 WorkBuddy 支援的登入方式進入主介面。
macOS 需要 12 或更高版本。首次啟動可能請求文件、輔助功能或通知權限；只為你準備使用的功能授權，自訂模型設定本身不要求把所有權限一次性開啟。
第二步：建立 WorkBuddy 專用 API 金鑰
- 登入 BearLab 主控臺。
- 開啟“令牌管理”，新增一個只供 WorkBuddy 使用的令牌。
- 選擇需要使用的模型分組。
- 複製令牌並妥善儲存；截圖前保持密碼框掩碼。
第三步：確認模型 ID
使用同一個令牌請求模型列表：
從回傳結果中複製準確的模型 ID。下文用 gpt-4o-mini 舉例；如果你的令牌分組沒有該模型，請替換成實際回傳的 ID。
第四步：開啟自訂模型頁面
在 WorkBuddy 中依次開啟：
在 Provider 列表中選擇 Custom。不要修改 WorkBuddy 內建 Provider，也不要選擇只允許填寫官方金鑰、不能修改 URL 的預設。
第五步：填寫 BearLab 設定
在新增模型對話框中填寫：
- Provider：
Custom
- Model name：
gpt-4o-mini
- URL：
https://bearlab.ai/v1
- API Key：BearLab 專用令牌
亞太地區可將 URL 改為：
WorkBuddy 官方說明中，Custom Protocol 關閉時會按標準 OpenAI Chat Completions 規則驗證並補全介面路徑；開啟後會把請求直接傳送到填寫的完整 URL。BearLab 的常規 OpenAI-compatible 設定應保持關閉，並填寫到 /v1，不要手動追加 /chat/completions。
第六步：設定模型能力
首次儲存時，只啟用已經確認的能力：
- 普通文字對話：啟用。
- Tool calling：只有模型和令牌分組已實際通過工具呼叫後才啟用。
- Image input：只有模型已實際通過圖片輸入後才啟用。
- Reasoning：只有模型協定和回應格式已確認相容後才啟用。
不要根據模型名稱猜測能力。錯誤的能力開關會讓 WorkBuddy 傳送不受支援的請求結構。
第七步：儲存並選擇 BearLab 模型
- 點擊 Save。
- 回傳聊天頁，開啟模型選擇器。
- 找到自訂模型分組。
- 選擇剛新增的
gpt-4o-mini。
- 確認目前會話頂部顯示該模型後，再傳送訊息。
第八步：傳送第一條訊息
先傳送不包含文件或工具的短訊息：
必須同時滿足以下條件，才能認定接入完成：
- WorkBuddy 會話出現模型正文回覆；
- BearLab 主控臺出現同一時間的請求記錄；
- 請求記錄中的模型 ID 與 WorkBuddy 目前選擇一致。
普通訊息成功後，再逐項啟用項目掃描、文件存取、工具呼叫和自動執行。
常見問題
- 沒有 Custom 選項：更新到支援自訂模型的 WorkBuddy 版本；不要修改官方帳號設定繞過入口。
- 提示 401：重新貼上專用令牌，確認沒有複製空格或已停用的舊令牌。
- 提示 404：URL 使用
https://bearlab.ai/v1，並保持 Custom Protocol 關閉；不要重複追加介面路徑。
- 提示模型不存在：重新請求
/v1/models，複製令牌分組實際可見的模型 ID。
- 儲存後模型不在選擇器中：回傳 Settings → Model，確認自訂模型仍在列表中且已經儲存。
- 普通對話成功但工具失敗：關閉能力開關，從純文字開始逐項驗證，不要把基礎接入與工具相容性混在一起排查。
