设备显示离线通常表示设备无法与Hamibot服务器建立稳定连接。根据你的描述（三台设备同时离线，且今天更换了控制设备），以下是常见原因和解决方案：

常见原因

1. 网络连接问题

   • 被控制的设备（运行Hamibot的手机）可能断开了Wi-Fi或移动数据，导致无法上报在线状态。
   • 更换控制设备后，若新设备的网络环境不稳定（如公共Wi-Fi限制后台流量），也可能间接影响脚本调度，但不会直接导致被控设备离线。

2. Hamibot应用未正常运行

   • 被控设备的Hamibot应用可能被系统强制停止（例如：手动杀进程、省电模式限制后台活动）。
   • 更换控制设备后，你可能在新设备上操作了脚本管理（如批量停止），导致脚本未运行。

3. 服务端同步延迟

   • 更换控制设备时，若新设备的Hamibot账号未完全同步（如缓存未刷新），控制台可能短暂显示错误状态，但实际设备状态通常在5分钟内自动更新。

解决步骤

按顺序排查，重点检查被控设备自身状态（而非控制设备）：

1. 检查被控设备的网络和应用

   • 在每台离线设备上：
     • 确认Wi-Fi/数据已开启，并能正常访问互联网（如打开浏览器测试）。
     • 手动打开Hamibot应用，确保首页显示“在线”状态（若显示离线，重启应用）。
     • 关闭省电模式：进入设备 设置 > 电池 > 应用启动管理，将Hamibot设为“允许后台活动”（不同手机路径略有差异）。

2. 验证脚本运行状态

   • 在离线设备上：
     • 打开Hamibot应用，进入脚本列表，检查目标脚本是否正在运行（若已停止，手动启动）。
     • 若脚本依赖特定权限（如无障碍服务），前往 设置 > 系统 > 无障碍 确认已启用。

3. 检查控制设备操作记录

   • 登录新控制设备的Hamibot控制台（https://hamibot.com/dashboard），查看：
     • 设备管理页：是否有误操作（如批量停用设备）。
     • 脚本日志：确认最近是否有“停止脚本”的API调用（参考知识库中的DELETE /v1/scripts/{脚本_id}/run操作）。
     • 若不确定，尝试通过API重新启动脚本（示例代码见下方）。

4. 重启服务

   • 在每台被控设备上：
     • 重启手机（清除临时系统问题）。
     • 重新登录Hamibot账号（设置 > 账号 > 退出登录，再重新登录）。

调试建议（使用API验证）

若问题持续，用以下代码检查设备真实状态（替换你的令牌和设备_id）：

// 文档地址 https://docs.hamibot.com/
var res = http.request('https://api.hamibot.com/v1/devices', {
  method: 'GET',
  headers: {
    authorization: 'hmp_你的令牌', // 替换为你的实际令牌
  },
});
log("设备状态:", res.body.json());

• 响应中online: false：表示设备确实离线，需优先解决被控设备的网络/应用问题。
• 响应正常但控制台显示异常：清除控制台浏览器缓存，或更换浏览器重试。

注意事项

• 更换控制设备不会直接影响被控设备的在线状态（被控设备状态仅取决于自身网络和应用）。
• 若以上步骤无效，可能是Hamibot服务端临时问题，稍等10分钟后重试；仍无法解决，请通过Hamibot控制台 帮助中心 > 联系客服 提交工单（需提供设备ID和日志截图）。

90%的离线问题由被控设备的后台权限或网络中断导致。优先确保每台设备的Hamibot应用保活运行，通常可快速恢复。

补充回答 1

配对文件“已超出”不是导致设备离线的直接原因，但可能间接影响设备状态。以下是关键分析和解决方案：

为什么配对文件问题与离线无关？

