完整的语音转写安装指南，可以直接给新的hermes agent使用。
Hermes 语音输入（STT）安装指南
前置条件
Hermes Agent 已安装
有麦克风
步骤
1. 安装 faster-whisper（语音识别引擎）
用 uv 装，不要用 pip（Hermes 的 pip 有版本错乱问题）：
代码· bash uv pip install "faster-whisper>=1.0"
2. 设置国内镜像（如果翻墙了就跳过）
代码· bash set HF_ENDPOINT=https://hf-mirror.com
3. 下载 whisper 模型（首次需要下载）
代码· bash # 直接运行下面命令，会自动从 HuggingFace 下载 small 模型 python -c " from faster_whisper import WhisperModel model = WhisperModel('small', device='cpu') print('✅ 下载并加载成功') "
如果下载慢或失败：
有翻墙→直接重试
没翻墙→先 set HF_ENDPOINT=https://hf-mirror.com 再用国内镜像
4. 配置 Hermes
代码· bash # 启用 STT hermes config set stt.enabled true hermes config set stt.provider local hermes config set stt.local.model small hermes config set stt.local.language zh # 设置录音快捷键（默认 Ctrl+B，改成不冲突的） hermes config set voice.record_key "ctrl+q"
5. 重启 Hermes
新开一个会话生效。
6. 使用
在 Hermes 输入框中：
代码 按 Ctrl+Q → 听到提示音 → 说话 → 按 Enter → 文字自动填入
全程离线、免费、不翻墙。
如果遇到问题
Q: 按快捷键没反应？ → 快捷键被输入法/其他软件拦截了，换一个：
代码· bash hermes config set voice.record_key "ctrl+m"
Q: ModuleNotFoundError: No module named 'faster_whisper' → Hermes 的 pip 和 python 版本可能错位。用 uv pip install faster-whisper，不要用 pip install。
Q: ConnectTimeout / 下载超时 → 国内网络被墙了。有翻墙就开翻墙重试。没翻墙就：
代码· bash set HF_ENDPOINT=https://hf-mirror.com
然后再跑第 3 步。
