一键掌控全屋音乐场景

基于 AppleScript 的 macOS 全屋音乐场景控制器，整合 Spotify 与 Airfoil 实现一键切换晨间/派对/放松模式，让多房间音响管理化繁为简。

基本信息

• 技能名称?home-music
• 中文名称?一键掌控全屋音乐场景
• 作者?asteinberger
• 分类?效率
• 版本?v1.0.0
• 标签?automation, productivity, content-media, macos, smart-home

使用方法

使用说明
核心用法
Home Music 是一款专为 macOS 设计的全屋音乐场景自动化工具，通过整合 Spotify 桌面应用与 Airfoil 音频路由软件，实现"一句话控制全屋音响"的体验。用户只需输入 home-music morning 、 、 home-music party 或 home-music chill` 等简单命令，即可自动完成播放列表切换、目标扬声器选择、音量调节等一系列操作。
该技能采用 Bash 脚本 + AppleScript 的混合架构，底层通过 osascript 与 Airfoil 应用通信，控制音频源选择和扬声器连接，同时调用 spotify-applescript 技能管理 Spotify 的播放状态。预设场景包括：晨间模式（Sonos Move 单音箱、40% 音量、咖啡氛围）、派对模式（全屋所有音箱、70% 音量、摇滚歌单）、放松模式（单音箱、30% 音量、 lounge 音乐）以及静音模式。
显著优点

1. 极致简化操作 ：将原本需要 10+ 次点击的多步骤操作压缩为单一命令，大幅降低全屋音乐系统的使用门槛。
2. 场景化设计 ：预设模式覆盖常见生活场景，用户无需记忆复杂的设备名称和音量参数。
3. 高度可定制 ：支持修改播放列表 URI、添加自定义场景（如健身、晚餐）、配置任意 AirPlay 音箱，满足个性化需求。
4. 文档完善 ：从安装配置到故障排查，SKILL.md 提供了详尽的指导，包括直接可用的 AppleScript 代码片段供高级用户手动调试。
5. 本地优先 ：所有控制均在本地完成，无网络依赖，响应速度快且隐私风险极低。
   潜在缺点与局限性
6. 平台锁定严重 ：仅支持 macOS，Windows 和 Linux 用户无法使用；依赖 AppleScript 这一苹果专有技术。
7. 外部依赖复杂 ：必须同时安装并运行 Spotify 桌面应用、Airfoil 商业软件以及 spotify-applescript 技能，任一环节故障都会导致整体失效。
8. 硬件成本 ：Airfoil 为付费软件（Rogue Amoeba 出品），且需要支持 AirPlay 的音箱设备，入门门槛较高。
9. 无远程控制能力 ：纯本地架构意味着无法通过手机 App 或网络远程触发场景，必须在 Mac 终端或配合 Clawdbot 使用。
10. 错误处理有限 ：虽然使用了 set -euo pipefail ，但部分 AppleScript 调用失败时仅静默忽略（ || true ），可能导致场景"部分生效"而用户无感知。
    适合的目标群体
    macOS 重度用户 ：已深度融入苹果生态，拥有多台 AirPlay 音箱的家庭。
    智能家居爱好者 ：追求自动化体验，愿意通过终端/语音助手控制家居环境的技术早期采用者。
    Spotify + Airfoil 现有用户 ：已购买并配置好相关软件，希望进一步提升使用效率的人群。
    开发者/极客 ：具备 Bash 和 AppleScript 基础，能够根据文档自行扩展自定义场景的用户。
    使用风险
11. 依赖项失效风险 ：Spotify 或 Airfoil 的更新可能破坏 AppleScript 接口兼容性，导致技能突然失效。
12. 音箱连接不稳定 ：AirPlay 设备在网络波动时可能出现连接失败，脚本虽会尝试重连但无持久化状态管理。
13. 音量突变风险 ：场景切换时音量可能从 30% 跳变至 70%，若用户未预期可能造成惊吓或扰民。
14. 权限累积 ：长期使用 osascript 控制应用可能导致系统积累大量辅助功能权限，存在潜在的权限管理混乱风险。