# Bee User Guide

<!-- Bee 使用手册 -->

## 1. Overview

<!-- 功能概述 -->

Bee is a component deployed on cloud phones that provides automation execution and status monitoring capabilities. After installation, users can manage cloud phone status more efficiently and execute AutoJS scripts from the script library.

<!-- Bee 是部署在云手机上的辅助组件，用于提供自动化执行与状态监控能力。安装后可执行脚本并管理设备状态。 -->

Bee provides the following capabilities:

<!-- Bee 提供以下能力 -->

### 1.1 AutoJS Script Execution

<!-- AutoJS 脚本执行 -->

After installing Bee, cloud phones can execute **AutoJS automation scripts** from the script library for automated actions such as clicking and workflow execution.

<!-- 安装 Bee 后，可执行 AutoJS 自动化脚本，实现自动点击、流程执行等 -->

### 1.2 Device Status Monitoring

<!-- 云手机状态监控 -->

After installing Bee, you can monitor the cloud phone status, including:

<!-- 可监控以下状态 -->

- IP status  
- Heartbeat status  

<!-- IP 状态、心跳状态 -->

---

## 2. Prerequisites

<!-- 适用前提 -->

Before using Bee, ensure:

<!-- 使用前请确认 -->

- Cloud phones have been created  
- You have sufficient permissions  
- Cloud phone network is normal  

<!-- 已创建云手机、具备权限、网络正常 -->

---

## 3. Bee Installation

<!-- Bee 安装流程 -->

### 3.1 Default Status

<!-- 默认状态 -->

In the cloud phone list, the default Bee status is:

<!-- 默认状态 -->

> Not Installed  
> 
> ![](./assets/2026-04-02-11-17-04-image.png)

<!-- 未安装 -->

> *(Image placeholder)*  

<!-- 图片占位（本地路径图片需替换为线上地址） -->

### 3.2 Installation Steps

<!-- 安装步骤 -->

1. Go to **Cloud Phone List**  
2. Select the target devices  
3. Click **Batch Operation**  
4. Select **Bee Settings**  
5. Click **Install Bee**  
6. Click **Confirm** in the popup  

<!-- 云手机列表 → 勾选 → 批量操作 → Bee 设置 → 安装 → 确认 -->

![setprivacy5.gif](./assets/90c785a53e799d7a3bb06d48a21ba34ddfc9409f.gif)

<!-- 动图占位 -->

### 3.3 Installation Result

<!-- 安装结果 -->

After installation, the Bee status will become:

<!-- 安装后状态 -->

- Installed / Running / Online  

<!-- 已安装 / 运行中 / 在线 -->

---

## 4. Bee Status Description

<!-- Bee 状态说明 -->

| Status                            | Description                           |
| --------------------------------- | ------------------------------------- |
| Not Installed                     | Bee is not installed                  |
| Installed / Not Running / Offline | Installed but not running             |
| Installed / Running / Offline     | Network error                         |
| Installed / Running / Online      | Bee is connected and working normally |

<!-- 状态说明 -->

> ✅ Recommended status: Installed / Running / Online  

<!-- 理想状态 -->

---

## 5. Script Library Usage

<!-- 脚本库使用说明 -->

### 5.1 Description

<!-- 功能说明 -->

The script library allows execution of AutoJS automation scripts.





![setprivacy4.gif](./assets/9b6d1635d8d4bfc5cae72beec54b79c26e5c4e43.gif)

<!-- 脚本库支持执行 AutoJS 自动化脚本 -->

### 5.2 Requirements

<!-- 执行条件 -->

Before executing scripts, ensure:

<!-- 执行前需满足 -->

- Bee is installed  
- Bee status is normal  
- Device is online  

<!-- Bee 已安装 / 正常 / 在线 -->

### 5.3 Limitations

<!-- 限制说明 -->

> ⚠️ Scripts cannot be executed in the following cases:

<!-- 以下情况无法执行 -->

- Bee is not installed  
- Device is offline  

<!-- 未安装 / 不在线 -->

---

## 6. Monitoring

<!-- 状态监控说明 -->

### 6.1 IP Status

<!-- IP 状态 -->

Used to determine whether the cloud phone network is functioning properly.

<!-- 判断网络是否正常 -->

### 6.2 Heartbeat Status

<!-- 心跳状态 -->

Used to determine whether the Bee is properly connected to the platform:

<!-- 判断连接 -->

- Normal: device is stable  
- Abnormal: device may be offline or network is unstable  

<!-- 正常 / 异常 -->

---

## 7. Recommended Workflow

<!-- 推荐使用流程 -->

1. Install Bee  
2. Ensure status is **Running / Online**  
3. Check IP and heartbeat status  
4. Execute scripts from the script library  

<!-- 安装 → 确认 → 检查 → 执行 -->

---

## 8. FAQ

<!-- 常见问题 -->

### 8.1 Why can't scripts be executed?

<!-- 为什么脚本无法执行 -->

Possible reasons:

<!-- 可能原因 -->

- Bee is not installed  
- Bee is offline  
- Network issue  

<!-- 未安装 / 不在线 / 网络问题 -->

### 8.2 Why is Bee not usable immediately after installation?

<!-- 为什么安装后不能立即使用 -->

Bee may take some time to start.

<!-- 需要启动时间 -->

### 8.3 How to confirm installation success?

<!-- 如何确认安装成功 -->

The status changes from "Not Installed" to:

<!-- 状态变化 -->

- Installed / Running / Online  

---

### 8.4 What to do if heartbeat is abnormal?

<!-- 心跳异常怎么办 -->

Recommended steps:

<!-- 建议 -->

1. Check if the device is online  
2. Check network connectivity  
3. Verify Bee is running  

---

## 9. Troubleshooting

<!-- 故障排查 -->

### 9.1 Status remains "Not Installed"

<!-- 一直未安装 -->

- Retry installation  
- Ensure "Confirm" was clicked  

### 9.2 Installed but not usable

<!-- 已安装但不可用 -->

- Check if device is online  
- Check network status  

### 9.3 Bee is offline

<!-- Bee 离线 -->

- Check network  
- Restart or reinstall Bee  

---

## 10. Notes

<!-- 注意事项 -->

- Scripts cannot run without Bee  
- Offline devices cannot execute scripts  
- Always check status before execution  

<!-- 未安装 / 不在线无法执行 -->

---

## 11. Quick Access

<!-- 快捷路径 -->

### Install Bee

Cloud Phone List → Batch Operation → Bee Settings → Install AgBee

### Check Status

Cloud Phone List → Bee Status  

### Execute Script

Script Library → Select Script → Run → Select Cloud Phone  

<!-- 执行路径 -->