RoomSound是一个面向智能家居场景的音频控制技能，赋予AI代理通过命令行工具管理家庭音响系统的能力。该技能的核心功能涵盖三大模块：设备发现与管理、音频源播放控制、以及音箱切换调度。
核心用法：RoomSound采用模块化命令架构，依赖yt-dlp（YouTube音频提取）、mpv（轻量级播放器）、bluetoothctl（蓝牙管理）及PipeWire/PulseAudio音频服务。首次运行时会自动检测依赖并完成配置，包括设置yt-dlp的Node.js运行时环境。用户可通过自然语言指令实现播放YouTube内容（支持URL直播或搜索播放）、切换蓝牙音箱、查看设备状态等操作。系统支持智能队列构建——根据上下文自动生成90分钟时长的播放列表，也可执行用户指定的精确曲目顺序。
显著优点：
- 协议兼容性强：同时支持经典蓝牙音频与新一代PipeWire音频架构，覆盖主流Linux发行版
- 防注入安全设计：强制实施MAC地址格式验证（
^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$）及shell元字符过滤，阻断命令注入攻击 - 优雅的别名系统：允许用户为音箱配置友好名称（如"kitchen"→具体MAC地址），降低交互复杂度
- 队列优先架构：区分" contextual queue"与明确列表请求，平衡智能推荐与用户自主权
潜在局限：
- Linux生态绑定：依赖
apt包管理器及特定二进制工具，macOS/Windows需额外适配层 - 蓝牙栈脆弱性：
bluetoothctl交互式命令在部分BlueZ版本中存在状态同步延迟问题 - YouTube政策风险：
yt-dlp作为第三方工具，存在因平台服务条款变更导致功能失效的可能 - 无内置加密：蓝牙配对密钥管理完全委托给操作系统，技能层不处理链路加密
适合人群：技术型智能家居用户、Linux桌面环境使用者、希望语音控制家庭音响的开发者与极客群体。需具备基础的命令行操作知识以应对依赖故障。
常规风险：蓝牙设备连接状态竞争（多主机场景）、音频服务抢占冲突（PipeWire/PulseAudio混用）、以及长期运行mpv进程的内存占用累积。建议在关键操作前执行设备状态确认命令。