前言¶
在 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 用戶。安裝前請閱讀倉庫說明與限制（左右耳鍵位、權限、系統語音識別設置）。
