dsh-ears

<h1 align="center">dsh-ears</h1> <p align="center"><b>一款支持润色整理的 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a> 语音输入插件。</b></p>

简体中文 · <a href="./README.en.md">English</a>

https://github.com/user-attachments/assets/1363768e-a393-44bd-a008-1ce2055cac41

---

dsh-ears 为 DeepSeek Harness 提供语音输入与 LLM 润色整理能力。支持浏览器 Web Speech、本地 Whisper 以及主流语音识别（ASR）API 服务。

安装

前置依赖：DeepSeek Harness >=0.2.0-rc.1，以及 Node.js ^22.19.0 || >=24.0.0。

通过 npm 安装

Web UI：

dsh plugin --profile web add dsh-ears

桌面端：在插件管理界面中安装。桌面端独占名为 desktop 的 profile，dsh 命令不会管理它，因此没有对应的命令行写法。dsh-ears 不需要单独的桌面端构建，两个界面加载同一个 web 客户端包。

仍在使用 dsh 0.1.x？ dsh-ears 0.4.3 要求 dsh >=0.2.0-rc.1，dsh 会直接拒绝在旧版本上安装。请继续使用对应的旧版本线：

# dsh 0.1.2–0.1.6
dsh plugin --profile web add "dsh-ears@<0.4.0"
# dsh 0.1.7（dsh-ears 0.4.0 要求 dsh 0.1.7-rc.2 及以后）
dsh plugin --profile web add "dsh-ears@<0.4.1"
# dsh 0.1.1
dsh plugin --profile web add "dsh-ears@<0.3.0"

从源码安装

git clone https://github.com/WizisCool/dsh-ears.git
cd dsh-ears
pnpm use:platform
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
# Windows 的 cmd 请使用 "%CD%"；PowerShell 直接使用 $PWD

pnpm use:platform 将 node_modules 切换到当前平台的 native 依赖树（Windows / Linux 各自独立），首次克隆和跨平台切换后都需要运行。

安装完成后刷新 Web UI，输入框右侧会显示麦克风图标。

更新

dsh plugin --profile web add dsh-ears

add 会从 npm 拉取最新版本，任何已装版本都可以直接运行。更新后需要重启 dsh web 加载新的服务端代码，再刷新 Web UI；也可以在设置页的"关于"面板检查新版本。

卸载

dsh plugin --profile web remove dsh-ears

卸载后刷新 Web UI。

使用

1. 点击麦克风图标，或按下 Ctrl+Shift+Space（可在设置页更改）
2. 开始说话
3. 再次按下快捷键或点击麦克风，停止录音并开始转写
4. 开启润色后，原始转写会先写入草稿，润色完成后再更新，期间的手动编辑会被保留
5. 检查内容后手动发送

转写结果始终写入可编辑草稿，不会自动发送。如果所选后端尚未就绪，麦克风图标会变灰，悬停即可查看原因。

识别后端

后端	工作方式	需要什么
Web Speech	浏览器实时识别	默认后端；Chromium 内核浏览器
本地 Whisper	录音结束后本地转写	在设置页下载 GGML 模型
Groq	Groq Whisper API	API key
Deepgram	预录音频或实时音频流	API key、模型名（如 nova-3）
阿里云百炼	DashScope 同步转写	API key、同步模型 ID；单次最长 300 秒
腾讯云	录音文件识别或实时语音识别	AppID、SecretID、SecretKey、engine_type
小米 MiMo	语音识别 API，支持标准 API 或 Token Plan	API key、模型名（如 mimo-v2.5-asr）；Token Plan 需选择区域集群
硅基流动 (CN)	语音转写 API	API key、模型名（如 FunAudioLLM/SenseVoiceSmall）
火山引擎	录音文件识别（大模型）或单向流式语音识别	API key（新版控制台 X-Api-Key）、资源 ID
自定义 OpenAI 兼容	发送到指定 /audio/transcriptions 端点	端点地址、API key、模型名

…