跳到主要内容

故障排除

常见问题及其解决方法。

提供商问题​

"错误：401 Unauthorized"​

  • 原因：API 密钥无效。
  • 解决方法：前往 Settings > Providers，重新输入您的 API 密钥，并确保没有多余的空格或换行符。

"错误：403 Forbidden"​

  • 原因：您的 API 密钥无权访问所请求的模型。
  • 解决方法：
    • 对于 OpenAI：部分模型需要付费套餐，请前往 platform.openai.com 查看您的访问权限。
    • 对于 Anthropic：请确保您的账户拥有所请求的 Claude 模型的访问权限。

"错误：429 Too Many Requests"​

  • 原因：您已达到速率限制，或 credits 已用尽。
  • 解决方法：
    • 等待几分钟后重试（速率限制）。
    • 前往提供商官网查看账单状态并充值 credits。
    • 考虑暂时切换到其他提供商。

"错误：500 Internal Server Error"​

  • 原因：提供商的服务器出现问题。
  • 解决方法：等待几分钟后重试，并查看该提供商的状态页面。

"Connection Refused"（Ollama）​

  • 原因：Rephlo 无法与本地 AI 服务器通信。
  • 解决方法：
    1. 打开终端并运行 ollama serve。
    2. 验证其是否正在运行：在浏览器中访问 http://localhost:11434。
    3. 检查是否有其他应用正在占用 11434 端口。

"Model Not Found"（Ollama）​

  • 原因：所请求的模型尚未下载。
  • 解决方法：在终端中运行 ollama pull [model-name]（例如：ollama pull llama3）。

界面问题​

"热键无法使用"​

  • 原因（Windows/Linux）：其他应用程序（如 PowerToys 或某个游戏）可能占用了该热键。
  • 解决方法：前往 Settings > Hotkeys，将触发键改为其他组合（例如 Ctrl + Shift + Alt + Z）。

macOS 用户：有关 macOS 上的热键排查方法，请参阅下方的 macOS 专属问题。

"托盘图标不见了"​

  • 原因：Windows 可能已将其隐藏在"溢出"菜单中。
  • 解决方法：点击时钟旁边的 ^ 箭头，将 Rephlo 图标拖到任务栏主区域。

功能问题​

"Vision/截图功能无法使用"​

  • 原因（Windows）：Windows 隐私设置中可能拒绝了屏幕录制权限。
  • 解决方法（Windows）：以管理员身份运行 Rephlo，或检查 Windows 隐私设置 > 摄像头/屏幕捕获。
  • 原因（macOS）：Rephlo 需要屏幕录制权限。
  • 解决方法（macOS）：详细步骤请参阅下方的 macOS 专属问题。

"Space 无法回答问题"​

  • 原因：该 Space 可能为空，或数据摄取（ingestion）失败。
  • 解决方法：查看 Space 详情，确认文件已列出且状态显示 "Ready"。可尝试在 Advanced Settings 中清除缓存。

"在 Space 中找不到变量"​

  • 原因：您使用了 {{filename}} 变量，但该文件不在当前激活的 Space 中。
  • 解决方法：
    1. 确认该 Space 中包含所引用的文件。
    2. 确认变量名与文件名一致（转换为 snake_case，例如 "Style Guide.pdf" -> {{style_guide_pdf}}）。
    3. 确保当前激活的是正确的 Space。

macOS 专属问题​

"热键无法使用"（macOS）​

  • 原因：Rephlo 需要 Accessibility 权限才能检测全局键盘快捷键。
  • 解决方法：
    1. 打开 System Settings > Privacy & Security > Accessibility。
    2. 在列表中找到 Rephlo 并将其切换为开启。
    3. 如果列表中没有 Rephlo，请退出并重新启动应用。
    4. 授权后请重启 Rephlo。

重要提示：全局热键仅在以已签名的 .app 包运行 Rephlo 时才能生效。如果您是开发者，通过终端运行 dotnet run，热键可能无法工作。有关构建和运行 .app 包的方法，请参阅 macOS 安装教程。

"截图/Vision 功能无法使用"（macOS）​

  • 原因：Rephlo 需要 Screen Recording 权限才能捕获屏幕内容。
  • 解决方法：
    1. 打开 System Settings > Privacy & Security > Screen Recording。
    2. 在列表中找到 Rephlo 并将其切换为开启。
    3. 重启 Rephlo。

"权限对话框反复出现"​

  • 原因：Rephlo 运行时没有稳定的代码签名。每次重新构建都会改变二进制文件的哈希值，导致 macOS 将其视为新应用并重置权限。
  • 解决方法：请使用官方发行渠道提供的已签名 Rephlo 正式版。为已签名的应用授权一次后，权限会在后续更新中持续保留。

