用途：sonoscli 是面向本地网络的 Sonos 音箱控制命令行工具，采用 Go 编写，通过 UPnP/SOAP 与音箱通信，适合终端用户或智能体自动化操作 Sonos。
主要能力：发现音箱与查看状态（discover、status、now）；播放控制（play、pause、stop、next、prev）；音量与静音（volume get/set、mute toggle）；分组管理（group status/join/unjoin/solo/party/dissolve）；队列管理（queue list/play/remove/clear）；收藏（favorites list/open）；Spotify 支持（open、enqueue、SMAPI 搜索、Web API 搜索）；场景保存与应用（scene save/apply/list/delete）；播放任意 URI、TV 输入与 linein；实时事件监听（watch）。输出支持 plain、json、tsv，并提供 --debug 追踪日志。
使用方式：安装可选 brew install steipete/tap/sonoscli，或从源码 go install github.com/steipete/sonoscli/cmd/sonos@latest。运行机器须与 Sonos 音箱处于同一网络，且音箱 TCP 1400 端口可达；Spotify 功能需在 Sonos 应用中关联 Spotify，使用 Spotify Web API 搜索需提供 SPOTIFY_CLIENT_ID/SECRET。命令通过 --name 指定房间，支持模糊子串匹配（如 --name "Kit" 可匹配 "Kitchen"）。可用 sonos config set 设置默认房间与输出格式。
适用场景与限制：适合本地网络内批量或脚本化控制 Sonos，包括分组派对、队列、收藏、场景与 Spotify 播放。限制为必须同网段且 1400 端口可达，Spotify 相关能力依赖 Sonos 端关联或额外凭据；其他细节暂未提供。