连接与故障排查
Violoop 通过 USB 数据线连接到你的电脑——这条物理连线就是全部的连接。本页说明各种连接状态的含义、重连是如何工作的，以及设备未被识别时该怎么办。
一切都走 USB。 设备与这台电脑之间的连接是 USB 数据线，而不是 Wi-Fi 或你的网络。（Wi-Fi 只是给设备本身提供访问云端 AI 的互联网——它不是设备与电脑通信的方式。）所以一旦连接出问题，几乎总是该先查数据线。
建立连接
- 用数据线把 Violoop 设备插入电脑的 USB 口。
- 设备开机，应用会在几秒内识别到它。
- 首次设置时，应用会引导你登录，并在需要时帮设备连上 Wi-Fi，以便它访问云端。
连接成功后，应用会显示已连接状态，你就可以开始使用了。
读懂连接状态
应用会在状态药丸中显示当前状态；当需要你操作时，还会显示一条横幅：
| 状态 | 含义 |
|---|---|
| 已连接 | 设备已连上，随时可用。 |
| 正在重连 | 连接短暂中断，Violoop 正在恢复。你的会话会被保留——通常稍等片刻就会自行恢复。 |
| 请连接设备 | 设备无法访问。请检查数据线；也可以点击重连。 |
| 需授权（仅 Linux） | 你的用户账户缺少使用 USB 串口的权限。点击修复权限即可授权。 |
无感重连
短暂的中断很正常——碰到了数据线、USB 集线器重新调度，或设备更新后重启。Violoop 会从容应对：
- 连接一断开，状态就转为正在重连，但你的工作不会被丢弃。
- 如果连接在约 10 秒内恢复，一切会从原处继续——你只会看到横幅一闪而过。
- Violoop 会自行持续侦测设备，所以只要把数据线重新插好就能重连——通常一两秒内完成，不需要按任何按钮。
如果设备离线超过这段宽限时间，应用会带你回到会话列表并等待；一旦重新识别到设备，它会自动重连。
找不到设备时
若没有已连接的设备，应用会显示一个全屏的设置引导页。如果它提示**「未检测到设备」**，请依次检查：
- USB 数据线两端都插牢了——设备一端和电脑一端。
- 设备的电源指示灯亮着。
- 你用的是数据线，而不是只能充电的线。 这是最常见的原因：有些 USB 线只供电、不传数据，设备无法通过这种线被识别。若不确定，换一根确认可用的数据线。
然后点击重新搜索。重新插好数据线就足以重连——手动重试按钮只是省去那段短暂的等待。
设置设备 Wi-Fi
设备需要自己的互联网连接来使用云端 AI。如果它还没联网，应用会提示你设置设备 Wi-Fi：它会扫描网络，你选中自己的并输入密码，设备联网后应用便自动继续。（这项配置也走同一条 USB 连线。）
保持固件为最新
Violoop 需要足够新的设备固件才能运行。如果你的设备版本偏旧，应用会停在**「需要更新固件」**的页面：
- 在较新的固件上，点一下立即更新，设备就会通过互联网自行更新。请保持它通电并联网——更新过程中它会重启，完成后页面会自动继续（这可能需要几分钟；期间短暂断开是正常预期）。
- 在过旧的固件上，应用会改为请你从设备自身的屏幕上启动更新；更新完成后它会自动继续。
对于已经是最新版的设备，更新版本会作为设置 → 版本与更新里一个可忽略的可选提示出现。
快速故障排查
完全检测不到设备。 逐条排查上面三点——数据线两端都插牢、电源指示灯亮、以及用的是真正的数据线。换一个 USB 口试试。然后点击重新搜索。
它反复跳到「正在重连」。 通常是数据线松动或质量勉强，或 USB 集线器不稳定。重新插好数据线，直接插到电脑上而不经过集线器，并换一个 USB 口。
Linux 上提示「需授权」。 你的账户不在允许使用串口的用户组里。在应用中点击修复权限——单靠重新插拔无法解决。修复会在下次重连时生效。
提示我的固件太旧。 按更新页面操作——有立即更新就点它，否则在设备本机上启动更新。请保持设备通电并联网。