遇到问题，
先从运行记录开始
连接、投屏、自动化、AI 与授权的高频问题都在这里。反馈问题时附上运行记录导出与问题截图， 比单纯描述“不能用”更容易定位。
五个步骤，第一次投屏
安装包已包含运行依赖。第一次启动通常没有设备，设备墙会显示空状态引导。
运行安装包完成安装，双击桌面快捷方式启动。首次启动会自动创建本地数据目录与设备数据库，默认简体中文。
在手机「开发者选项」中打开 USB 调试。用数据线连接电脑，并在手机弹窗中授权当前电脑。
设备墙会自动发现设备并分配编号。首次投屏服务启动约需 1–2 秒，首帧常见 0.7–1.5 秒。
单击卡片操作手机，双击打开大屏；勾选多台后可同步群控、批量分发或录制回放。
打开「连接设备」，扫描局域网或输入 IP；Android 11 及以上可使用配对码或二维码配对。
按环节查找
先确认软件版本、手机型号、系统版本与连接方式，再到对应分组里找答案。
连接
手机一直显示离线怎么办？
依次检查：USB 调试是否开启、手机是否授权当前电脑、数据线是否支持数据传输、无线设备是否与电脑同网段。可以点击设备卡片上的“修复连接”，或重启 ADB 后重试。
无线调试的配对码怎么用？
Android 11 及以上：在手机「无线调试」中选择“使用配对码配对设备”，在软件里输入手机显示的 IP、端口与六位配对码。配对成功后，再用无线调试页显示的 IP 与端口连接。
插回 USB 后为什么没有切回有线？
这是有意设计：USB 与无线会话同时存在时，插回数据线不会立刻夺回连接，而是保留无线会话与最后一帧，避免画面闪断。需要切换时在连接方式里手动操作，切换前会校验是否为同一台硬件。
启动时很多设备同时重连，正常吗？
软件对已知无线地址采用 1.5 / 3 / 5 / 8 秒、之后固定 12 秒的分阶段退避，最多尝试 20 次，启动时会先轻量探测历史地址，避免“重连风暴”。如果长时间全部离线，先检查路由器、局域网隔离与手机无线调试状态。
投屏与画面
投屏黑屏或只有锁屏画面？
先确认手机已解锁；投屏显示锁屏画面不代表已解锁。软件可以尝试唤醒屏幕。首次连接服务端启动约需 1–2 秒，如仍黑屏，断开该设备会话后重新连接，避免半开连接。
旋转手机后画面错位？
手机旋转时会话信息会再次出现在流中，软件会识别并更新画面尺寸。如仍错位，请断开并重连该设备，并记录手机型号与系统版本反馈。
设备多时 CPU 占用高？
降低整体画质预设，只对大屏中的设备保持高画质；开启按可见性自动调整质量。软件在 CPU 持续超过 70% 时会自动降档，低于 60% 后带防抖回升。50 台以上建议无线 ADB + 千兆网络。
独立副屏打不开？
独立副屏需要 Android 10 及以上。显示密度等参数修改后需要重启副屏生效。若手机系统限制了多显示能力，副屏可能无法创建。
批量与自动操作
回放时点不到原来的位置？
自动操作基于位置与时间录制，界面布局变化后位置会失效。请重新录制该步骤；输入类步骤可以启用按界面文字定位的脚本增强。首次执行建议先在 1 台设备上验证。
电脑端回放能输入文字吗？
当前电脑端回放不支持文字输入；文字输入在导出的脚本中生效。需要批量填写文字时，可使用“文字分发”，有输入焦点时直接填入，否则写入手机剪贴板。
批量任务为什么暂停了？
运行中遇到断连、锁屏、方向变化或人工接管时，整批任务会按策略暂停，避免每台设备各自空跑。处理设备状态后可在任务中心继续；无法确认结果的步骤不会自动重试。
文件传输失败，会留下残缺文件吗？
不会。传输过程中手机上出现的是随机命名的临时文件，只有大小核验一致后才改名为最终文件名。失败项可以单独重试，不必重传已完成部分。
AI 与语音
AI 功能提示未配置怎么办？
打开「AI 配置 → 添加 AI 配置」，选择服务商，地址与常用模型大多已预置；粘贴自己的 API Key，点“测试连接并保存”。启用的那套配置就是 AI 助手、总控规划器与设备执行智能体共用的大脑。
任务显示“未验证”是什么意思？
动作已经执行完毕，但最终页面没有通过验证。请查看任务截图与日志，确认目标是否真的达成。未确认的结果不会标记为“已验证”，也可以重新执行。
可以用本机模型吗？
可以。支持本机 Ollama / LM Studio 等服务，也支持 DeepSeek、通义千问、智谱 GLM、Kimi、硅基流动、火山方舟、OpenAI 等云端服务商。应用只使用你启用的那一套配置。
语音用不了，会影响其他功能吗？
不会。语音链路依赖本地运行组件（识别、合成与实时通信），组件缺失时语音入口会明确提示，投屏、群控、批量与其他 AI 文字功能仍可正常使用。
授权与更新
机器码在哪里复制？
打开「更多 → 授权」，在授权窗口点击“复制机器码”，把机器码发给发布方获取授权令牌。机器码由本机硬件信息生成，共 20 位大写字符。
断网后还能用多久？
激活并完成云端确认后，正常每 10 分钟心跳。断网时沿用上次确认，最多 7 天；超过宽限期自动回到未授权额度（最多 2 台），联网后自动恢复。
换电脑或重装系统后要重新授权吗？
需要。授权令牌与本机绑定，更换电脑或重装系统后机器码会变化，需要重新获取令牌。若要在本机取消授权，可在授权窗口点击“移除本机授权”。
更新下载失败怎么办？
检查网络与更新服务地址；下载会校验内容长度、类型与 SHA-256，任何一项不一致都会中止并删除临时文件。可稍后重试，或从官网重新下载完整安装包覆盖升级。
先看这三个地方
运行记录把“发生了什么”翻译成可读句子；性能监控给出 CPU、内存、投屏台数与每台设备帧率。
| 现象 | 先检查 | 处理 |
|---|---|---|
| 设备卡片显示离线 | USB 调试、授权弹窗、数据线、同网段 | 重新插拔 / 一键连接修复 / 重启 ADB 后重连 |
| 投屏黑屏 | 手机是否锁屏、服务端是否就绪 | 解锁并唤醒；等待 1–2 秒；断开该会话后重连 |
| 画面卡顿 | CPU 占用、网络带宽、画质预设 | 降低预设；启用可见性降档；10 台以上换千兆网络 |
| 文件传输失败 | 手机存储空间、连接状态、同名文件 | 清理空间；只重试失败项；同名会自动加编号 |
| 批量任务暂停 | 断连、锁屏、方向变化、人工接管 | 在任务中心处理设备状态后继续；不确定步骤不自动重试 |
| AI 任务不执行 | 模型配置、运行组件、任务状态 | 测试连接并保存配置；检查运行组件；查看任务中心证据 |
| 授权失效 | 离线是否超过 7 天、系统时间、是否换机 | 联网等待恢复；检查授权状态；换机需重新签发 |
业务数据留在本机，授权校验会上报设备标识
设备台账、任务记录与偏好保存在本地。为校验授权，客户端会向授权服务器上报设备指纹与本机名称类信息——字段清单逐项列在隐私政策里，不藏着。
设备编号、备注、分组、云手机订阅、任务与录制记录保存在本地数据库与任务目录。
模型服务密钥、机器码与授权令牌由 Windows 用户级 DPAPI 加密，其他 Windows 用户无法解密。
启动时与运行期间每约 10 分钟一次：机器指纹、网卡 MAC、计算机名、Windows 用户名、系统与软件版本、授权状态、在线设备数。不上报画面、输入、文件。
截图、录制与任务证据保存在本机目录，清理与容量上限由软件管理。
连接地址在界面与日志中脱敏；订阅令牌不会外发给第三方。
发布版本启动时验证关键程序文件，校验不通过会退出，降低被替换后冒名运行的风险。
授权跟着机器走
授权采用机器码 + 签名令牌。未授权最多 2 台同时投屏；授权额度与能力项以服务端确认为准。
激活步骤：打开「更多 → 授权」→ 复制机器码 → 发送给发布方获取令牌 → 粘贴令牌并点击激活 → 联网完成云端确认。
- 授权状态包括：已授权、未授权、已过期、未生效、绑定其他机器、令牌无效、已停用
- 激活后每 10 分钟心跳；断网沿用上次确认最多 7 天
- 更换电脑或重装系统后机器码变化，需要重新签发
- 可选升级可延后 24 小时；强制升级必须立即升级或退出
授权速查 LICENSE
- 未授权额度
- 2 台同时投屏
- 机器码
- 20 位大写字符
- 心跳周期
- 10 分钟
- 离线宽限
- 最多 7 天
- 令牌绑定
- 本机机器码
- 移除授权
- 授权窗口可操作