故障排查
从真正负责故障的组件开始检查，不要通过删除持久数据来碰运气。
没有发现 Agent 或尚未登录
- 打开 Setup 或 Doctor，区分未安装、版本不受支持、配置错误和不可用。
- 确认使用 CodeTether 的同一操作系统用户可以运行 Provider。
- 使用 Provider 自己的登录流程，不要把凭证粘贴到 CodeTether。
- 修复安装或登录后，再明确执行一次 Provider 检查。
机器离线
- 确认执行机器已唤醒，Desktop 或 Node 服务正在运行。
- 确认显示的是当前状态还是最近一次已知状态。
- 使用 Relay 时，确认双方均已注册，机器链路通过认证检查。
连接或配对失败
使用一份新生成的配对会话，并采用产品实际展示的目标地址。配对码会过期，不要猜测、复用或用猜出的 Relay 地址替代。
无法继续原会话
检查原项目位置、机器、Provider 安装和原生会话是否仍存在。无法恢复时，CodeTether 会保留可读历史，但不会分叉或重放任务。
没有收到通知
- 检查操作系统是否允许 CodeTether 发送通知。
- 检查 Desktop 中关于审批、完成待复核和失败轮次的通知设置。
- 事项已在当前可见窗口中时，系统可能不再重复弹出通知。
- 即使系统通知不可用，收件箱仍会保留待处理历史。
网络响应丢失不代表可以自动重发 Provider 任务。如果执行归属不确定，请先检查会话，再决定是否开始新任务。