🔊 Airfoil 技能

    ╔═══════════════════════════════════════════════════════════╗
    ║                                                           ║
    ║   🎵  A I R F O I L   S P E A K E R   C O N T R O L  🎵  ║
    ║                                                           ║
    ║        将音频流式传输至任意 AirPlay 音响                 ║
    ║              通过 CLI 从你的 Mac 发起                     ║
    ║                                                           ║
    ╚═══════════════════════════════════════════════════════════╝

“何必起身走到 Mac 前？直接对它‘呱’一声就好！”

📖 此技能的作用是什么？

Airfoil 技能让你无需触碰鼠标，即可在终端（或通过 Clawd）完全掌控你的 AirPlay 音响——连接音响、调节音量、查看状态，全部一气呵成。

功能特性：

• 📡 list — 列出所有可用音响
• 🔗 connect — 连接指定音响
• 🔌 disconnect — 断开与指定音响的连接
• 🔊 volume — 调节音量（0–100%）
• 📊 status — 显示当前已连接音响及其音量级别

⚙️ 系统要求

安装步骤

1. 安装 Airfoil：

   # 通过 Homebrew 安装
   brew install --cask airfoil
   
   # 或从 rogueamoeba.com/airfoil/mac/ 下载安装
   

2. 启动 Airfoil，并在系统设置中授予辅助功能权限（System Settings → Privacy & Security → Accessibility）

3. 技能已就绪！ 🚀

🛠️ 命令说明

list — 列出所有音响

./airfoil.sh list

输出示例：

Computer, Andy's M5 Macbook, Sonos Move, Living Room TV

connect — 连接音响

./airfoil.sh connect "Sonos Move"

输出示例：

Connected: Sonos Move

💡 音响名称必须完全匹配（区分大小写！）

disconnect — 断开音响连接

./airfoil.sh disconnect "Sonos Move"

输出示例：

Disconnected: Sonos Move

volume <0-100> — 设置音量

# 设为 40%
./airfoil.sh volume "Sonos Move" 40

# 设为最大音量
./airfoil.sh volume "Living Room TV" 100

# 夜间静音模式
./airfoil.sh volume "Sonos Move" 15

输出示例：

Volume Sonos Move: 40%

status — 查看已连接音响

./airfoil.sh status

输出示例：

Sonos Move: 40%
Living Room TV: 65%

若当前无音响连接，则输出：

No speakers connected

🎯 典型使用场景

🏠 “客厅听音乐”

./airfoil.sh connect "Sonos Move"
./airfoil.sh volume "Sonos Move" 50
# → 接着启动 Spotify / Apple Music，尽情享受！

🎬 “电影之夜准备”

./airfoil.sh connect "Living Room TV"
./airfoil.sh volume "Living Room TV" 70
./airfoil.sh disconnect "Sonos Move"  # 若此前已连接

🌙 “全部关闭”

for speaker in "Sonos Move" "Living Room TV"; do
    ./airfoil.sh disconnect "$speaker" 2>/dev/null
done
echo "All speakers disconnected 🌙"

🔧 故障排查

❌ “未找到音响”

问题：execution error: Airfoil got an error: Can't get speaker...

解决方案：

1. 确认拼写完全正确：./airfoil.sh list
2. 音响名称严格区分大小写（"sonos move" ≠ "Sonos Move"）
3. 音响需与 Mac 处于同一网络
4. 音响须已开机且可被发现

❌ “Airfoil 无法启动 / 权限不足”

问题：AppleScript 无法控制 Airfoil

解决方案：

1. 进入 System Settings → Privacy & Security → Accessibility
2. 添加 Terminal（或 iTerm）
3. 添加 Airfoil
4. 必要时重启 macOS（有时必需 🙄）

❌ “音量调节无效”

问题：执行 volume 命令后无响应

解决方案：

1. 必须先 连接音响，才能调节其音量
2. 请先执行 connect，再执行 volume
3. 部分音响存在硬件级音量限制

❌ “Airfoil 未安装”

问题：execution error: Application isn't running

解决方案：

# 启动 Airfoil
open -a Airfoil

# 或安装 Airfoil
brew install --cask airfoil

❌ “bc: command not found”

问题：音量计算失败

解决方案：

# 安装 bc（macOS 默认应已预装）
brew install bc

📋 已验证支持的音响

以下音响已实测兼容：

💡 使用 ./airfoil.sh list 可自动发现你网络中的所有音响！

🔗 与 Clawd 的集成

本技能与 Clawd 完美兼容！示例如下：

"Hey Clawd, connect the Sonos Move"
→ ./airfoil.sh connect "Sonos Move"

"Turn the music down"
→ ./airfoil.sh volume "Sonos Move" 30

"Which speakers are on?"
→ ./airfoil.sh status

📜 更新日志

🐸 致谢

  @..@
 (----)
( >__< )   "This skill was crafted with love
 ^^  ^^     by a frog and his human!"

作者：Andy Steinberger（并得到他的 Clawdbot —— 青蛙 Owen 的协助 🐸）
技术支持：Airfoil by Rogue Amoeba
所属项目：Clawdbot Skills Collection