故障排查

先看「设置 → 连接」最上方那条总结。它会给出「连接正常」或「N 项需要处理」，并把需要注意的项目直接列出来，每一项都带一句处理建议。

连接状态

展开「设置 → 连接 → 连接状态」，可以看到六个检查项：

检查项	关注什么
局域网连接	本机网络接口与 QUIC 监听是否就绪
附近设备发现	mDNS/Bonjour 是否在正常工作
设备身份保护	长期设备密钥能否从系统凭据库读取
客户端版本	当前版本与协议能力
剪贴板同步	是否开启、是否处于可用状态
自建中继	是否启用、是否已连接

找不到设备

确认两台设备在同一个网络，并且都打开着 Neloa。
看设备页的提示行是「正在查找附近和中继设备」还是「设备发现暂不可用」。后者说明本机的发现服务没起来，看「连接状态」里的「附近设备发现」。
Windows 上检查防火墙是否允许 Neloa 使用专用/公用网络。
iOS 和新版 macOS 首次运行会请求「本地网络」权限；拒绝之后需要在系统设置里重新打开。能看到设备但配对超时，通常说明发现广播可见，但 UDP 48631 被本地网络权限或防火墙拦截。
Android 需要 Wi-Fi 可用；Neloa 在应用存活期间持有 mDNS 多播锁，但切换到只走蜂窝网络时局域网发现自然不会有效。点对点 Wi-Fi 还需要允许“附近的设备”（Android 13 及以上）或位置权限（Android 12 及以下）。

能看到设备，但配对超时

检查设备卡片选择的连接方式。局域网模式需要两端网络可直达；点对点 Wi-Fi 要求两端都是附近的 Android 设备；蓝牙要求两端是附近且已授权蓝牙的 macOS/iOS 设备；中继模式需要两端连接同一个中继且令牌一致。
在 iOS/macOS 的系统设置中允许 Neloa 访问本地网络；在 macOS/Windows 防火墙中允许 Neloa 接收入站连接。
局域网传输使用 UDP 48631。mDNS/Bonjour 发现成功只说明 UDP 5353 正常，并不代表传输端口也已放行。
如果局域网被访客网络或客户端隔离阻断，可以在设备卡片中选择「中继」后重新配对。

Android 点对点 Wi-Fi 不可用

当前只支持 Android 与 Android 之间的 Wi-Fi Direct；桌面端和 iOS 上该选项会保持不可用。
两端都要打开 Wi-Fi 并保持 Neloa 在前台。Android 13 及以上允许“附近的设备”，Android 12 及以下允许位置权限并打开系统定位服务。
设备卡片只有在原生 Wi-Fi Direct 发现到对端时才会启用该选项。通过中继看到在线设备，并不等于它就在附近。
系统可能显示 Wi-Fi Direct 连接确认。拒绝、设备忙碌或等待超过 45 秒都会明确失败，Neloa 不会自动改走局域网或中继。

Apple 蓝牙不可用

当前蓝牙路径支持 macOS 与 iOS。两端首次启动都要允许 Neloa 使用蓝牙；拒绝后需要在系统设置的隐私与安全性中重新打开。
设备页只有在 BLE 身份读取成功后才启用「蓝牙」。发现会轮询附近的 Neloa 设备，刚启动时可能需要等待一个扫描周期。
选择蓝牙后会严格使用 BLE，不会自动改走局域网或中继。搜索或连接超过 45 秒会结束并显示错误。
BLE 适合测试文本、剪贴板和较小文件，吞吐量明显低于局域网 QUIC；大文件优先选择局域网、点对点 Wi-Fi 或中继。

设备显示「版本不兼容」

两台设备的协议范围没有交集，或对方缺少本次操作需要的能力。升级对方的 Neloa 即可。旧版本会被当作协议 0 处理，并收到明确的提示，而不是进入配对或传输流程。

传输失败或卡住

在传输面板里取消后重新发送。
发送失败的记录可以在记录页点「重试」。
大文件失败时先确认两端都没有进入休眠，并且网络没有在传输中途切换。
如果对方一直停在"等待对方接受"，说明接收端还没有确认那个文件——接收端不会自动保存。

中继连不上

确认地址以 wss:// 开头，且末尾是 /v1/ws。
确认两端的令牌完全一致。
确认反向代理把 HTTPS 正确转发到 127.0.0.1:8787，证书有效。
看「连接状态 → 自建中继」；即使中继失败，局域网直连仍然可用。

剪贴板没有同步

确认开关是打开的，并且开关下方的最近事件有记录。
超过 8 KB 或命中敏感内容标记的文本按设计不会发送。
移动端只在应用处于前台时同步。
刚开启时已存在于剪贴板里的内容不会被发送，只有之后新复制的内容才会。