核心用法
RoomSound 是面向 Linux 桌面/服务器环境的音频播放技能，赋予 AI 助手三项核心能力：
1. 扬声器管理：通过 bluetoothctl 发现、连接、切换蓝牙音箱，支持别名映射（如 kitchen → MAC 地址），并兼容 PipeWire/PulseAudio 双音频系统。
2. YouTube 音频播放：集成 yt-dlp 搜索与 mpv 无界面播放，支持直接 URL 或自然语言搜索（返回 5 条结果供选择），自动提取最佳音频流。
3. 设备发现与诊断：一键汇总蓝牙配对状态、连接状态、音频输出端点，辅助排查无声故障。
显著优点
- 零配置音频流：无需浏览器或 GUI，命令行即可播放 YouTube 音频到蓝牙音箱，适合无头服务器或极简桌面。
- 灵活的别名系统：首次运行时建立用户友好别名，后续指令如"切换到厨房音箱"即可生效。
- 双音频后端兼容：同时支持现代 PipeWire（
wpctl）与传统 PulseAudio（pactl），覆盖主流 Linux 发行版。 - 透明可审计：完全基于开源工具链（yt-dlp、mpv、bluez），无闭源依赖或网络代理。
潜在缺点与局限
- Linux 独占：依赖 systemd、bluetoothctl、apt 包管理，macOS/Windows 无法直接运行。
- 蓝牙连接不稳定：受硬件驱动、音箱固件、2.4GHz 干扰影响，可能出现断连或音质劣化。
- yt-dlp 合规风险：YouTube 服务条款限制未经授权的下载/播放，存在账号封禁或法律灰色地带。
- 无播放队列/状态持久化：当前实现为单次播放，无播放历史、无跨会话记忆，中断后需重新搜索。
- 音频同步缺失：不支持多房间同步或立体声配对（如 TWS 模式需音箱端自行处理）。
适合人群
- 自建 Home Assistant、OpenClaw 等开源智能家居框架的技术用户
- 树莓派/旧 PC 改造为家庭音频节点的极客
- 偏好命令行、注重隐私（不登录 Google/Spotify）的 Linux 桌面用户
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 版权合规 | YouTube 音频流可能触发服务条款限制 | 仅播放公开/自有内容，避免高频自动化请求 |
| 系统安全 | 需要 sudo 安装系统包、蓝牙守护进程权限 | 在隔离容器或专用 IoT 网络运行，限制 sudo 范围 |
| 隐私泄露 | yt-dlp 请求暴露 IP 至 Google 服务器 | 可选代理或 Tor 路由，避免登录个人账号 |
| 硬件依赖 | 蓝牙适配器质量差异大，驱动支持不一 | 优先选用 Linux 主线内核已支持的 CSR/Intel 芯片 |
| 服务中断 | yt-dlp 需随 YouTube 前端更新频繁升级 | 设置自动更新或监控发布页，及时跟进版本 |