本文档由英文原版机器翻译而成。如果翻译版本与英文原版之间存在任何冲突，请以英文原版为准。 阅读英文原版

故障排除

有什么无法正常工作？从这里开始。

浏览器扩展问题

扩展程序无法加载

  1. 确保您是从 Chrome 应用商店安装的（而非开发版本）
  2. 前往 chrome://extensions 查看错误消息
  3. 尝试禁用扩展并重新启用
  4. 如果不起作用，请彻底重启 Chrome

侧边栏无法打开

  1. 点击工具栏（右上角）中的 Caiioo 图标
  2. 确保您处于常规网页上（某些页面如 Chrome 设置页面不允许扩展运行）
  3. 前往 chrome://extensions，找到 Caiioo，点击 "重新加载"
  4. 再次尝试点击图标

更新后侧边栏空白或损坏

  • 清除浏览器缓存并重新加载扩展
  • 关闭并重新打开侧边栏
  • 如果都没有帮助，请禁用并重新启用扩展

登录问题

无法使用 Google / Apple / Microsoft 登录

  1. 确保您的浏览器没有拦截弹窗 —— OAuth 需要弹窗
  2. 在 iOS 上，如果 Google 登录卡住，请尝试使用“通过 Apple 登录”选项
  3. 清除 caiioo.ai 的 Cookie 并重试
  4. 如果您最近更改了密码，请先在浏览器中退出该提供商的登录，然后重试

登录后卡在登录界面

  • 等待几秒钟 —— 应用正在获取您的个人资料
  • 如果仍然卡住，请关闭并重新打开应用（或重新加载扩展）
  • 确保您的设备时钟正确 —— 如果时钟偏差，OAuth 令牌验证将失败

API 密钥问题

API 密钥无效

  1. 从提供商网站重新复制您的密钥并仔细粘贴（注意不要包含前导/尾随空格）
  2. 检查您的账户是否有剩余额度
  3. 尝试生成一个全新密钥并改用它
  4. 检查密钥格式是否正确——OpenRouter 密钥以 sk-or- 开头

找不到我的 API 密钥

  • OpenRouter：openrouter.ai/keys
  • Ollama：无需密钥——确认您的本地服务器正在 http://localhost:11434 运行

详情请参阅 AI 提供商与 API 密钥。

所选模型提示“速率受限”或“过载”

这是提供商端的问题，而非您的密钥所致。当您选择的模型发生速率受限、过载或不可用时，Caiioo 会指明该模型并说明情况，而不会悄悄切换到其他模型。请等待一分钟后重新发送，或自行选择其他模型。（如果是 Caiioo 为您自动挑选的模型，它仍会自动切换——这就是两者的区别。）

某个免费模型总是拒绝我的请求

部分免费的 OpenRouter 模型会拒绝不在其许可名单上的应用发出的请求。Caiioo 会记住曾拒绝请求的模型，在选择器中进行标记，并在回退到其他模型时跳过它——之后会重新检查封禁是否解除。在此期间，请选择其他模型。

Google 集成（专业版）

无法连接到 Google

  1. 前往 设置 > 账户 > 账户授权与权限
  2. 点击“连接 Google 账户”
  3. 确保您批准了所有请求的权限
  4. 检查您的账户是否显示为已连接
  5. 如果仍无法使用，请断开连接后重试

Google 工具无法正常工作

  1. 验证 Google 是否已连接（设置 > 账户 > 账户授权与权限）
  2. 尝试刷新您的 Google 连接（“重新连接 Google”按钮）
  3. 确保已启用特定的工具（设置 > 工具、模式与应用 > 工具配置）

专用同步问题

同步不工作

  1. 检查是否已实际启用专用同步（设置 > 连接 > 专用同步）
  2. 确认您的 Google 账户已连接
  3. 确保您的 Google Drive 仍有剩余存储空间
  4. 如果令牌已过期，请点击“重新连接 Google”
  5. 尝试关闭同步后重新开启

数据未跨设备同步

  • 专用同步在后台运行——请稍候数秒
  • 检查所有设备上使用的是否为同一个 Google 账户
  • 确保另一台设备上也已启用专用同步
  • 通过关闭后重新开启同步进行手动刷新

远程浏览器访问问题

