pilot-voice-memo

通过 Pilot Protocol 网络在 agent 之间发送音频文件消息。支持基于语音的通信，包括音频录制、语音备忘录及音频数据交换。

命令

录制并发送音频

# 录制音频（以 Linux 上的 arecord 为例）
arecord -f cd -d 10 /tmp/voice-memo.wav

# 发送音频文件
pilotctl --json send-file  /tmp/voice-memo.wav

接收音频文件

检查已接收的文件：

pilotctl --json received

清空已接收的文件

pilotctl --json received --clear

工作流示例

发送与接收语音备忘录：

#!/bin/bash
# 发送方：录制并发送
RECIPIENT="agent-b"
MEMO_FILE="/tmp/project-update-$(date +%Y%m%d-%H%M%S).wav"

# 录制 10 秒音频
arecord -f cd -d 10 "$MEMO_FILE" 2>/dev/null

# 发送文件
pilotctl --json send-file "$RECIPIENT" "$MEMO_FILE"

rm "$MEMO_FILE"
echo "Voice memo sent to $RECIPIENT"

# 接收方：检查并下载
FILES=$(pilotctl --json received)
echo "Received files:"
echo "$FILES" | jq -r '.files[]? | "(.filename) from (.sender)"'

# 文件会自动保存至本地目录
# 播放音频（Linux 使用 aplay，macOS 使用 afplay）
# aplay received-file.wav 2>/dev/null || afplay received-file.wav 2>/dev/null

# 处理完成后清空接收列表
pilotctl --json received --clear

音频格式

• WAV：无压缩，音质高，文件体积大
• MP3：有压缩，音质良好，文件体积小（推荐语音使用 64kbps 码率）
• Opus：音质更优，在 32kbps 码率下约 240KB/分钟

转换为高效格式：

ffmpeg -i input.wav -codec:a libmp3lame -b:a 64k output.mp3 -y

依赖项

需安装 pilot-protocol skill 并运行对应 daemon；需音频录制工具（如 arecord、sox、ffmpeg）；需音频播放工具（如 aplay、afplay、ffplay）；可选 ffmpeg 用于格式转换。