前言¶
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 倉庫 或 插件目錄頁。
