🎤 dsh-voice-input — 系统级语音输入（DSH 插件）

在电脑上任何能输入文字的地方（浏览器、微信/QQ、Word、记事本、编辑器、搜索框……），按一个键说话，语音自动转成文字粘贴到当前光标处。不只是 DSH 里能用，是整个系统的能力。

• 完全本地运行：语音不出本机，无需联网、无 API 费用
• 本地小模型识别：Whisper small，中文效果好；有 N 卡自动走 GPU
• 轻量：模型懒加载，不用时不占显存/内存

功能

• 🎙 语音转写：按住 F2 说话 → 松开 → 文字粘贴到光标处
• ⏺ 纯录音：按 F3 开始 / 再按一次结束，保存 WAV（只录声音、不转写）
• 📋 历史记录：每条识别/录音都记下来（内容 + 时长 + 时间），托盘「设置」里可查看、复制、清空
• ⚙️ 设置页面：托盘图标右键 →「设置」，改热键 / 模式 / 模型 / 语言 / 设备 / 录音目录

快速开始

1. 确认电脑已装 Python 3（建议 3.10+），并有可用的麦克风。
2. 安装插件：

   npx -p @deepseek-ai/dsh dsh plugin --profile web add github:lougyang/dsh-voice-input
   

3. 重启 web profile。挂载即自动启动语音引擎（后台无窗口，托盘出麦克风图标）。
4. 在任意输入框里：按住 F2 说话 → 松开 F2，文字自动粘贴。

首次安装会自动创建 Python 环境并下载依赖（约 2.5GB）；首次按 F2 会自动下载模型（约 500MB）。都只发生一次。国内默认走清华 PyPI + hf-mirror 镜像。

停止 / 卸载

• 停止：托盘图标右键「退出」，或卸载插件（引擎随之停止）。
• 卸载：

  npx -p @deepseek-ai/dsh dsh plugin --profile web remove dsh-voice-input
  

配置

改法一：托盘「设置」页面（保存后即时生效，且不会随插件更新丢失）。

改法二：改 cordis.patch.yml 的 config（作为插件的默认配置）：

键	默认	说明
hotkey	f2	语音热键，如 ctrl+alt+space
mode	hold	hold 按住说话；toggle 按一下开/再按关
record_enabled	true	是否启用纯录音
record_hotkey	f3	录音热键
record_dir	空	录音保存目录；空则用 %USERPROFILE%\Recordings
model	small	tiny/base/small/medium/large-v3
language	zh	zh/en/auto
device	auto	auto(有N卡用GPU)/cpu/cuda

常见问题

• 按热键没反应：以管理员身份运行 DSH（普通权限无法向管理员窗口注入输入）。
• 没有识别到内容：检查麦克风是否可用、Windows 麦克风权限、输入音量。
• 首次启动慢：首次需建环境 + 下依赖 + 下模型，属正常；之后每次识别约 1~2 秒。

更完整的部署 / 排障说明（给 AI 代理看的）见 AGENTS.md。