"已授予权限后叠加层仍不显示"​

  • 解决方法：
    1. 完全退出 Rephlo（右键点击托盘图标 > Exit）。
    2. 从 .app 包重新启动。
    3. 确认 Accessibility 和 Screen Recording 权限均已授予。
    4. 在 Settings > Hotkeys 中尝试 Test Overlay 按钮。

性能问题​

"响应速度非常慢"​

  • 原因：多种因素都可能拖慢响应速度。
  • 解决方法：
    • Space 上下文过大：可考虑压缩（compact）您的 Space。
    • 提供商响应较慢：切换到更快的模型，例如 GPT-5.4 Mini 或 Gemini 3.5 Flash，以获得更快的响应速度。
    • 本地模型（Ollama）：确认 GPU 是否被正常利用，检查 Ollama 日志。

"应用启动时感觉卡顿"​

  • 原因：加载了较大的 Spaces 或过多命令。
  • 解决方法：归档不再使用的命令，删除不再需要的旧 Spaces。

Chat 问题​

"Chat 历史记录丢失"​

  • 原因：对话记录保存在本地，可能已被清除。
  • 解决方法：请查看 Settings > Privacy 中的历史记录保留设置。若设置为 "Immediate"，则不会保留历史记录。

"Chat 总是遗忘上下文"​

  • 原因：您已超出该提供商的上下文窗口（context window）限制。
  • 解决方法：开始一段新对话，或使用上下文窗口更大的提供商。具体的上下文窗口大小请查阅该提供商的官方文档。

变量与模板问题​

"未找到变量" 或 "无效变量"​

  • 原因：变量名与有效的系统变量或 Space 中的文件都不匹配。
  • 解决方法：
    • 使用准确的语法：{{input_content}}、{{space_data_all}} 或 {{filename}}。
    • 对于文件变量：将文件名转换为 snake_case（例如 "Style Guide.pdf" -> {{style_guide_pdf}}）。
    • 确认该文件存在于当前激活的 Space 中。
    • 检查是否有拼写错误——变量名不区分大小写，但拼写必须正确。

"Standalone 模式下 Space 变量被忽略"​

  • 原因：Standalone 命令不会自动注入 Space 数据。
  • 说明：Standalone 模式让您拥有完全的手动控制权，{{space_data_all}} 等变量不会被自动替换。
  • 解决方法：切换到 Combination 模式 以自动注入 Space 数据，或手动将 Space 数据粘贴到您的提示词中。

Space 问题​

"Space 已满" 或 "Token 预算已超出"​

  • 原因：您的 Space 已超出所配置的 token 限制。
  • 解决方法：
    1. 打开该 Space 的数据视图，查看当前用量。
    2. 从 Space 中移除不太重要的文件，或提高 token 预算（最高 1,000,000 tokens）——这两种方式都能直接降低已超出存储预算的 Space 用量。
    3. 将数据模式切换为 🗜️ Compact，改为存储 AI 摘要而非完整文本——这会降低 Space 计入的 token 数（请确认相应的 credit 成本）。然后选择压缩级别：
      • Conservative：最小化摘要（保留细节）。
      • Balanced：适度摘要（默认，推荐）。
      • Aggressive：大幅摘要（最适合非常庞大的 Space）。
      • 注：对于非常庞大的 Space（约 128,000 tokens 或以上），Compact 功能会被设计性禁用——请改为移除文件或提高预算。
    4. 注意：🔍 Smart Search 通过仅发送相关片段，让每次请求保持精简，但它仍会将完整的原始文本计入 Space 的预算——因此它控制的是单次请求的成本，而非已超出存储上限的 Space。

"Space 摄取失败"（PDF/文档错误）​

  • 原因：文件无法处理——可能已损坏、设有密码保护，或格式不受支持。
  • 解决方法：
    • 确认 PDF 未设有密码保护。
    • 尝试从源应用程序重新导出该文档。
    • 对于扫描版 PDF：Rephlo 仅提取文本——不会读取 PDF 内嵌的图片。
    • 先在其他应用程序中打开该文件，确认文件未损坏。

图像生成问题​

"此提示词已被我们的内容政策拦截"​

  • 原因：您的图像提示词被内容审核标记，在生成开始前被拒绝。
  • 解决方法：改写提示词以移除不被允许的内容，然后重试。请参阅内容政策页面，了解哪些内容不被允许。

"内容审核暂时不可用"​

  • 原因：内容审核服务暂时不可用（临时性中断），因此无法对您的提示词进行检查。
  • 解决方法：请稍候片刻后重试。

获取帮助​

如何举报有害或不当的 AI 输出？​

  • 解决方法：
    • 已登录：点击侧边栏底部的头像 > Help > Report inappropriate content。
    • 任意时候：打开 Settings > About > Contact & Support > Report inappropriate content。
    • 此操作会在浏览器中打开 rephlo.app/contact，并预先选中相应的举报类别。