sonoscli

Sonos CLI 技能让您能通过简洁的命令行界面，顺畅地控制局域网内的 Sonos 音频系统。此工具专为高级用户与开发者设计，无需使用原生 Sonos 应用程序即可执行常见的音频管理工作。它通过 SSDP 协议进行网络探索，并与扬声器节点直接通讯，提供对单一设备或同步扬声器组的细致控制。无论您是想自动化执行早晨播放列表、为派对同步房间音乐，或是进行快速状态检查，此技能都提供了将音频控制整合至自动化工作流或个人 AI 助理所需的基础功能。

• 完整的播放控制功能，包含对特定房间或区域执行播放、暂停与停止指令。

• 智慧型扬声器组功能，支持加入、退出、派对模式与独立模式设置。

• 进阶播放列表管理，可直接从命令行列出、播放或清除曲目。

• 内置我的最爱管理功能，可快速存取并播放您保存的 Sonos 预设内容。

• 通过 SMAPI 整合 Spotify，可对曲目与类别进行进阶搜索。

• 状态监控功能，提供即时的当前曲目元数据与扬声器音量等级检视。

• 灵活的音量控制，允许对特定扬声器或组进行精确调整。

• 本工具使用 SSDP 进行网络探索；请确保您的局域网允许 UDP 流量通过标准 SSDP 端口。

• 若探索失败，可使用 --ip 标志手动指定扬声器的 IP 地址，以避开网络路由问题。

• 在 Docker 或特定 IDE 终端等沙盒环境中执行时，请确保网络栈已设置为允许访问局域网，以避免权限错误。

• 支持选用的 Spotify Web API 整合；请提供 SPOTIFY_CLIENT_ID 与 SPOTIFY_CLIENT_SECRET 以启用进阶 SMAPI 搜索功能。

• 针对常见的网络问题（如“找不到主机路由”或绑定权限错误）提供疑难解答指南，特别适用于需管理局域网隐私设置的 macOS 用户。