核心功能
sonos-announce 是一款面向 Sonos 智能音响系统的自动化控制工具，核心能力在于无损插入音频公告——它能够在播放任意音频文件后，完整恢复播放前的原始状态，包括精确续播位置、播放列表进度、甚至外部输入源（Line-In/TV/蓝牙）的重新连接。
显著优点
1. 智能状态保存与恢复：不仅记录播放/暂停状态，还能精确到秒级 seek 位置恢复 Spotify 等流媒体内容，对网络电台等不可 seek 内容自动降级处理
2. 外部输入自动识别：内置检测 Line-In、HDMI、蓝牙等不可暂停的外部音源，自动跳过而非强制中断，避免硬件冲突
3. 零配置 HTTP 服务：自动启动临时 HTTP 服务器推送音频流，支持跨平台（macOS/Linux/Windows），IP 和端口可环境变量覆盖
4. 群组合播支持：自动发现并协调多个扬声器分组（coordinators），确保整组同步播放与恢复
5. 模块化设计：专注「播放」单一职责，与 TTS 生成、音频合成等上游流程解耦，易于集成
潜在局限与风险
- 网络依赖性：依赖 Sonos 的 UPnP 发现机制，跨网段或复杂 VLAN 环境可能失效
- HTTP 服务临时性：端口 8888 冲突时需手动指定，多实例并行可能竞争端口
- 部分服务限制：Spotify Radio、TuneIn 等不支持 seek，恢复后从开头重播，用户体验有损
- Python 运行时依赖：需维护
soco库版本兼容性，Sonos 固件更新可能破坏 API 行为 - 无认证机制：HTTP 服务无访问控制，局域网内任意设备可访问音频端点（敏感场景建议网络层隔离）
适合人群
- 智能家居自动化开发者（Home Assistant、Node-RED、OpenClaw 等框架集成）
- 需要家庭广播/通知系统的多住户场景
- 声音板（soundboard）爱好者，追求「音效插入不中断音乐」体验
- Sonos 生态深度用户，希望程序化控制音响系统
常规风险评估
| 风险类别 | 等级 | 说明 |
|---------|------|------|
| 数据隐私 | 低 | 不采集用户数据，仅本地网络通信 |
| 设备安全 | 中 | HTTP 服务无认证，建议防火墙限制 |
| 可用性 | 中 | 依赖第三方库 `soco` 和 Sonos 官方 API 稳定性 |
| 误操作恢复 | 低 | 状态恢复机制成熟，异常时 speakers 回到可操作状态 |