wukong-robot语音唤醒与合成问题排查指南

问题背景

在使用wukong-robot智能语音助手时，用户遇到了两个关键问题：首先是唤醒关键词文件缺失导致的OSError错误，其次是讯飞语音合成模块的websocket属性错误。本文将详细分析这两个问题的成因及解决方案。

唤醒关键词文件缺失问题

错误现象

系统报错显示无法在指定路径找到唤醒关键词文件：

OSError: Couldn't find keyword file at '/home/pixbus/.wukong/hello-bing_en_raspberry-pi_v3_0_0.ppn'

问题分析

wukong-robot使用Porcupine引擎实现离线唤醒功能，需要特定的关键词文件(.ppn)才能正常工作。这个文件通常需要用户手动放置到配置目录中，系统不会自动生成。

解决方案

1. 确认已从Porcupine官网获取正确的关键词文件
2. 将关键词文件放置在正确的目录路径下：
   • 默认路径为~/.wukong/
   • 确保文件名与配置文件中的设置完全一致
3. 检查文件权限，确保运行wukong-robot的用户有读取权限

讯飞语音合成失败问题

错误现象

系统尝试使用讯飞语音合成时出现错误：

AttributeError: module 'websocket' has no attribute 'enableTrace'

问题分析

这个错误表明Python的websocket客户端库存在版本兼容性问题。讯飞语音合成SDK调用了websocket.enableTrace()方法，但在当前安装的websocket库版本中不存在此属性。

解决方案

1. 检查当前安装的websocket库版本：

   pip show websocket-client
   

2. 安装兼容的websocket-client版本：

   pip install websocket-client==0.54.0
   

3. 如果问题仍然存在，可以尝试以下替代方案：

   • 修改XunfeiSpeech.py文件，注释掉websocket.enableTrace(False)这行代码
   • 或者使用其他TTS引擎作为临时解决方案

配置验证建议

完成上述修复后，建议按以下步骤验证配置：

1. 测试麦克风输入：

   arecord temp.wav
   aplay temp.wav
   

2. 测试语音唤醒功能：

   • 说出配置的唤醒词，观察系统是否能正确响应

3. 测试语音合成功能：

   • 通过命令行交互测试TTS功能是否正常工作

常见问题预防

为避免类似问题再次发生，建议：

1. 仔细阅读wukong-robot的安装文档，确保所有依赖项安装完整
2. 定期检查各组件版本兼容性
3. 在修改配置文件前做好备份
4. 使用虚拟环境管理Python依赖，避免版本冲突

总结

wukong-robot作为功能丰富的智能语音助手，其配置过程可能涉及多个组件的协调工作。遇到问题时，系统性的排查方法尤为重要。本文介绍的两个问题分别涉及文件路径配置和依赖版本管理，是Python项目中常见的两类问题。通过正确的解决思路，大多数配置问题都能得到有效解决。