核心用法
roon-controller 是专为Roon音乐生态系统设计的Python控制接口，将复杂的Roon API封装为简洁的本地化操作。用户只需安装roonapi依赖，即可通过RoonController类实现：自动发现局域网内的Roon Core并持久化认证令牌（存储于~/clawd/roon_token.txt）；智能识别名称含"muspi"后缀的播放区域；支持播放/暂停、切歌、曲目查询等基础控制；同时提供命令行工具与中文触发词双重交互方式。
显著优点：
- 零配置即用：首次运行自动完成Core发现与授权，令牌持久化存储免重复认证
- 区域智能管理：自动筛选Muspi区域，支持运行时切换并记忆选择
- 双语交互友好：内置"播放音乐""下一曲"等中文指令映射，降低使用门槛
- 响应标准化：所有操作返回统一字典结构，便于集成与错误处理
潜在局限：
- 生态封闭性：仅支持Roon生态系统，无法兼容Spotify Connect、AirPlay等其他协议
- 区域命名依赖：强制要求目标区域以"muspi"结尾，灵活性受限
- 网络环境敏感：需与Roon Core同局域网运行，跨网段或VPN场景可能失效
- 令牌安全风险：明文存储认证令牌于用户目录，多用户共享设备存在泄露隐患
适合人群：Roon订阅用户、Hi-Fi音响爱好者、智能家居集成开发者，尤其是追求无损音质且已部署Roon Core的进阶音频用户。
常规风险：网络中断导致控制失效；令牌文件权限配置不当引发未授权访问；区域名称变更后需手动重新匹配；依赖roonapi库的维护状态。