dsh-voice-input

English | 简体中文

适用于 DeepSeek Harness Web UI 的语音转文字输入插件。

插件会在消息发送按钮前添加一个麦克风按钮。它使用浏览器的 Web Speech API，将识别结果实时写入当前输入框草稿，并且不会自动发送消息。

功能

• 使用官方 conversation.input.right 扩展插槽。
• 同时支持标准版和带 WebKit 前缀的 SpeechRecognition 实现。
• 默认使用浏览器语言；无法获取时回退到 zh-CN。
• 为中文、日文、韩文和拉丁文字保留自然的拼接间距。
• 再次点击按钮即可停止录音；组件卸载时会自动中止识别。
• 无需额外 API Key 或主机端服务。

安装

直接从 GitHub 安装到 Web profile：

dsh plugin --profile web add github:forrestahha/dsh-voice-input
dsh web

如需固定版本：

dsh plugin --profile web add github:forrestahha/dsh-voice-input#v0.1.1

打开 Web UI，选择工作目录，然后点击麦克风按钮。首次使用时，浏览器会请求麦克风权限。

识别出的文字只会进入输入框草稿。确认内容无误后，需要手动点击发送按钮。

浏览器支持

插件要求浏览器支持 SpeechRecognition 或 webkitSpeechRecognition。Chromium 系浏览器的支持最完善。不支持语音识别的浏览器会显示一个禁用的麦克风按钮，而不会导致页面启动失败。

现代浏览器会将 localhost 视为安全上下文。如果 Harness 运行在另一台机器上，请使用 HTTPS，否则浏览器可能拒绝麦克风访问。

隐私说明

插件不会存储音频，也不会自行添加网络请求。Web Speech API 的具体实现由浏览器控制，浏览器可能会把音频发送给其供应商的语音服务。在录制敏感内容前，请先查看浏览器的隐私政策。

开发

环境要求：Node.js ^22.19.0 || >=24.0.0 和 pnpm 11。

pnpm install
pnpm check

安装本地代码进行集成测试：

dsh plugin --profile web add /absolute/path/to/dsh-voice-input
dsh web

设计

该 npm 包同时是 Harness bundle 和客户端插件：

• cordis.patch.yml 将该包插入所选 profile。
• Node 入口有意保持为空；dsh.client 会发现 ./client。
• 浏览器入口会把 VoiceInputButton 注册到 conversation.input.right。
• Harness 通过插槽属性提供当前输入状态和 inputActions.setDraft()。

插件不会修改 agent loop、模型、会话日志或 Host API 行为。

许可证

MIT