需完成设备音频检查、麦克风权限授权、客户端语音开关启用、语音语言与语速配置、端到端交互测试五步。具体包括确认麦克风/扬声器正常、开启系统麦克风权限、点击界面麦克风图标启动监听、设置识别语言及响应速度、说出指令验证全流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在HermesAgent中启用语音模式，通过自然说话的方式与AI进行实时交互，则需完成客户端配置、权限授权及语音服务初始化。以下是开启语音模式的具体步骤：
一、检查设备麦克风与扬声器状态
语音模式依赖硬件音频输入输出功能正常工作，系统需能准确采集用户语音并播放AI响应。若麦克风被禁用或驱动异常，语音识别将无法启动。
1、在Windows系统中，右键任务栏右下角音量图标，选择“声音设置”。
2、进入“输入”选项卡，确认默认输入设备已启用，并点击“测试麦克风”观察音量条是否有波动。
3、进入“输出”选项卡，选择默认扬声器，点击“测试”按钮验证音频播放是否清晰。
4、在macOS中，打开“系统设置”→“声音”→“输入”，查看输入电平是否随说话实时变化；切换至“输出”标签页，播放测试音效确认扬声器可用。
二、授予HermesAgent麦克风访问权限
操作系统默认限制应用访问敏感硬件，必须手动开启麦克风权限，否则语音采集模块将被系统拦截。
1、在Windows 10/11中，进入“设置”→“隐私和安全性”→“麦克风”，确保“允许应用访问麦克风”开关为开启状态。
2、在下方“选择可以访问你的麦克风的应用”列表中，找到HermesAgent并将其右侧滑块设为“开”。如未显示，需先运行一次HermesAgent主程序以触发注册。
3、在macOS中，打开“系统设置”→“隐私与安全性”→“麦克风”，勾选HermesAgent左侧复选框。若应用未出现，点击左下角“+”号，手动添加其可执行文件路径（通常为/Applications/HermesAgent.app/Contents/MacOS/HermesAgent）。
三、在HermesAgent客户端中启用语音模式开关
语音功能需在应用内显式激活，界面按钮控制语音会话的启动、暂停与终止，同时触发底层ASR/TTS引擎加载。
1、启动HermesAgent桌面客户端，确保已登录有效账户并完成初始向导。
2、点击主界面右上角语音按钮（麦克风图标），图标由灰色变为蓝色即表示语音监听已就绪。
3、长按该按钮开始语音输入，松开后自动提交语音流至服务器进行识别；也可在设置中开启“免提持续监听”模式，此时无需长按，说出唤醒词（默认为“Hey Hermes”）即可激活。
4、首次启用时，客户端将弹出提示要求下载本地语音模型包，需保持网络畅通并预留约120MB存储空间。
四、配置语音识别语言与响应语速
语音交互质量受语言模型匹配度与合成语音节奏影响，需根据使用场景调整识别语言和TTS输出参数，避免误识别或响应延迟。
1、点击主界面左下角“设置”齿轮图标，进入“语音偏好”子页面。
2、在“语音识别语言”下拉菜单中，选择与您实际发音最接近的语种及方言变体（例如：中文（简体，中国大陆）、English（US）等）。
3、拖动“语音响应速度”滑块至中间偏右位置（建议值：75%），过高会导致合成语音失真，过低则响应迟滞明显。
4、启用“环境噪声抑制”开关，该功能可动态过滤键盘敲击、风扇声等常见背景干扰，提升远场语音识别准确率。
五、测试语音指令与基础交互流程
完成上述配置后，需执行端到端语音链路验证，确保从语音采集、云端识别、AI推理到语音播报全流程无阻断。
1、点击语音按钮，清晰说出测试指令：“今天北京天气怎么样？”
2、观察界面是否立即显示语音转文字结果，且底部状态栏提示“正在思考…”。
3、等待3–5秒后，确认AI响应内容是否通过扬声器播出，同时文字回复同步出现在对话窗口中。
4、若语音未触发或响应中断，立即查看客户端右下角通知栏中的错误代码（如ERR_MIC_INIT_FAILED、ASR_TIMEOUT），并依据代码查阅内置帮助文档对应章节。
