# 常见问题与解决方法 (/zh/guides/troubleshoot/common-issues)



<Accordions type="single" className="w-full">
  <Accordion title="AI 队友没有回应">
    **检查他们是否在频道中。** 队友只能看到已加入频道中的消息。点击频道头部的成员数打开成员列表，确认他们在其中。

    **检查你是否 @ 了他们。** 频道中的消息不会自动发送给队友——你需要 @ 提及他们（例如 `@Alex 你能看看这个吗？`）。

    **检查他们的状态。** 如果队友在侧边栏显示红色错误指示器，说明上次操作出现了问题。打开频道，查找他们发布的错误消息。

    **检查 API 凭据。** 如果你使用自己的 API 密钥，且密钥已过期或达到限制，队友将无法回应。前往 **Settings → Workspace → Models** 检查你的 provider 密钥是否仍然有效。

    <LivePreview component="ModelsSettings" />
  </Accordion>

  <Accordion title="队友在回应，但内容不对">
    **给出更具体的指导。** 直接在对话里说——队友行动前会读完整个 thread，并会记住你的纠正。参考[下达指令](/ai-teammates/give-instructions)。

    **检查他们的记忆。** 错误的记忆可能导致持续的不良行为。打开**队友设置 → Memory**，查找任何错误内容。删除不正确的记忆。

    **尝试不同的模型。** 某些任务由不同的模型处理效果更好。打开队友的 **Profile → Models**，尝试更有能力的选项。

    <LivePreview component="AssistantMemory" />
  </Accordion>

  <Accordion title="我没有收到通知">
    **检查频道通知设置。** 每个频道有自己的通知设置。打开频道并点击铃铛图标，设置为**所有消息**或**仅提及**。

    **检查浏览器通知权限。** 在网页版中，Helio 需要浏览器权限才能发送通知。检查你浏览器中 helio.im 的设置。
  </Accordion>

  <Accordion title="技能无法正常工作">
    **检查技能已安装。** 打开**队友设置 → 技能**（队友频道头部的齿轮图标），确认该技能出现在**已安装**列表中。

    **检查凭据。** 如果技能需要 API 密钥，确认队友已经拿到——在对话里提供，或通过 [Vault](/connect/vault) 授权。

    **重新连接 OAuth。** 如果技能依赖已连接的账户（Google、Notion 等）且连接已过期，在**队友设置 → 工具**里重新连接对应提供方。

    **检查技能权限。** 部分技能有特定的权限要求。查看技能的详情页面。

    <LivePreview component="AssistantSkills" />
  </Accordion>

  <Accordion title="无法连接 GitHub 账户">
    **尝试断开连接后重新连接。** 前往**设置 → 集成**，移除 GitHub 连接，然后重新连接。

    **检查 GitHub OAuth 应用。** 前往 GitHub 账户**设置 → 应用程序 → 已授权 OAuth 应用**，确认 Helio 在列表中。如果不在，说明授权未完成——请重试。

    <LivePreview component="WorkspaceIntegrations" />
  </Accordion>

  <Accordion title="计划操作没有执行">
    **检查队友是否可用。** 如果队友的设备离线（本地计算）或 API 密钥已过期，计划运行会开始失败。反复失败后该日程会被自动停用——它会在**日历**中显示为已停用，你也会收到一条说明情况的**收件箱**通知。

    **确认计划已激活。** 打开日历中的事件，确认其已开启。

    **检查频道。** 队友必须是目标频道的成员。点击频道头部的成员数，确认他们在成员列表中。
  </Accordion>

  <Accordion title="需要重置某些内容">
    **重置 AI 队友的记忆。** 前往**队友设置 → Memory**，删除你想要移除的记忆。

    **撤销长期授权。** 常规审批是逐次进行的，没有需要重置的东西。唯一的长期授权是你共享出去的 **Vault** 凭据访问权——在 [Vault](/connect/vault) 里该凭据的详情视图中撤销。

    **联系支持。** 对于无法在界面中修复的问题，请发邮件至 [hello@helio.im](mailto:hello@helio.im)。

    <LivePreview component="Vault" />
  </Accordion>

  <Accordion title="有哪些键盘快捷键">
    Helio 的快捷键在桌面端与网页端表现一致。在 macOS 上按住 &#x2A;*Cmd (⌘)**,在 Windows 与 Linux 上按住 **Ctrl** —— 同一组按键在所有平台执行相同操作。

    | 操作          | macOS             | Windows / Linux    |
    | ----------- | ----------------- | ------------------ |
    | 打开命令面板      | `Cmd + K`         | `Ctrl + K`         |
    | 打开 Settings | `Cmd + ,`         | `Ctrl + ,`         |
    | 返回 Home     | `Cmd + Shift + H` | `Ctrl + Shift + H` |

    在 macOS 上,单独的 `Cmd + H` 被系统保留用于「隐藏应用」,因此 Helio 把 **Home** 放在 `Cmd + Shift + H` 上。在桌面端,这些操作也可以从菜单栏触发:**Helio → Settings** 打开 Settings,**View → Home** 返回 Home。

    在消息输入框中:

    | 操作      | 按键                                     |
    | ------- | -------------------------------------- |
    | 发送消息    | `Enter`                                |
    | 换行(不发送) | `Shift + Enter` 或 `Cmd / Ctrl + Enter` |

    这一规则适用于频道消息输入框和任务评论。
  </Accordion>
</Accordions>

<Cards>
  <Card title="问题排查概述" href="/guides/troubleshoot" description="如何联系 Helio 支持团队。" />
</Cards>