故障排查
如果 Bricoop Desktop 未如預期運作，請按以下主題逐一排查。每個小節結構相同：症狀、可能原因、待執行的檢查。
未偵測到應用
症狀：你已安裝的某個受支援應用未出現在 Bricoop 中。
可能原因：該應用未安裝到 Bricoop 掃描的位置，或其版本低於受支援的最低版本。
檢查：確認該應用已安裝並能正常啟動，將其更新到目前版本，然後重新打開 Bricoop 以再次掃描。
版本不受支援
症狀：Bricoop 回報某個應用或 Provider 版本不受支援。
可能原因：已安裝版本低於對應介面卡清單中宣告的最低版本。
檢查：將應用或 Provider 客戶端更新到目前版本並重新打開 Bricoop。若問題仍然存在，請在整合詳情頁確認受支援的最低版本。
Provider 身分驗證失敗
症狀：連接某個 Provider 失敗，或已有連接顯示身分驗證錯誤。
可能原因：憑證或權杖缺失、已過期、未具備所需範圍，或該 Provider 的身分驗證服務不可達。
檢查：在 Bricoop 中使用目前值重新輸入憑證，確認帳戶具備所需存取權，然後重試。若 Provider 的身分驗證服務中斷，請等待後重試。
請求失敗
症狀：來自受支援應用的請求回傳錯誤或無回應。
可能原因：Provider 拒絕了請求（速率限制、配額、帳戶資格不符或不支援的模型），或你的裝置與 Provider 之間的網路路徑被中斷。
檢查：確認所選模型受該應用支援，核對 Provider 帳戶處於其額度之內，然後重試。Provider 端錯誤會在 Provider 回傳時保留其原始訊息。
更新與目錄連通性
症狀：Bricoop 無法取得目錄更新或通知你新版本發布。
可能原因：到 Bricoop 公共目錄或更新服務的網路連接被阻斷，或已安裝的 Bricoop 版本過舊。
檢查：確認你的裝置可以連網，檢查是否有防火牆或代理阻斷了目錄主機，並將 Bricoop 更新到目前版本。
仍然沒有解決？
如果上述檢查均未解決問題，請從 Bricoop 的設定中執行安全的內建診斷，然後透過下方的 GitHub issue 連結回報你觀察到的現象。