前言¶
在 Windows 上给 AI 客户端、浏览器里的对话页或 Agent 程序写提示词，多半还是靠键盘。Windows 自带语音输入（Win+H）能把口述转成文字并落到当前焦点输入框，但要从耳机或戴上耳机后切回键盘，流程往往被打断。若耳机触摸能直接触发 Win+H 和回删，口述—修正—继续说明可以在不离开输入框的前提下完成。
下文介绍 DSH 社区插件 dsh-bluetooth-earbuds（维护者 glowwan，分类：客户端）：把蓝牙耳机在 Windows 侧可见的按键映射为桌面级 语音输入 和 回删，焦点在哪个输入框，文字就进哪里，不绑定某一个 AI 产品。
这是什么¶
dsh-bluetooth-earbuds 是 DeepSeek Harness（DSH）的 Windows 桌面侧插件。它在系统键盘层注入快捷键，把耳机手势转成 Win+H（启动 Windows 语音输入）或 Backspace（删除光标前字符）。插件本身不录音、不联网、不上传音频；语音识别由 Windows 完成。
- 仓库：github.com/glowwan/dsh-bluetooth-earbuds
- 社区目录：skillhub.cn/plugins/glowwan/dsh-bluetooth-earbuds
- 当前 package 版本：1.0.3，许可证 MIT
- 运行环境：Windows 10/11、DSH 桌面版（
engines.dsh:>=0.2.1-rc.1 <0.3.0-0）
DSH 的生态理念是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装任意插件前，建议自行查看仓库源码与许可证；插件以后台助手形式运行，权限与启动 DSH 的进程一致。
核心功能¶
README 中针对一副 TWS 耳机的实测行为如下（其他型号需自行在设置页「学习按键」核对）：
| 耳机侧手势 | Windows 收到的键 | 插件默认映射 |
|---|---|---|
| 左侧三击 | 音量减 | 发送 Win+H，启动语音输入 |
| 右侧三击 | 音量加 | 发送 Backspace |
| 长按 | 耳机内提示音 | 不能作为触发（Windows 收不到按键） |
补充说明：
- 长按的「嘟」声是耳机内部提示，不会作为按键发给 Windows，软件无法把长按当快捷键。
- 单次轻触两侧很可能都发「播放/暂停」，Windows 无法区分左右耳；插件依赖两侧发送 不同 的键才能分别映射。
- 触发音量键时系统音量条可能短暂出现；插件会还原音量，避免越按越小/越大。
- 键盘上的音量加/减键会被当作同样手势；若不想用物理音量键触发，可在设置页关闭「启用快捷键」。
在 DSH 设置 → 蓝牙耳机语音键 中可手动选择左右耳按键、测试、调整每次回删字符数（1–10），并查看最近一次耳机按键。行为选项还包括「拦截原始媒体键」等，详见仓库 README。
映射持久化路径：
%USERPROFILE%\.dsh\plugin-data\bluetooth-earbuds.json
卸载插件不会自动删除该文件；要恢复默认可在设置页重选，或删除该文件后重启 DSH。
为什么适合 AI / Agent 工作流¶
插件不绑定具体 AI：DeepSeek Harness、ChatGPT / Claude 桌面端、浏览器 AI 页、Cursor / VS Code、聊天窗口等，只要焦点在可编辑输入框即可。配合 DSH Agent 时，左耳口述相当于任务输入口，右耳回删便于改口重说。
README 中的口述示例（场景说明，非用户反馈数据）：
| 场景 | 可以怎么说 |
|---|---|
| 让 Agent 改代码 | 「把登录页的报错提示改成中文，并补一个单元测试」 |
| 总结 / 翻译 | 「把这段英文邮件总结成三点，再用中文回复」 |
| 查资料 | 「查一下这个库最新版本，比较它和现在用的版本有什么破坏性变更」 |
| 长任务追加约束 | 「先不要改数据库，只改接口层，做完告诉我改了哪些文件」 |
安装与启用¶
插件市场收录后，可搜索 Bluetooth earbud keys / 蓝牙耳机语音键 安装。手动安装使用仓库文档中的命令（注意 --profile desktop）：
dsh plugin --profile desktop add github:glowwan/dsh-bluetooth-earbuds
要求 Windows 10/11 与 DSH 桌面版。首次启动会用 Windows 自带的 csc.exe 编译 helper/EarbudHelper.exe，不需要安装 .NET SDK。插件依赖 DSH 常驻：关闭 DSH 后按键助手停止，耳机快捷键失效。
首次使用¶
- 安装后打开 设置 → 蓝牙耳机语音键，确认状态为「监听中」。
- 确认
Win+H能转写：在任意输入框按一次Win+H试说一句话。若只弹语音条无文字，到 Windows 设置 → 隐私和安全性 → 语音 开启 在线语音识别（README 记载：本机实测开启后Win+H才能正常转写）。确认默认麦克风未静音；耳机 Hands-Free 或本机麦克风均可。 - 在左右耳卡片中选择映射（示例：左耳 → 音量减键，右耳 → 音量加键），或使用「学习按键」真实触发一次音量/媒体键。
- 点 测试：左耳约 2.5 秒后发送
Win+H（先点进目标文本框）；右耳发送一次 Backspace（需光标在已有文字的输入框内）。
若两侧选到同一个键，设置页会拒绝保存并提示——这是 Windows 只能看到按键、无法区分左右耳触摸的限制所致。部分耳机把触摸用于手机助手或经 HFP 发私有事件，这类操作不会进入 Windows，插件也收不到。
工作原理（简述）¶
Host（index.js）半启动 helper/EarbudHelper.exe。助手通过低级键盘钩子、Raw Input、GetAsyncKeyState 等路径检测媒体键，并通过 Core Audio 检测音量变化（适配只发音量增减的耳机）。左耳触发时注入 Win+H，右耳注入 Backspace。设置页由 client.js 提供。
开启在线语音识别后，语音转写按 Microsoft 隐私政策由 Windows 处理，可能涉及向 Microsoft 发送语音数据——这是系统语音能力的行为，非本插件上传音频。
排错要点¶
| 现象 | 处理方向 |
|---|---|
| 状态「未运行」 | 点「重新启动助手」，查看设置页错误信息 |
| 三击无反应 | 确认左右耳键位与「监听中」；音量已在最大/最小时可能无法检测 |
Win+H 只弹窗不出字 |
开启在线语音识别；检查麦克风未静音 |
| 右耳不回删 | 光标须在文本框内且有可删字符 |
| 长按无反应 | 预期行为：长按不产生 Windows 按键 |
| 对某些窗口无效 | 普通权限无法向管理员权限窗口注入按键；使目标程序与 DSH 权限一致 |
更完整的对照表见仓库 README「排错」一节。
结尾¶
dsh-bluetooth-earbuds 把蓝牙耳机在 Windows 上可识别的音量/媒体手势，映射成系统级 Win+H 与 Backspace，适合需要在桌面各输入框里快速口述提示词、并用耳机修正错字的 DSH 用户。安装前请阅读仓库说明与限制（左右耳键位、权限、系统语音识别设置）。
