Sonos Debug 用于 Peter 的 Sonos + UniFi 可靠性排查工作。
用途 该技能面向 Sonos 在 UniFi 网络环境下的可靠性问题诊断，涵盖设备发现、固件版本不一致（firmware skew）、丢包与高延迟、AP/射频/客户端位置、Mesh 上行链路等方向。
主要能力 提供若干脚本用于采集信息：
- scripts/sonos-snapshot.sh：获取 Sonos 健康快照。
- scripts/unifi-auth-tmux.sh 192.168.0.1：在需要时进行 UniFi 认证。
- scripts/unifi-sonos-snapshot.sh：获取 UniFi Wi-Fi/Sonos 快照。
使用方式与规则
- op 只能在 tmux 内运行，使用 scripts/unifi-auth-tmux.sh，不要直接调用 op。
- 不要打印密钥；只查询选定字段，并对 WLAN/密码短语数据进行脱敏。
- 优先只读操作；进行有风险的变更前先询问，Wi-Fi 宽度/漫游调整在被要求时通常可以接受。
- 完成后清理 /tmp/unifi-* cookie/文件与 tmux 会话，除非还要继续。
工作流
- 运行 scripts/sonos-snapshot.sh 查看 Sonos 健康。
- 如需要，运行 scripts/unifi-auth-tmux.sh 192.168.0.1 进行 UniFi 认证。
- 运行 scripts/unifi-sonos-snapshot.sh 获取 UniFi Wi-Fi/Sonos 快照。
- 将结果与症状对照：
- 固件版本不一致：更新 Sonos 应用。
- 丢包/高延迟：对受影响房间再次 ping。
- 客户端位置/速率不佳：检查 Sonos 相关行。
- Mesh AP：尽可能改为有线连接。
本地经验规则
- 良好基线：2.4 GHz 20 MHz、5 GHz 80 MHz，Sonos 设备较多的家庭关闭 DFS。
- 可靠性提升最明显的一步：将有线回程用于无线 Mesh AP；Office AP 曾以约 -65 dBm 进行 Mesh。
- 在 Sonos/IoT SSID 上禁用 Fast Roaming / 802.11r；保留 BSS Transition。
- LAN 上应保持 IGMP snooping 开启。
- 如果从 Mac 调试设备发现，避免同一 LAN 上同时启用有线与 Wi-Fi。
- 专用 Sonos/IoT SSID 可选方案：WPA2、仅 2.4 GHz、无快速漫游。
适用场景 适用于在 UniFi 网络中对 Sonos 进行可靠性排查与诊断，尤其是设备发现异常、固件版本不一致、丢包/延迟、客户端位置与速率问题、Mesh AP 上行链路问题等。
限制 资料未提供该技能的安装方式、依赖要求、支持平台范围、收费或价格信息，暂未提供。