# 脚本库操作

---

## 一、功能简介

**脚本库**是量子云机平台提供的自动化脚本管理与执行中心，支持用户浏览公共脚本、复制到个人库、编写和运行 JavaScript 自动化脚本。脚本将在指定的云手机设备上执行，实现 TikTok、YouTube、Instagram 等 App 的自动化操作。

---

## 二、进入脚本库

1. 登录量子云机平台后，在左侧导航栏点击 **「脚本库」**。
2. 页面顶部有两个标签页：
   - **脚本商店**：浏览和获取平台提供的公共脚本。
   - **我的脚本库**：管理自己创建或保存的脚本。

![](./assets/2026-03-27-17-13-18-image.png)

---

## ## 三、脚本商店

### 3.1 功能说明

脚本商店是平台预置的公共脚本集合，用户无需自行编写，可直接使用或复制后二次编辑。

### 3.2 脚本卡片说明

每个脚本以卡片形式展示，包含以下信息：

| 字段   | 说明                                 |
| ---- | ---------------------------------- |
| 脚本名称 | 如 `tiktok_follow`、`youtube_view` 等 |
| 语言标签 | 当前均为 `Javascript`                  |
| 步骤摘要 | 脚本执行流程的简要描述                        |
| 复制脚本 | 将该脚本复制一份到「我的脚本库」，方便个人保存和二次编辑       |
| 运行   | 直接选择云手机运行该脚本（运行方式与我的脚本库完全一致）       |

## 四、我的脚本库

### 4.1 脚本卡片说明

每个脚本以卡片形式展示，包含以下信息：

| 字段      | 说明                                           |
| ------- | -------------------------------------------- |
| 脚本名称    | 如 `tiktok_view_use`、`tiktok_bio` 等           |
| 语言标签    | `Javascript`/ Shell                          |
| 步骤摘要    | 脚本执行流程的简要描述，如「启动 → 回桌面 → 启动TikTok → 清弹窗 → …」 |
| 编辑脚本    | 点击进入脚本编辑器                                    |
| 运行      | 快速选择云手机并运行该脚本                                |
| ···（更多） | 复制脚本、删除等操作                                   |

### 4.2 新建脚本

点击脚本列表右下角的 **「+」** 按钮，填写脚本名称/脚本类型/脚本描述，即可创建一个新脚本。

![](./assets/2026-03-27-17-14-38-image.png)

![](./assets/2026-03-27-17-15-23-image.png)

---

## 五、编辑脚本

点击任意脚本卡片上的 **「编辑脚本」** 按钮，进入脚本编辑页面。

![](./assets/2026-03-27-17-15-01-image.png)

### 5.1 页面布局

- **顶部导航**：显示当前路径（如 `脚本库 / tiktok_view_use`），左侧返回箭头可回到脚本列表。
- **右上角按钮**：
  - `模型管理`：管理 AI 模型配置。
  - `AI脚本生成`：通过 AI 自动生成脚本代码。
- **代码编辑区**：中央深色区域，支持直接编辑 JavaScript 脚本代码。
- **输出结果区**：代码编辑区下方的浅色区域，运行脚本后将在此显示日志输出。
- **右侧面板**：显示当前绑定的云手机 ID，可点击「选择云手机」进行绑定。

### 5.2 脚本配置参数说明（以 tiktok_view_use 为例）

```javascript
const CONFIG = {
  packageName: "com.zhiliaoapp.musically", // TikTok 国际版包名
  minWatchMs: 2000,       // 单个视频最短观看时间（毫秒）
  maxWatchMs: 5000,       // 单个视频最长观看时间（毫秒）
  minProfileStayMs: 1000, // 主页最短停留时间
  maxProfileStayMs: 3000, // 主页最长停留时间
  enterProfileChance: 0.88, // 进入主页的概率（0~1）
  maxLoop: 9,             // 最大循环次数
  swipeDurationMin: 350,  // 滑动最短时长（毫秒）
  swipeDurationMax: 700,  // 滑动最长时长（毫秒）
  debug: true             // 是否开启调试模式
};
```

根据需要修改以上参数，可灵活控制脚本的执行行为。

### 5.3 底部操作按钮

| 按钮   | 功能            |
| ---- | ------------- |
| 保存   | 保存当前脚本修改      |
| 清空日志 | 清除输出结果区的日志内容  |
| 运行   | 在已选云手机上立即执行脚本 |
| 终止脚本 | 停止当前正在运行的脚本   |

![](./assets/2026-03-27-17-22-02-image.png)

---

## 六、选择云手机并运行脚本

### 6.1 从脚本列表快速运行

1. 在「我的脚本库」页面，点击脚本卡片上的 **「运行」** 按钮。
   
   ![](./assets/2026-03-27-17-22-26-image.png)

2. 弹出「选择云手机」对话框，列出当前账号下所有云手机设备，包含以下信息：
   
   ![](./assets/2026-03-27-17-23-22-image.png)

