clawtunes

核心用法

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 调用存在微小延迟，快速连续指令可能产生状态不一致
• 目录操作边界：流媒体内容无法直接操作，需明确区分"浏览"与"管理"权限边界

核心用法

managing-apple-music 是一个纯文档型 Skill，本身不含可执行代码，通过调用外部 clawtunes CLI 工具实现对 Apple Music 的终端控制。核心能力包括：

音乐播放：支持按歌曲名、专辑名、播放列表名精准播放，配合 --non-interactive (-N) 标志避免交互式提示，或使用 --first (-1) 自动选择首个匹配结果。

播放控制：暂停、恢复、切歌、查看当前播放状态等基础操作；音量调节支持绝对值设置、相对增减及静音切换。

播放模式：独立控制随机播放（shuffle）和循环模式（repeat off/all/one）。

搜索与库管理：本地库搜索（可限定仅歌曲、包含播放列表）、Apple Music 在线目录浏览；支持歌单创建、歌曲增删及喜欢/不喜欢标记。

AirPlay 设备管理：列出、选择、断开 AirPlay 输出设备。

显著优点

• 零代码风险：纯 Markdown 文档 + JSON 元数据，无可执行脚本，无潜在漏洞面。
• 功能覆盖完整：从基础播放到高级库管理、AirPlay 控制，几乎涵盖 Apple Music 全部常用操作。
• 终端工作流友好：适合习惯命令行的开发者，无需离开终端即可控制音乐。
• 安装便捷：通过 Homebrew 一键安装依赖 clawtunes。
• 权限透明：仅需系统 Automation 权限与 clawtunes 执行权限，无过度索权。

潜在缺点与局限性

• 平台锁定：macOS 专属，依赖 Apple Music 应用，Windows/Linux 用户无法使用。
• 外部依赖风险：功能完全依赖第三方 CLI clawtunes，其维护状态、安全性、版本兼容性不在本 Skill 控制范围内。
• 目录搜索只读：在线目录搜索仅支持浏览，若要添加歌曲到播放列表，需先通过 Apple Music 官方应用将曲目加入资料库。
• 输入处理受限：用户输入直接传递给外部 CLI，若 clawtunes 未妥善处理特殊字符，存在潜在命令注入风险（取决于 CLI 实现）。
• 匹配模糊性：名称匹配可能返回多个结果，需用户手动细化或使用 --first 强制选择，体验不如原生应用直观。

适合人群

• 常驻终端、追求效率的 macOS 开发者与高级用户
• 希望通过脚本自动化音乐播放的工作流用户
• 需要快速控制 AirPlay 输出设备的用户

常规风险

• 依赖过时风险：clawtunes 为个人开发者项目（GitHub 3 stars），长期维护能力存疑。
• macOS 版本兼容性：Apple Music 应用或 macOS 系统更新可能导致 AppleScript 接口变更，影响功能稳定性。
• 权限弹窗：首次使用可能触发 Automation 权限请求，需在系统设置中手动授权。