核心用法
clawtunes 是 macOS 平台专用的 Apple Music 命令行控制工具，基于 AppleScript 与系统音乐应用通信。核心能力覆盖：
音乐播放：精准定位歌曲/专辑/播放列表，支持模糊匹配与交互式选择菜单；播放控制：暂停、恢复、切歌、状态查看；音量管理：绝对值设定、相对调节、静音切换；播放模式：随机播放与三种重复模式切换；内容发现：多维度搜索（歌曲/专辑/播放列表）并可限制结果数量；社交标记：快速标记喜爱/不喜；设备投送：AirPlay 设备发现、连接与断开。
显著优点
- 零界面操作：终端直接控制，无需切换至音乐应用窗口，适合开发者/键盘流用户
- 语义化搜索：支持自然语言查询，多结果时提供编号菜单避免误操作
- 双渠道安装：Homebrew 与 pip 双轨支持，覆盖主流 macOS 包管理习惯
- 权限模型清晰：仅依赖系统级 Automation 权限，无网络传输或云端依赖
潜在局限
- 平台锁死：macOS 独占，Windows/Linux 用户无法使用
- 前置依赖：必须安装 Apple Music 应用且保持运行，本质为自动化脚本而非独立播放器
- 权限摩擦：首次使用需手动授权 Automation 权限，企业托管设备可能受策略限制
- 功能边界：无法播放本地非 Apple Music 曲库文件，受 DRM 内容限制
适合人群
macOS 重度终端用户、Apple Music 订阅者、追求键盘工作流的开发者、Homebrew 生态用户。
常规风险
权限申请属于正常系统行为，但需注意：工具通过 AppleScript 控制应用，理论上可执行任意脚本指令；建议仅从官方仓库（forketyfork/tap 或 PyPI）安装，避免第三方篡改包。