核心用法
clawtunes 是一款专为 macOS 设计的 Apple Music 命令行控制器，底层通过 AppleScript 与 Apple Music 应用通信。核心功能覆盖：
- 播放控制：播放指定歌曲/专辑/播放列表（支持模糊匹配与自动选择）
- 状态管理：暂停、恢复、切歌、查看当前播放状态
- 音量调节：精确设置、步进调节、静音切换
- 搜索浏览：本地库搜索、Apple Music 流媒体目录浏览
- 播放列表：创建、列出、增删歌曲
- AirPlay 输出：设备发现与切换
- 交互增强：支持爱心标记、随机播放与重复模式设置
关键使用模式：所有非交互式场景需添加 -N 或 --non-interactive 标志；匹配冲突时可通过 -1 或 --first 自动选择首项。
显著优点
- 效率提升：无需离开终端即可完成全套音乐控制，契合开发者/键盘重度用户工作流
- 精确匹配：支持多级匹配策略（精确名称 → 自动选择首项），减少交互打断
- 系统级集成：原生调用 AppleScript，权限请求清晰可追踪（System Settings > Privacy & Security > Automation）
- 生态闭环：涵盖从本地库到流媒体目录、从耳机到 AirPlay 设备的完整链路
潜在缺点与局限性
- 平台锁定：仅支持 macOS，Windows/Linux 用户无法使用
- 目录限制：流媒体目录仅支持浏览，添加至播放列表需先手动入库（依赖 Apple Music GUI 操作）
- 匹配不确定性：模糊搜索可能返回多结果，需人工干预或接受首项自动选择
- 依赖外部运行时：需安装 Homebrew 及 Apple Music 应用，初次配置门槛存在
适合人群
- macOS 终端重度用户、开发者、键盘流效率追求者
- 需在工作代码与音乐控制间无缝切换的工程师
- 偏好脚本化/自动化音乐场景的高级用户
常规风险
- 自动化权限：首次运行可能触发系统权限请求，需在系统设置中手动授权
- 匹配误操作：
--first自动选择策略可能在库中存在同名歌曲时播放非预期曲目 - 状态同步延迟：AppleScript 调用存在微小延迟，快速连续指令可能产生状态不一致
- 目录操作边界：流媒体内容无法直接操作，需明确区分"浏览"与"管理"权限边界