面板对接的常见环境
- Android 云手机实例
- 自动化脚本
- 代理网络
- 对象存储
- 团队账号体系
- 消息通知渠道
控制面板到底管什么
不是再做一个云手机售卖页，而是解决「多台设备怎么协同」的问题
很多团队的第一反应是用表格加人工盯屏来管理设备，设备到 30 台左右就会开始失控：谁改了哪台设备的脚本、昨天那条任务为什么只成功了一半、某台设备连续掉线三天没人发现。控制面板的价值在于把这些状态变成可查询的记录。
面板本身不生成账号，也不提供内容，它只做调度、执行与记录三件事。设备从哪家云手机厂商采购、脚本由谁编写，仍然由团队自己决定。
调度：把任务排进时间表
任务可以设为立即执行或定时执行，定时精度通常到分钟级。面板按设备空闲状态排队，避免同一台设备同时收到两条冲突指令，排队超过设定时长会自动标记为超时并通知负责人。
执行：一次下发，逐台回收
选中设备组后下发指令，面板为每台设备建立独立执行记录。执行结果分为成功、失败、超时三类，失败项附带错误码与最后一步截图，方便判断是脚本问题还是设备问题。
记录：让每次操作可回溯
所有下发动作写入操作日志，包含操作人、目标设备、指令内容与结果。日志默认保留 30 天，可按设备编号、时间范围、操作人三个维度筛选，导出为 CSV 后交给审核同事复核。
批量执行的具体做法
四条与日常操作直接相关的功能
按组下发，不按台点选
把设备按用途分成「新号预热」「日常维护」「待复核」等组，下发时直接选组。一个 50 台设备的组，下发一条指令通常在 10 秒内完成分发，执行结果在 2 分钟内基本回收完毕。
任务模板复用
常用的操作序列可以存成模板，例如「打开应用—停留 90 秒—滑动三次—退出」。模板支持参数占位，下发时填入不同停留时长，避免每次重新编排步骤。
失败重试策略
可设置失败后自动重试 1 至 3 次，重试间隔 30 秒起。重试仍失败的设备会被移入待处理列表，不会继续占用执行队列，也不会被反复重试拖慢整组进度。
执行窗口限制
可限定任务只在某个时间段执行，例如 09:00 至 22:00。超出窗口的任务自动顺延到下一个窗口，避免夜间无人值守时出现大批量失败却没人处理。
设备分组与标签
分组决定谁能操作、任务发给谁、告警推给谁
两级分组结构
一级按业务线划分，二级按批次划分，例如「业务线 A / 第 3 批」。两级结构足够覆盖大多数团队，层级再深反而增加维护成本。
自定义标签
设备可打上「高价值」「测试中」「待更换」等标签，标签与分组独立。标签适合表达临时状态，分组适合表达长期归属。
按组授权
运营账号只能看到被授权的分组，跨组操作需要管理员临时授权。授权记录写入日志，便于事后确认谁在什么时间获得了哪组设备的操作权限。
批量迁移
设备更换或业务调整时，可整组迁移到新分组，迁移不改变设备本身的运行状态，只改变归属关系，历史日志仍保留在原分组下可查。
从接入到稳定运行，通常经过六步
以下是多数团队的实际落地顺序，单组设备从接入到跑通一般需要 3 至 5 个工作日
接入过程不需要一次性把所有设备都接进来。建议先用 5 至 10 台设备跑通一条完整链路，确认脚本、网络、告警都正常后，再按批次扩到全部设备。
第 1 步：开通面板账号
注册后进入控制台，先创建一级分组，把设备按业务线归位。这一步通常 30 分钟内完成，不涉及设备接入。
第 2 步：接入云手机
在设备管理页填写云手机实例的接入信息，逐台或批量导入。导入后面板会做一次连通性检测，检测不通过的设备会标红并给出原因。
第 3 步：配置代理与网络
为每台设备绑定代理出口，面板记录设备与代理的对应关系。网络不通的设备在这一步就会被拦下，不会进入后续执行队列。
第 4 步：上传并试跑脚本
上传脚本文件或选择已有模板，先在 1 台设备上试跑，确认步骤、停留时长、异常处理逻辑都符合预期，再推广到整组。
第 5 步：设置定时与告警
为常用任务设置执行窗口与重试策略，配置告警接收人和通知渠道。建议至少保留一个管理员接收全部告警，避免通知只发到个人。
第 6 步：观察一周再扩量
首周重点看失败率和超时率。失败率持续高于 10% 时先排查脚本与网络，不建议直接扩到更大设备量，否则问题会被放大。
设备状态与处理建议
面板把设备状态收敛为五种，每种状态对应不同的处理动作。状态每分钟刷新一次，异常状态会同时触发告警。
| 状态 | 含义 | 常见原因 | 建议动作 |
|---|---|---|---|
| 在线 | 设备可正常接收指令 | — | 无需处理 |
| 执行中 | 正在执行某条任务 | — | 等待结果回收，不要重复下发 |
| 离线 | 超过 5 分钟未上报心跳 | 实例被关机、网络中断、厂商侧维护 | 先检查云手机控制台，再检查代理 |
| 异常 | 连续 3 次任务失败 | 脚本步骤不匹配、应用版本变化、设备卡死 | 查看最后一步截图，单台排查 |
| 待复核 | 任务完成但结果需人工确认 | 关键步骤未取到预期界面 | 由审核同事逐台确认后放行 |
状态表的价值在于把「感觉有问题」变成「哪一类问题」。多数团队接入两周后，离线与异常的占比会稳定在 5% 以内，超出这个比例通常意味着代理或脚本需要调整。
监控与告警
先看到问题，再谈处理效率
在线率看板
按分组展示当前在线设备数与离线设备数，离线超过 30 分钟的设备单独列出。看板每 60 秒刷新，不需要手动点刷新按钮。
任务成功率趋势
按天统计任务成功、失败、超时数量，生成 7 天与 30 天两条趋势线。成功率突然下滑时，通常能对应到某次脚本更新或代理调整。
分级告警
离线告警、失败率告警、超时告警分开发送，接收人可按分组配置。告警默认 10 分钟内不重复发送同一设备的同类问题，避免通知刷屏。
日志检索
支持按设备编号、任务名称、时间范围组合检索，检索结果可导出。排查「昨天下午那批任务为什么失败」这类问题时，通常几分钟内能定位到具体设备与步骤。
账号、权限与数据边界
多账号运营绕不开的问题，提前说清楚
三级角色
管理员、运营、审核三种角色。管理员管分组与授权，运营执行任务，审核只读日志与待复核列表，不能下发指令。
操作留痕不可删改
日志写入后不支持单条删除，只能按保留周期整体过期。需要长期留存的团队可以在过期前导出到自己的存储。
脚本与凭据分离
脚本文件与设备接入凭据分开存储，运营账号看不到凭据明文。凭据仅在设备接入与连通性检测时由系统调用。
登录保护
支持绑定二次验证，异地登录会触发邮件提醒。团队账号建议开启，尤其是拥有全部分组权限的管理员账号。
一个典型团队的上线节奏
以 60 台设备、3 人运营小组为例，实际排期会因脚本复杂度浮动
- 第 1 周
梳理设备与分组
把现有设备按业务线和批次归入两级分组，确定每组的负责人和告警接收人。这一步不碰脚本，先把归属关系理清。
- 第 1 周
接入并做连通性检测
批量导入设备接入信息，逐台确认在线状态与代理出口。建议先接 10 台，确认无误后再接剩余设备。
- 第 2 周
试跑与调脚本
选 1 台设备试跑核心脚本，记录每步耗时与失败点，调整停留时长和异常分支。这一步往往比预期多花一天。
- 第 2 周
配置定时与告警
设置执行窗口、重试次数、告警接收人。建议先只开离线告警，稳定后再开失败率告警，避免初期通知过多。
- 第 3 周起
全量运行并观察
扩到全部设备，首周每天看一次成功率趋势，失败率高于 10% 时暂停扩量，先定位原因再继续。
控制面板最容易踩的坑不是功能不够，而是一开始就把所有设备、所有脚本全接进来。设备越多，单个脚本问题造成的影响面越大。更稳妥的做法是先跑通一条链路，再按批次扩量，每扩一批观察两到三天。面板提供的是调度和记录能力，但节奏仍然由人控制。
内部使用建议 · 来自产品团队的落地经验
常见问题
面板本身提供云手机吗？
不提供。面板是架在云手机之上的调度与记录工具，云手机实例需要团队自行从云手机厂商采购后接入。这样做的原因是不同团队对设备配置、网络出口的要求差异很大，统一采购反而限制选择。
最多能管理多少台设备？
起步版 20 台，团队版 80 台，规模版 300 台，超过 300 台可按每 100 台加购。多数 3 到 5 人的运营团队落在 20 到 80 台区间，设备再多通常需要同步增加审核人力。
脚本需要用什么语言写？
面板接受基于 Appium、UIAutomator 或设备无障碍服务编写的操作脚本，以任务形式挂载。如果团队已有脚本，通常只需要按面板的任务模板格式做一次包装，不需要重写全部逻辑。
任务失败会怎么处理？
失败任务会附带错误码与最后一步截图，可按设置自动重试 1 至 3 次。重试仍失败的设备移入待处理列表并触发告警，不会继续占用执行队列，也不会被反复重试拖慢整组进度。
日志保留多久，能不能导出？
起步版保留 30 天，团队版 90 天，规模版 180 天。所有日志支持按设备、任务、时间范围筛选后导出为 CSV，需要长期留存的团队可以在过期前导出到自己的存储。
数据安全怎么保证？
脚本文件与设备接入凭据分开存储，运营账号看不到凭据明文。日志写入后不可单条删改，只能按保留周期整体过期。支持二次验证与异地登录提醒，管理员账号建议开启。
联系我们
工作日 10:00 至 19:00 在线，工单通常在 4 小时内回复
接入前的问题建议直接发邮件，附上设备数量、云手机厂商、脚本大致类型三项信息，回复会更有针对性。涉及账号权限或账单的问题，请用管理员邮箱发送，便于核对身份。
- 邮件 [email protected]，适合接入咨询、账单问题与功能建议，工作日通常 4 小时内回复。
- 工单 登录控制台后在右上角提交工单，可附截图与设备编号，适合排查具体设备的执行异常。
- 响应时间 起步版与团队版为工作日 8 小时内响应，规模版为 4 小时内响应。紧急离线问题建议同时发邮件并在标题注明「设备离线」。