如何反馈问题

遇到问题时，按下面的模板提供信息，能让我们一次定位，不用来回追问。

反馈模板（复制填写）

【设备类型】真机 / 云机（二选一，必填）
【如果是真机】USB 调试已开启？（是/否）　已经用 USB 线成功连过？（是/否）
【客户端版本】见左侧栏品牌区旁的版本号，如 v0.1.0
【电脑系统】如 Windows 11 / macOS 15
【手机型号与系统】如 Redmi Note 12, Android 13（云机写平台与镜像版本）
【问题描述】做了什么操作 → 期望看到什么 → 实际看到什么
【截图或录屏】问题界面的截图，能录屏更好

为什么一定要说明真机还是云机？

两者的连接原理不同，排查方向完全不一样：

• 真机问题九成出在：USB 调试没开、授权没点、没做 WiFi「点火」、数据线不支持传输；
• 云机问题九成出在：IP 不对、网络不通、平台没开 adb 端口。

先说清楚类型，我们就能直接给出针对性的解决步骤。

截图应该截哪里？

• 连不上设备：截左侧栏、连接设备入口、错误提示；
• 画面异常：截设备墙里那张设备卡片；
• 控制异常：截单设备控制大窗，尤其是右侧状态和控制按钮；
• 批量操作异常：截顶部工具条和已选设备数量。

常用自查命令

反馈前可以在电脑终端跑一下，把结果一并发给我们：

adb version   # adb 是否安装
adb devices   # 能不能看到你的设备、状态是 device 还是 unauthorized
ping 设备IP    # 网络通不通（局域网连接时）

反馈渠道

• 找到给你提供软件的客服/对接人，把上面模板填好发过去；
• 开源社区用户可在 GitHub 仓库 提 Issue（英文中文均可）。

即将上线

后续版本会在「设置」里提供一键导出日志功能，反馈时附上日志包即可，无需手动跑命令。