本地零配控播放，API 跨平台搜曲库

通过 AppleScript 或 MusicKit API 控制 Apple Music 播放、管理曲库与歌单，macOS 零配置即用，跨平台需开发者账号。

基本信息

• 技能名称?Apple Music
• 中文名称?本地零配控播放，API 跨平台搜曲库
• 作者?epheterson
• 分类?专业技能
• 版本?1.0.6
• 标签?music, apple-music, applescript, musickit, media-control, playlist-management, macos, streaming-api

使用方法

使用说明
核心用法
Apple Music 集成技能提供两条技术路径： AppleScript（macOS 原生） 与 MusicKit API（跨平台） ，分别适用于不同场景。
AppleScript 方案 无需任何配置，直接在 macOS 终端通过 osascript 调用系统 Music 应用，支持完整的播放控制（播放/暂停/跳过/音量）、曲库查询、歌单管理及 AirPlay 设备切换。典型命令如 tell application "Music" to playpause 即可实现播放切换。该方案可读写曲目元数据（评分、喜爱状态、流派年份等），并支持复杂曲库查询（按艺术家、专辑、年份、播放次数筛选）。
MusicKit API 方案 需 Apple Developer 账号（$99/年），通过 JWT 开发者令牌与用户音乐令牌访问。优势在于跨平台与目录搜索能力，可检索 Apple Music 全球曲库、获取推荐与播放历史。但存在关键限制： API 无法控制播放 （无播放/暂停/跳过接口），且 只能修改通过 API 创建的歌单 。
关键约束：Library-First 工作流
无论采用何种方案， 目录歌曲（Catalog ID）无法直接加入歌单 。必须先添加至用户曲库获取 Library ID，方可入 playlist。此限制源于 Apple 的权限设计——歌单系统仅识别曲库内曲目标识。MusicKit API 用户需执行「搜索目录→加入曲库→转换 ID→添加至歌单」四步流程。
显著优点
零门槛本地控制 ：AppleScript 无需注册、令牌或网络请求，macOS 用户开箱即用
完整播放控制 ：AppleScript 独占播放、暂停、切歌、进度拖拽、音量调节、随机/重复模式切换
深度曲库管理 ：支持元数据编辑（评分、喜爱、流派）、智能筛选查询、批量歌单操作
AirPlay 原生支持 ：可直接枚举并切换至 HomePod、Apple TV 等播放设备
跨平台目录能力 ：MusicKit API 提供全球曲库搜索、个性化推荐、播放历史分析
潜在缺点与局限性
平台割裂 ：AppleScript 仅限 macOS；MusicKit API 虽跨平台但缺失核心播放控制
歌单编辑受限 ：API 仅能修改其自身创建的歌单，用户手动创建的歌单无法通过 API 编辑
令牌维护成本 ：MusicKit 开发者令牌 180 天强制过期，需自动化续期机制
曲库准入门槛 ：非订阅用户无法完整使用 MusicKit 功能；曲库为空时需先「收藏」才能建歌单
字符串转义风险 ：AppleScript 动态构建时引号与反斜杠需严格转义，否则导致执行失败
无 Windows/Linux 原生方案 ：非 macOS 用户仅能依赖受限的 MusicKit API
适合人群
macOS 重度用户 ：追求本地音乐工作流自动化，需快速控制播放与整理曲库
Apple Music 订阅者 ：已建立曲库，需批量管理歌单、导出播放数据或同步评分
开发者/极客 ：愿投入 Apple Developer 账号，构建跨平台音乐数据分析工具（如年度听歌报告）
智能家居整合者 ：需通过脚本将 Apple Music 接入 Home Assistant 等自动化系统（macOS 网关）
常规风险
账号封禁风险 ：频繁 API 调用可能触发 Apple 速率限制；滥用自动化工具违反服务条款
数据丢失 ：AppleScript 直接操作歌单删除不可逆；批量修改元数据前建议备份
隐私泄露 ：MusicKit 用户令牌包含个人曲库信息，泄露可导致听歌历史、收藏偏好外泄
订阅绑定 ：曲库内容随订阅失效而不可访问，本地「下载」非 DRM 解除，仅缓存加密文件