pi-mimo-voice-input0.1.0
Pi MiMo 语音输入扩展 — 中文 ASR、本地 VAD、可选口语整理与录音自检
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-mimo-voice-input
小米 MiMo 中文语音输入扩展，支持 Ubuntu/Linux 和 macOS，提供本地人声检测、录音自检及可选口语整理。
1. 安装
需要 Pi 和 Node.js ≥ 22.19。先安装本机录音工具：
# Ubuntu / Debian
sudo apt install pulseaudio-utils alsa-utils
# macOS
brew install sox
npm 安装（首版 0.1.0 发布后可用）：
pi install npm:pi-mimo-voice-input
本地安装 / 开发：
cd /absolute/path/to/pi-mimo-voice-input
npm ci --ignore-scripts --legacy-peer-deps
pi install /absolute/path/to/pi-mimo-voice-input
不要同时加载本地版本与 npm 版本；切换前用 pi remove <原安装来源> 移除旧声明（旧包为 npm:pi-mimo-voice-zh）。
2. 配置
从 MiMo 控制台 获取普通 API Key（不支持 Token Plan），
创建或编辑 ~/.pi/mimo-voice-zh.json（沿用旧文件名以兼容已有配置），将 apiKey 填入：
{
"apiKey": "",
"sttShortcut": "f8",
"textCleanupEnabled": false
}
sttShortcut：录音快捷键，默认f8。textCleanupEnabled：启用口语整理，默认关闭；开启后增加一次 MiMo 文本请求，失败或超时保留原文。- 其他选项使用默认值，完整配置见 配置示例。
运行 chmod 600 ~/.pi/mimo-voice-zh.json 保护凭据，然后在 Pi 中执行 /reload。
不要将真实配置提交到 Git。
3. 使用
F8或/voice：开始录音，再次操作则停止并识别。等待“可以说话了”提示后再说话；部分键盘需按Fn+F8。/voice-test：本地录音自检，再次运行停止并回听，最多录制 10 秒；回放中再次运行可停止回放。/voice-status：查看设备、录音检测和口语整理状态。/voice-raw：恢复最近一次整理前的原文；草稿已修改或发送时不覆盖，退出或重载后不可恢复。/reload：重新加载代码和配置。
识别结果追加到编辑器，保留已有草稿，不会自动发送。启用口语整理后允许改写，发送前请人工复核。 录音发送给 MiMo；启用整理时还会发送转写文本。自检完全本地，不调用 API。