通过命令行快速发现和控制本地 Sonos 音箱，支持音量调节、分组管理及 Spotify 搜索，适合智能家居自动化场景。
说明：
## 核心用法
`sonoscli` 是一款专为 Sonos 智能音箱设计的轻量级命令行控制工具，基于 Go 语言开发，可在局域网内快速发现并操控音箱设备。
**基础功能**：
– **设备发现**：`sonos discover` 自动扫描局域网内所有 Sonos 设备
– **状态查询**：`sonos status` 查看指定音箱的播放状态
– **播放控制**：`sonos play|pause|stop` 实现基本媒体控制
– **音量调节**：`sonos volume set ` 精确设置音量
**进阶特性**：
– **分组管理**：支持 `join/unjoin/party/solo` 等多音箱协同模式，一键开启全屋派对模式
– **收藏夹操作**：快速浏览并播放预设收藏内容
– **队列管理**：查看、播放或清空当前播放队列
– **Spotify 集成**：通过 SMAPI 协议搜索 Spotify 曲库（需指定服务名称）
**故障排查**：当 SSDP 自动发现失败时，可手动指定 `–ip` 参数直连音箱 IP。
## 显著优点
1. **零 GUI 依赖**：纯命令行交互，适合 SSH 远程管理或脚本自动化
2. **快速响应**：Go 编译产物性能优异，操作延迟低
3. **分组逻辑完善**：派对模式 (`party`) 和独占模式 (`solo`) 设计直观
4. **扩展性**：可选 Spotify Web API 集成，满足高级搜索需求
## 潜在局限
– **网络依赖**：完全依赖局域网 SSDP 发现，跨网段或复杂网络环境需手动指定 IP
– **Spotify 配置门槛**：Web API 搜索需额外申请 `CLIENT_ID/SECRET`，非开箱即用
– **平台限制**：仅支持 Sonos 生态，无法跨品牌控制其他音箱
– **功能深度**：相比官方 App，缺少均衡器调节、立体声对等高级设置
## 适合人群
– 智能家居自动化爱好者（配合 Home Assistant 等系统）
– 习惯终端操作的开发者和技术用户
– 需要批量管理多房间音箱的场景（如民宿、办公空间）
– 追求极简控制、拒绝臃肿官方 App 的用户
## 常规风险
– **网络暴露风险**：若将控制脚本部署在公网服务器，需确保 Sonos 设备不直接暴露
– **SSDP 可靠性**：某些路由器可能过滤 SSDP 广播，导致自动发现失败
– **Spotify 凭据管理**：Web API 密钥需安全存储，避免硬编码在共享脚本中
会员专属
