故障排查
如果 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 链接报告你观察到的现象。