relay.caiioo.ai/app 页面无法连接

  • 在您的主设备上，确保已开启 私密中继（设置 > 连接 > 连接）并显示“已连接”
  • 在远程浏览器上使用与主设备相同的账户登录——中继只能触达您自己的实例
  • 您的主设备上的扩展程序或桌面应用需要保持运行且在线，远程浏览器才能对其进行驱动
  • 初次打开时，页面可能会显示几秒钟的“连接中”旋转图标来建立加密会话——请让其完成后再重新加载

已登录但远程页面停留在登录屏幕

  • 请稍等几秒钟——它仅在建立加密会话后才会启动应用
  • 如果仍然卡住，请确认您的主设备在线且私密中继已连接，然后重新加载页面

性能问题

回复缓慢

  1. 检查 AI 提供商是否有问题（查看其状态页面）
  2. 尝试使用更快、更便宜的模型（如 Gemini Flash 或 Mistral）
  3. 如果有数百个旧对话，请归档它们
  4. 检查您的互联网连接

对话耗时过长

  • AI 正在工作 — 寻找旋转的指示器
  • 有些模型比其他模型慢。如果您赶时间，请切换到更快的模型
  • 如果耗时超过几分钟，AI 可能卡住了。点击停止并重试

订阅与账单

看不到“管理计划”

  • 确保您登录的是持有订阅的账户
  • 如果您是在 iOS 上订阅的，管理计划按钮会跳转到苹果的订阅设置
  • 如果您是在网页端订阅的，它会跳转到 Stripe 账单门户
  • 退出并重新登录以刷新您的订阅状态

“管理计划”打开了错误的位置

  • iOS 应用内购买在 设置 > Apple ID > 订阅 中管理——而不是在 caiioo.ai/account
  • Stripe 订阅通过 设置 > Account > User Profile 中的门户链接或在 caiioo.ai/account 进行管理
  • Caiioo 会根据您的订阅来源自动路由——这是正常现象

已升级但仍在使用旧版层级

  • Stripe 升级需要一分钟时间生效——请重新加载应用
  • 苹果 IAP 验证可能最多需要 24 小时。点击 设置 > 账户 > 用户个人资料 中的“恢复购买”以加速此过程
  • 如果您在其他平台上已经有订阅，订阅按钮会提示您改在该平台进行管理

其他问题

桌面端或移动应用出现空白屏幕

  • 完全重启应用
  • 检查您是否已连接到互联网
  • 尝试清除应用的缓存（因平台而异）
  • 更新到最新版本

工具无法正常工作

  1. 前往 设置 > 工具、模式与应用 > 工具配置 并检查该工具是否已启用
  2. 某些工具需要权限或设置（例如 Google 工具需要连接 Google 账户）
  3. 如果您看到“需要权限”错误，请在 设置 > 账户 > 账户授权与权限 中重新连接提供商并重新批准范围

扩展程序无法连接到桌面应用

  • 首先，检查是否已开启 启用 Caiioo 桥接（设置 > 连接 > 连接）——该选项默认关闭，关闭时扩展程序绝不会连接到桌面应用，且“重新连接/端口”控件呈灰色不可用状态
  • 如果您同时使用浏览器扩展程序和桌面应用，扩展程序通过本地 WebSocket 连接到桌面应用（能力桥接，而非同步）
  • 重启桌面应用，然后重新加载扩展程序
  • 确保没有运行其他副本的桌面应用——多实例会发生冲突

macOS 上出现“浏览器未连接”警告，但浏览器明明开着

  • Caiioo 现在可识别 Chrome、Safari、Edge 和 Firefox ——只要其中任意一个连接成功，警告就会消失
  • Safari 通过不同的通道连接，当它不是前台应用时可能会短暂休眠；它会保持连接状态，当命令需要时，Caiioo 会自动唤醒它
  • 如果警告持续存在，请将浏览器切换到前台一次，然后重试

消息附件无法上传

  • 检查文件格式是否受支持（PDF、图片、Word 文档、电子表格、演示文稿）
  • 尝试较小的文件
  • 确保您有网络连接

获取帮助

  • 快速解答： 点击标题中的 ? 图标
  • 设置与故障排除： 点击齿轮图标
  • 本指南： 设置 > 帮助 > 文档与法律
  • 让 Caiioo 为您提交错误报告： 让它报告问题，它会打开内置的支持表单，其中预先填好了详细说明供您检查和发送。说“直接提交”并在经您批准后，它将直接提交工单，并附带对话的技术详情，以便团队能够重现您遇到的问题。

另请参阅

This guide is maintained by the Caiioo team using Slate, our built-in editor.