故障排查

找不到 USB 设备

解锁 iPhone 或 iPad，重新连接数据线，接受“信任此电脑”，并确认设备出现在 Finder 中。仅支持充电的数据线无法传输 MiniBridge 数据。

画面黑屏或停止

打开“系统设置 → 隐私与安全性 → 屏幕录制”并启用 MiniBridge。更改权限后退出并重新打开 Mac 配套软件。

鼠标或键盘无响应

在“系统设置 → 隐私与安全性 → 辅助功能”中启用 MiniBridge，然后重新连接。

找不到 Wi-Fi 设备

两台设备都要允许本地网络访问、连接同一本地网络并保持 MiniBridge 打开。Wi-Fi 首次连接需要完成安全配对。

Mac 无法通过 iPhone 上网

确认个人热点已开启、运营商套餐支持共享网络、iPhone 有蜂窝信号，并且 macOS 能看到 iPhone USB 网络服务。MiniBridge 不会自动修改路由。

Mac 没有使用 iPhone 网络

打开 MiniBridge 的一根线诊断，对比 iPhone USB 接口与默认路由。可打开网络设置检查服务状态；MiniBridge 只报告不一致，不会更改服务顺序或路由。

虚拟显示器不可用

MiniBridge 将 macOS 私有虚拟显示适配器隔离封装，并在运行时检查兼容性。如果不可用，请连接临时显示器或兼容的 HDMI 显示适配器。MiniBridge 可以镜像该显示器，但无法通过公开 macOS API 凭空创建无屏桌面。

无法看到 FileVault 界面

这是 macOS 的安全边界。请连接物理显示器和键盘完成启动前解锁，用户登录后 MiniBridge 才能启动。