| 字段    | 说明                 |
| ----- | ------------------ |
| 序号    | 设备编号               |
| 云手机ID | 设备唯一标识符            |
| 设备状态  | 如「运行中」（绿色）         |
| Bee状态 | 如「已安装/运行中/在线」（绿色点） |
| 备注    | 用户自定义备注            |

3. 勾选目标设备后，点击 **「运行」** 按钮，脚本将立即下发到该云手机执行。

### 6.2 从编辑页面运行

1. 在脚本编辑页面，点击右侧面板的 **「选择云手机」** 按钮。

2. 在弹出对话框中，点击设备行左侧的单选按钮选中目标设备（选中后显示蓝色圆点）。

3. 点击 **「确定」** 完成绑定，云手机 ID 将显示在右侧面板。

4. 点击底部 **「运行」** 按钮执行脚本，运行日志将实时显示在「输出结果」区域。
   
   ![](./assets/2026-03-27-17-24-04-image.png)

> **提示**：请确保所选云手机的 Bee 状态为「已安装/运行中/在线」，否则脚本可能无法正常执行。



## 七、任务中心

脚本运行后，系统会自动在**任务中心**生成一条任务记录，方便用户追踪每次脚本的执行情况。

### 7.1 进入任务中心

在左侧导航栏点击 **「任务中心」**，即可查看所有运行日志。

![](./assets/2026-03-27-17-52-10-image.png)

### 7.2 筛选与查询

页面顶部提供以下筛选条件，可组合使用快速定位任务：

| 筛选项   | 说明                 |
| ----- | ------------------ |
| 云手机ID | 输入指定云手机 ID 进行过滤    |
| 任务类型  | 可选「全部」或具体类型（如脚本执行） |
| 运行状态  | 可选「全部」、成功、失败、已取消等  |
| 执行时间  | 选择日期范围筛选           |

右上角 **「刷新」** 按钮可手动刷新任务列表。

### 7.3 任务列表字段说明

| 字段    | 说明                                      |
| ----- | --------------------------------------- |
| 任务ID  | 系统自动生成的唯一任务编号，如 `T40177459306224588365` |
| 云手机ID | 执行该任务的云手机设备编号                           |
| 任务类型  | 当前均为「脚本执行」                              |
| 执行时间  | 任务开始执行的时间，如 `2026-03-27 14:31`          |
| 运行状态  | 见下方状态说明                                 |
| 操作    | 可对任务进行的操作，见下方操作说明                       |

### 7.4 运行状态说明

| 状态  | 颜色    | 含义           |
| --- | ----- | ------------ |
| 成功  | 绿色    | 脚本已正常执行完成    |
| 失败  | 红色/橙色 | 脚本执行过程中发生错误  |
| 已取消 | 灰色    | 任务被手动终止或系统取消 |

### 7.5 操作按钮说明

不同运行状态下，操作栏显示的按钮会有所不同：

| 按钮   | 说明                    |
| ---- | --------------------- |
| 重新执行 | 以相同参数重新运行该任务          |
| 执行报告 | 查看任务的详细执行日志和错误报告      |
| 删除   | 删除该条任务记录              |
| 单步执行 | 逐步执行脚本，用于调试排查         |
| 终止   | 终止当前正在运行的任务（仅运行中状态显示） |

### 7.6 查看任务执行详情

点击操作栏中的 **「执行报告」** 按钮，弹出「任务执行详情」对话框，包含两部分内容：

**① 打印输出**（左侧）

显示脚本运行过程中的实时日志，例如：

```
14:31:03.980/V: Running [$files/tmp_script.js [cache]].
14:31:03.985/D: 脚本启动
14:31:12.204/D: ---------- 第 1 轮 ----------
14:31:18.189/D: 本条视频观看时长: 4129ms
14:31:18.950/D: 命中随机点赞
14:31:20.956/E: TypeError: Cannot call method "click" of null.
14:31:20.960/V: finished in 16.978 seconds.
```

日志级别说明：`V` = 系统信息，`D` = 调试信息，`E` = 错误信息。

**② 执行报告**（右侧）

当脚本执行失败时，右侧会显示具体的错误信息和调用栈，便于定位问题，例如：

```
TypeError: Cannot call method "click" of null.
  at likeAndReturn (tmp_script.js:134:0)
  at main (tmp_script.js:164:0)
  at /data/user/0/...tmp_script.js:171:0
```

> **提示**：若脚本状态为「失败」，建议先查看执行报告中的错误信息，根据报错内容调整脚本代码后重新执行。

---



## 八、注意事项

1. **合规使用**：请遵守 TikTok 平台服务条款，避免过度自动化操作导致账号风险。
2. **参数调整**：建议根据实际需求合理设置循环次数和时间参数，模拟正常用户行为。
3. **设备状态**：运行脚本前确认云手机处于「运行中」状态，Bee 插件已安装并在线。
4. **日志查看**：脚本运行过程中可在「输出结果」区域实时查看执行日志，便于排查问题。
5. **及时终止**：如需中途停止脚本，点击「终止脚本」按钮，避免设备资源占用。

---

*如有更多问题，请点击页面右下角「联系我们」获取客服支持。*