#Bee 使用手册

## 1. 功能概述

Bee 是部署在云手机上的辅助组件，用于为云手机提供自动化执行与状态监控能力。安装 Bee 后，用户可以在平台中更方便地管理云手机运行状态，并执行脚本库中的 AutoJS 脚本。

Bee 主要提供以下能力：

### 1.1 AutoJS 脚本执行

安装 Bee 后，云手机支持执行脚本库中的 **AutoJS 自动化脚本**，用于自动点击、流程执行等自动化场景。

### 1.2 云手机状态监控

安装 Bee 后，可对云手机运行状态进行监控，包括：

- IP 状态
- 心跳状态

---

## 2. 适用前提

在使用 Bee功能前，请确认：

- 已创建云手机
- 账号具备管理权限
- 云手机网络正常

---

## 3. Bee 安装流程

### 3.1 默认状态

云手机列表中，Bee默认状态为：

> 未安装
> 
> ![](./assets/2026-04-02-11-00-35-image.png)

### 3.2 安装步骤

1. 进入 **云手机列表**

2. 勾选需要安装 Bee 的设备

3. 点击 **批量操作

4. 选择 **Bee设置

5. 点击 **安装 Bee

6. 在弹窗中点击 **确定安装
   
   
   
   ![setprivacy5.gif](./assets/90c785a53e799d7a3bb06d48a21ba34ddfc9409f.gif)

 

### 3.3 安装结果

安装完成后，Bee状态将变为：

- 已安装/运行中/在线

---

## 4. Agent 状态说明

| 状态         | 说明            |
| ---------- | ------------- |
| 未安装        | 未安装 Bee       |
| 已安装/未运行/离线 | 已安装但未完全运行     |
| 已安装/运行中/离线 | 网络错误          |
| 已安装/运行中/在线 | Bee已连接平台且网络正常 |

> ✅ 理想状态：已安装/运行中 / 在线

---

## 5. 脚本库使用说明

### 5.1 功能说明

脚本库支持执行 AutoJS 自动化脚本。

![setprivacy4.gif](./assets/9b6d1635d8d4bfc5cae72beec54b79c26e5c4e43.gif)###



### 5.2 执行条件

执行脚本前需满足：

- Bee 已安装
- Bee状态正常
- 云手机在线

### 5.3 限制说明

> ⚠️ 以下情况无法执行脚本：

- Bee未安装
- Bee 不在线

---

## 6. 状态监控说明

### 6.1 IP 状态

用于判断云手机网络是否正常。

### 6.2 心跳状态

用于判断 Bee与平台连接是否正常：

- 正常：设备运行稳定
- 异常：可能离线或网络异常

---

## 7. 推荐使用流程

1. 安装 Bee
2. 确认状态为 **运行中 / 在线**
3. 检查 IP 和心跳状态
4. 执行脚本库脚本

---

## 8. 常见问题

### 8.1 为什么脚本无法执行？

可能原因：

- Agent 未安装
- Agent 不在线
- 网络异常

### 8.2 安装后无法立即使用？

Agent 可能需要时间启动，请等待状态变为：

> 运行中 / 在线

### 8.3 如何确认安装成功？

状态由“未安装”变为：

- 已安装 / 运行中 / 在线

### 8.4 心跳异常怎么办？

建议：

1. 检查云手机是否在线
2. 检查网络
3. 确认 Agent 运行状态

---

## 9. 故障排查

### 9.1 未安装状态不变

- 重新安装
- 确认点击“确定安装”

### 9.2 已安装但不可用

- 检查是否在线
- 检查网络状态

### 9.3 Agent 离线

- 检查网络
- 重启或重新安装 Agent

---

## 10. 注意事项

- 未安装 Agent 无法执行脚本
- 不在线无法执行脚本
- 建议执行脚本前确认状态正常

---

## 11. 快捷路径

### 安装 Agent

云手机列表 → 批量操作 → Agent 设置 → 安装 Agent

### 查看状态

云手机列表 → Agent 状态列

### 执行脚本

脚本库 → 选择脚本 → 运行→选择云手机
