何时使用

满足以下条件时加载此技能：

• 音频录制/唤醒词检测不工作
• 需要列出所有可用麦克风/输入设备
• 需要诊断 PyAudio 设备连接问题
• 需要确认设备索引号以传递给 --device 参数

诊断脚本

import pyaudio

p = pyaudio.PyAudio()
info = p.get_host_api_info_by_index(0)
numdevices = info.get('deviceCount')

print("Available audio input devices:")
for i in range(0, numdevices):
    if p.get_device_info_by_host_api_device_index(0, i).get('maxInputChannels') > 0:
        device_info = p.get_device_info_by_host_api_device_index(0, i)
        print(f"  Input Device id {i} - {device_info.get('name')}")

p.terminate()

命令

cd D:coze-localdb
python check_audio_devices.py

输出示例

Available audio input devices:
  Input Device id 0 - Microsoft Sound Mapper - Input
  Input Device id 1 - 麦克风 (Realtek(R) Audio)
  Input Device id 2 - 立体声混音 (Realtek(R) Audio)
  Input Device id 3 - CABLE Output (VB-Audio Virtual Cable)

故障排除

自动设备选择

设备 ID 0（Microsoft Sound Mapper - Input）是系统默认输入设备，兼容性最好。如果使用虚拟音频设备（如 VB-Cable），请使用对应的设备 ID。

相关文件

• D:coze-localdbcheck_audio_devices.py — 诊断脚本
• D:coze-localdbaudio.py — 音频核心模块
• D:coze-localexternalclawhub_skillswake-word-detectorSKILL.md — 唤醒词技能

依赖

pip install pyaudio