前言¶
DeepSeek Harness 的核心设计理念是「一切皆插件」。在 Web profile 中进行对话时，手动输入任务往往耗时且繁琐。dsh-mic-dictation 旨在解决这个问题，通过原生客户端插件的方式，在提问栏增加语音输入功能。
插件定位¶
dsh-mic-dictation 是一个 DeepSeek Harness 原生客户端插件，由用户 Kilganon725 维护。
它的核心作用是在 Web 提问栏的 Full access 左侧插入一个麦克风按钮。用户可以直接使用电脑麦克风说话，识别出的文字会自动写入提问框，无需切换输入法或手动打字。
核心能力¶
- 浏览器原生识别：使用浏览器原生的
SpeechRecognition/webkitSpeechRecognition，中文优先（zh-CN）。 - 即插即用：纯客户端插件，安装即用，无需修改 DSH 源码。
- 数据安全：不索取、不存储任何 API Key 或账号信息，不收集语音、文字或任何会话数据。
- 自动适配：自动跟随 React 重渲染，确保按钮始终位于 Full access 左侧；支持 HMR 与插件卸载时的自动清理。
- 精准注入：通过
MutationObserver定位 DOM 节点，确保按钮位置精确且稳定。
安装与启动¶
安装该插件需要先确保系统安装了 pnpm，因为 dsh plugin 内部会调用它。
- 安装插件：
执行以下命令将插件添加到 Web profile：
dsh plugin --profile web add dsh-mic-dictation
- 启动服务：
在终端运行：
dsh web
- 刷新页面：
打开浏览器访问 localhost 或 127.0.0.1，刷新页面后，提问栏 Full access 左侧会出现麦克风按钮。
使用流程¶
- 点击提问栏左侧的麦克风按钮。
- 浏览器会请求麦克风权限，选择允许后开始说话。
- 说出指令，例如：“帮我整理一下桌面上的 DeepSeek Harness 项目”。
- 识别中的文字会实时显示在按钮提示里，最终结果会自动写入提问框。
- 再点一次按钮停止识别，然后正常按发送。
环境与注意¶
- 浏览器兼容性：Firefox 对
SpeechRecognition的支持不完整，请使用 Chrome、Edge 或 Safari。 - 页面地址：必须访问
localhost或127.0.0.1，这是浏览器安全上下文的要求。 - 网络要求：需要联网。Chrome 的语音识别依赖 Google 语音服务。
- 隐私说明：识别过程完全在浏览器本地完成，Chrome 会将音频发送至 Google 服务识别。插件本身不收集任何数据，建议不要在识别过程中口述敏感信息。
结语¶
该插件通过原生浏览器能力简化了 DSH Web 端的输入流程，适合习惯语音输入或需要快速布置任务的场景。如需查看更多细节或提交 Issue，可访问 GitHub 仓库 或 插件目录页。
