用途：在本地网络中用 sonos 命令控制 Sonos 音箱。
主要能力与用法： 发现设备：sonos discover 查询状态：sonos status --name "Kitchen" 播放控制：sonos play|pause|stop --name "Kitchen" 音量设置：sonos volume set 15 --name "Kitchen" 分组：sonos group status|join|unjoin|party|solo 收藏：sonos favorites list|open 队列：sonos queue list|play|clear Spotify 搜索（通过 SMAPI）：sonos smapi search --service "Spotify" --category tracks "query"
限制与说明：SSDP 失败时可指定 --ip <speaker-ip>。Spotify Web API 搜索为可选功能，需配置 SPOTIFY_CLIENT_ID/SECRET。
排障要点： 若出现 no route to host，提示在 Mac 直连（非 Docker 沙箱）模式下，需为 Gateway 的顶层宿主父进程开启“设置 -> 隐私与安全性 -> 本地网络”，例如通过 launchd 运行的 node、直接在终端运行的 Terminal，或在 VS Code 终端中运行的 Visual Studio Code；也可改用允许网络访问的 Docker 沙箱。 若出现 bind: operation not permitted，提示可能运行在不允许网络访问的 Codex 等沙箱中。
适用场景：需要以命令行方式管理局域网 Sonos 音箱播放、音量与分组。
未提供：安装命令、系统兼容范围、收费情况等资料暂未提供。