1. 配对文件的作用仅限初始配对

   • 配对文件是一次性快速配对工具（替代手动输入配对码），仅在设备首次添加到账号时使用（参考知识库文档[3]）。
   • 设备配对成功后，其在线状态完全由以下因素决定：
     • 设备自身的网络连接（Wi-Fi/数据）
     • Hamibot应用是否在后台保活运行
     • 设备系统是否限制后台活动
   • 配对文件失效（如“已超出”）不会导致已配对设备离线。

2. “已超出”的具体含义

   • 配对文件有24小时有效期（系统自动生成后），超时自动失效。
   • 若显示“已超出”，说明你尝试使用的配对文件已过期（例如：昨天生成的文件今天无法使用）。
   • 此问题仅影响新设备配对，与已配对设备的运行状态无关。

为什么三台设备同时离线？根本原因

配对文件问题只是表象，核心问题仍是被控设备的后台运行环境被破坏。结合你更换控制设备的操作：

1. 省电策略重置

   • 更换控制设备后，新设备可能触发了系统级省电策略（如小米/华为的“智能后台管理”），强制杀死Hamibot后台进程。
   • 现象：设备在Hamibot控制台显示离线，但手机上Hamibot应用图标仍存在（实际进程被杀）。

2. 无障碍服务被禁用

   • 更换设备时，系统可能重置了无障碍权限（尤其Android 12+系统）。
   • 检查路径：设备设置 > 系统 > 无障碍 > 已下载的服务 → 确认 Hamibot 处于启用状态。

立即解决方案（针对三台设备同时离线）

步骤1：强制保活Hamibot应用（关键！）

在每台离线设备上操作：

✅ 完成后重启Hamibot应用，观察控制台5分钟内是否恢复在线。

步骤2：重置无障碍服务

1. 打开Hamibot应用 → 点击右上角 ≡ → 设置 → 无障碍服务
2. 关闭再重新开启无障碍开关（系统会弹出权限确认，务必点击 允许）
3. 返回脚本列表，手动启动一个简单脚本（如“自动点击”），验证是否正常运行。

步骤3：检查服务端状态

运行以下代码（替换hmp_你的令牌），确认设备真实状态：

// 文档地址 https://docs.hamibot.com/
var res = http.request('https://api.hamibot.com/v1/devices', {
  method: 'GET',
  headers: { authorization: 'hmp_你的令牌' }
});
log("设备实时状态:", res.body.json());

• 若响应中 online: false → 设备确实未连接（按步骤1处理）
• 若响应中 online: true 但控制台仍显示离线 → 清除浏览器缓存 或更换浏览器访问控制台

配对文件问题的处理（独立操作）

如果后续需要添加新设备：

1. 在Hamibot控制台点击 添加设备 → 系统自动生成新的配对文件（24小时内有效）
2. 将新文件下载到目标设备 → 打开Hamibot APP → 设置 > 高级 > 选择配对文件
3. 切勿使用旧文件，过期文件无法恢复。

为什么更换控制设备会引发此问题？

• 新控制设备可能通过API误操作（例如：调用 DELETE /v1/scripts/{脚本_id}/run 停止了所有脚本）。
• 检查操作记录：
  登录控制台 → 脚本管理 → 查看目标脚本的 运行日志 → 筛选 "停止脚本" 操作。
  若发现异常停止记录，用以下代码重启脚本（替换参数）：

  // 文档地址 https://docs.hamibot.com/
  http.request('https://api.hamibot.com/v1/scripts/你的脚本_id/run', {
    method: 'POST',
    headers: { authorization: 'hmp_你的令牌' },
    body: JSON.stringify({ devices: [{ _id: '设备_id', name: '设备名' }] })
  });
  

99%的同类问题通过 强制保活+重置无障碍服务 解决。如果操作后仍离线，请提供：

1. 手机型号和Android版本（如小米13/Android 14）
2. 控制台设备列表截图（隐藏敏感信息）
3. 运行上述调试代码的log输出
   通过Hamibot控制台 帮助中心 > 提交工单 联系技术支持，他们能直接查看设备心跳日志。