用途：面向 Apple Music 的集成指南，覆盖三种接入路径——AppleScript 直接控制本地 Music.app、UI 自动化（无 API 时访问目录）、MusicKit API（跨平台）。适用于播放列表增删改查、播放控制（播放/暂停/跳曲/音量）、播放 Apple Music URL、搜索目录或曲库、添加歌曲到曲库、读取收听历史与推荐等请求。
关键规则：曲库优先。目录歌曲不能直接加入播放列表，必须先进入用户曲库（目录 ID → 曲库 → 播放列表），因为播放列表使用曲库 ID（i.abc123）而非目录 ID。
AppleScript（macOS）：零配置，通过 osascript 调用，例如 osascript -e 'tell application "Music" to playpause'。支持播放控制、播放器状态、当前曲目属性读写、曲库查询、播放列表创建/删除/重命名/增删曲目、AirPlay 设备选择。注意 whose name contains 为字形精确匹配，不折叠弯引号或重音；建议用无引号片段匹配，或一次性批量取回名称后在内存中忽略标点与变音符号比较，避免逐条访问属性导致大量 Apple Event。
UI 自动化：0.15.0 起移除加库/加列表的 UI 路径，改走统一 Apple Music API（需 developer token 与 media-user-token，可用 applemusic-mcp login 或 login --dev）。UI 原语仅保留播放、按 URL 播放与目录搜索，依赖显示器、Music.app 可见及辅助功能权限。引擎可选 auto/native/safari/chrome/api。
限制：仅 macOS；UI 功能需显示器，无法无头运行；Music.app 必须运行；首次调用可能触发自动化权限提示。错误需按 stderr 分类（未运行、未授权、超时、语法错误等），不要仅凭 is_available() 判断。字符串输入需转义。