用途:在 macOS 上控制 Apple Music,包括搜索、资料库管理、播放列表操作、播放控制与 AirPlay 切换。
主要能力:本地模式无需配置,支持播放控制(now、play、pause、toggle、next、prev、shuffle、repeat、volume N、song "name")与 AirPlay 管理(list、select N、add N、remove N)。API 模式需配置,支持搜索(search "query" [--type songs|albums|artists] [--limit N])、添加歌曲到资料库(library add <song-id>)以及播放列表操作(playlists [list|create "Name"|add <playlist-id> <song-id>])。
使用方式:技能路径为 ~/.thinkfleetbot/skills/apple-music/。本地命令直接运行 ./apple-music.sh。API 需先创建 MusicKit 密钥:在 developer.apple.com → Keys 创建 MusicKit key 并下载 .p8,记录 Key ID 与 Team ID;然后运行 ./launch-setup.sh 打开 Terminal 进行交互式设置,输入 .p8 路径、Key ID、Team ID,在浏览器授权并粘贴 token。配置存于 config.json,token 有效期约 6 个月,认证失败可重跑 ./setup.sh。
限制:API 功能需 Apple 开发者账号($99/年)与 MusicKit 密钥。常见错误:401 表示 token 过期需重跑设置;403 需检查 Apple Music 订阅;404 表示 ID 无效或区域限制。设置问题:授权页 404 时脚本会自动用 HTTP 服务器验证修复;浏览器无 token 需重启 setup.sh;浏览器无法打开时手动打开打印的 URL(推荐 Chrome)。