故障排除
从出错的步骤开始排查，保留草稿，并在重试前检查结果。
本文章节
Assistant 已连接，但无法回答
测试来源
如果使用本地 Agent，请在其自己的 CLI 或客户端中发送一次请求，并在那里检查登录状态、API 凭据、订阅和配额。
在 Orylo 中重新检查
打开 Assistant 设置，查看失败原因，在修复来源问题后重新运行检查。核对所配置的模型和选项。
尝试简单请求
先尝试不带附件的纯文本请求，再逐步加回原来的上下文，以区分连接故障、不支持的输入或大小限制。
缺少选区、截图或语音
- 如果你预期使用自动采集选中内容，请确认已经启用；该功能默认关闭。
- 检查相应的 macOS 权限，再从来源应用重试。选区无法读取时，不会用剪贴板内容替代。
- 对于语音，请核对你明确选择的引擎、支持的语言以及已下载的 Whisper 模型。Orylo 不会悄悄切换引擎。
- 对于 OCR，请核对全局开关和 Assistant 的图片偏好。提取失败时，请查看原始图片。
定时任务没有运行
检查 Orylo 当时是否正在运行、Mac 是否处于唤醒状态、计划是否启用，以及时区和下一次运行时间是否正确。再次发起前，请先查看运行历史中是否有失败记录。
错过的运行默认跳过。暂停后续触发不会停止已经开始的单次运行。
登录或设备使用受阻
确认网站和 Mac 使用相同的 Apple 或 Google 身份。检查试用或购买状态及已激活设备列表，再使用应用中的“刷新使用授权”。
达到激活上限时，停用 Mac 不会恢复滚动周期中已消耗的激活次数。请按账户页面提供的操作与时间提示处理。
安全地寻求帮助
通过反馈或发送邮件至 support@orylo.io，提供执行的操作、可见错误、应用与 macOS 版本，以及简洁的复现步骤。在网站提交反馈需要登录。
不要提供令牌、API 密钥、私人提示词或机密附件。如果会产生实际影响的任务可能已经完成，请先检查结果，再决定是否重试。