语音输入 是做什么的？
触发条件
- 用户给了一个音频文件路径或 URL，要求"转写 / 听写 / 语音转文字 / 提取音频内容"。
- 用户询问如何配置 voicelens 的 ASR 引擎（OpenAI 兼容端点 / Groq / whisper.cpp）。
- （仅 DSH）用户在输入框点麦克风按钮说话 —— 这条路径由客户端插件自动完成，不需要本技能介入。
核心规则
音频出现但当前模型"听不到"时，不要自己写 ffmpeg / OCR / 转写脚本，先转写并引用返回的 text 作为证据。
执行（按宿主检测）
- DeepSeek Harness（有
transcribe_audio工具）→ 直接调用该工具，传path或url。 - 其他宿主（Claude Code / Codex / Pi / OpenClaw / OpenCode …）→ 运行 CLI：
输出 JSON：voicelens transcribe <file-or-url> [--lang zh] [--provider groq]{ "text", "language", "provider" }，引用text作为证据。 - 诊断（任何宿主）：
voicelens doctor
配置（供 agent 替用户执行）
配置分层：环境变量 VOICELENS_* > ~/.voicelens/config.json > 内置默认。
方案 A：Groq（免费额度，推荐）
VOICELENS_PROVIDER=groq
VOICELENS_GROQ_API_KEY=<gsk_...>
方案 B：OpenAI 兼容端点（任意 whisper 网关）
VOICELENS_PROVIDER=openai
VOICELENS_OPENAI_API_KEY=<key>
VOICELENS_OPENAI_BASE_URL=https://api.openai.com/v1
VOICELENS_OPENAI_MODEL=whisper-1
方案 C：本地 whisper.cpp（零 key）
VOICELENS_PROVIDER=whisper-local
VOICELENS_WHISPER_CPP=/path/to/whisper.cpp/build/bin/main
VOICELENS_WHISPER_MODEL=/path/to/ggml-base.bin
或写入 ~/.voicelens/config.json：
{ "provider": "groq", "groqApiKey": "gsk_..." }
输出契约
{ text, language?, provider } —— 模型侧转写统一走这个形状（工具与 CLI 一致）。
已知边界
- DSH 当前没有音频消息管线（
attachments仅图片、ModelModality仅 text|image），所以语音摄入端在 DSH 客户端麦克风按钮；模型侧文件转写走本技能/工具。 - DSH 麦克风按钮依赖 Chrome/Edge 的
SpeechRecognition（零配置）；其余浏览器提示切换。