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

故障排除

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

浏览器扩展问题

扩展程序无法加载

  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- 开头，Anthropic 密钥以 sk-ant- 开头，等等）

找不到我的 API 密钥

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

Google 集成 (Pro 等级)

无法连接到 Google

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

Google 工具无法工作

  1. 验证 Google 是否已连接（设置 > Google 集成）
  2. 尝试刷新您的 Google 连接（“重新连接 Google”按钮）
  3. 确保已启用特定工具（设置 > 工具）

私密同步问题

同步不起作用

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

数据未在设备间同步

  • 私密同步在后台运行——请等待几秒钟
  • 检查您是否在所有设备上使用同一个 Google 账号
  • 确保另一台设备上也启用了私密同步
  • 通过切换同步开关手动刷新

性能问题

回复缓慢

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

对话耗时过长

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

订阅与计费

看不到 "管理方案"

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

"管理方案" 打开了错误的地方

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

已升级但仍显示旧档位

  • Stripe 升级需要一分钟左右生效 —— 请重新加载应用
  • Apple 应用内购买可能需要长达 24 小时进行验证。点击 设置 > 个人资料 中的 "恢复购买" 以加快速度
  • 如果您已在其他平台拥有订阅，"订阅" 按钮会提示您在相应平台进行管理

其他问题

桌面或移动应用显示白屏

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

工具无法工作

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

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

  • 如果您同时使用浏览器扩展和桌面应用，扩展程序会通过本地 WebSocket 连接到桌面应用（能力桥接，而非同步）
  • 重启桌面应用，然后重新加载扩展程序
  • 确保没有运行桌面应用的其他副本 —— 多个实例会产生冲突

消息附件无法上传

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

获取帮助

  • 快速解答： 点击标题中的 ? 图标
  • 设置与故障排除： 点击齿轮图标
  • 本指南： 设置 > 文档与法律

另请参阅

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