技能介绍

移动端开发、测试人员经常要在远程真机上验证页面、跑自动化脚本，但每次切到云真机网页面板手工选设备、看截图、敲 ADB，流程琐碎且难以交给 AI 助手接管。
Agent 宿主拉起的往往是非交互式子 shell，~/.zshrc、~/.bashrc 里的 export 不会被加载，导致凭证明明写了却读不到。
已装的旧版 CLI 会"假装能用"：新参数被静默忽略，埋点归类出错，事后排查成本很高。

触发分两层：消息里带 "优测设备" 前缀时强触发，直接进入执行；否则按云真机、截图、UI 自动化、ADB 等关键词常规召回，必要时先确认是否真的是 SAAS 场景。
激活后先做环境与版本一体化探测，把本地 CLI/SDK 版本与 references/*/pyproject.toml 声明的版本做语义比较，落后或不一致就强制 --reinstall 重装，三项校验全过才继续。
鉴权走优测官网 OpenAPI（SAAS）通路：UBOX_USER_TOKEN、UBOX_PROJECT_TOKEN、UBOX_GROUP_ID 三元组缺一不可；凭证按进程环境变量、.env、shell rc 文件、Windows 注册表的顺序读取，展示时只保留前 4 后 4。
每条命令显式携带 --mode saas，流量统一经由 cloudphone-labpaas-adapter 网关，并与 PAAS 通路严格区分。
能力覆盖：设备列表/连接/断开、截图与录屏、XPath/OCR/坐标点击、应用安装启动、剪贴板读写、Logcat 采集与 ANR/Crash 监控。

本 SKILL 只服务 SAAS 通路，PAAS 的单 UBOX_AUTH_TOKEN 在此模式下不生效，两者不要混用。
SAAS 模式无自动续期、无自动释放，用完必须手动断开设备，否则资源持续占用。
会话级埋点标记 UBOX_CLIENT_SOURCE / UBOX_CLIENT_LABEL 只能注入当前会话，写进 rc 或注册表会污染用户手工调用的统计口径。
凭证脱敏是硬要求，对话、日志、命令输出中都不能出现完整 Token 明文。