用途 该技能用于控制 Apple Music，覆盖搜索、资料库管理、播放列表管理、播放控制和 AirPlay 操作。实现方式基于 MusicKit API 与 AppleScript。技能目录路径为 ~/.clawdbot/skills/apple-music/。
主要能力 本地功能（无需配置）：
- 播放控制：./apple-music.sh player [now|play|pause|toggle|next|prev|shuffle|repeat|volume N|song "name"]
- AirPlay：./apple-music.sh 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>]
使用方式 API 功能需要 Apple 开发者账号（$99/年）+ MusicKit key。
配置步骤：
- 先在开发者门户操作：developer.apple.com → Keys → Create MusicKit key → 下载 .p8；记录 Key ID 和 Team ID。
- 然后运行配置脚本：./launch-setup.sh # Opens Terminal for interactive setup
启动器会打开 Terminal.app 并在其中运行配置脚本。依次输入 .p8 路径、Key ID、Team ID，然后在浏览器中授权并粘贴 token。
注意：Agent 应始终使用 ./launch-setup.sh 打开 Terminal，不要通过聊天运行 setup.sh（需要交互式输入）。
配置与错误处理 配置文件 config.json 存储 token（有效期约 6 个月）。如果认证失败，重新运行 ./setup.sh。 常见错误：
- 401：Token 过期，重新运行配置。
- 403：检查 Apple Music 订阅。
- 404：ID 无效或受地区限制。 配置问题：
- 授权页面返回 404：配置脚本会通过 HTTP 服务器验证自动修复。
- 浏览器中没有 token：重启 setup.sh。
- 浏览器无法打开：手动打开打印出的 URL（推荐 Chrome）。
适用场景与限制 适用于通过命令行控制 Apple Music 播放、AirPlay 输出以及资料库与播放列表管理的场景。本地播放与 AirPlay 功能无需配置；搜索、资料库添加与播放列表操作依赖 MusicKit API，需要 Apple 开发者账号与 MusicKit 密钥。其他平台支持情况、具体收费细节（除开发者账号年费外）暂未提供。