DeepSeek Harness（DSH）通過插件擴展系統能力。在開發或使用 DSH 時，有時需要在非 DSH 環境中快速輸入文本，例如在瀏覽器、微信或記事本中。dsh-voice-input 插件解決了這一需求，它利用本地 Whisper 模型實現全局語音轉寫，輸入內容直接粘貼到當前光標處。
插件簡介¶
這是一個由 lougyang 維護的 DSH 插件。掛載後，它會在後臺自動啓動語音引擎。通過全局熱鍵觸發，它可以識別語音並輸出文本。整個識別過程在本地完成，數據不會離開本機。
安裝與啓用¶
在安裝前，請確認電腦已安裝 Python 3（建議 3.10+）。
- 執行以下命令安裝插件：
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:lougyang/dsh-voice-input
- 重啓
webprofile。插件掛載後，語音引擎會自動啓動（托盤會出現麥克風圖標）。
核心功能¶
該插件主要提供以下三種能力：
-
語音轉寫
按住 F2 鍵說話，鬆開後文字會自動粘貼到當前光標處。識別基於本地 Whispersmall模型，中文識別效果較好。 -
純錄音
按下 F3 開始錄音，再次按下結束並保存爲 WAV 文件。此功能不進行轉寫，僅保存音頻。 -
歷史記錄與設置
每條識別結果或錄音都會記錄在歷史記錄中（包含內容、時長、時間）。用戶可以在托盤圖標右鍵的「設置」中查看、複製或清空記錄。
配置說明¶
插件支持通過托盤設置或配置文件修改參數。托盤設置保存後即時生效。以下是支持的配置項：
| 配置項 | 默認值 | 說明 |
|---|---|---|
hotkey |
f2 |
語音熱鍵，支持 ctrl+alt+space 等組合鍵 |
mode |
hold |
識別模式：hold 按住說話，toggle 按一下開/再按關 |
record_enabled |
true |
是否啓用純錄音功能 |
record_hotkey |
f3 |
錄音熱鍵 |
record_dir |
空 | 錄音保存目錄，空則使用 %USERPROFILE%\Recordings |
model |
small |
模型大小：tiny / base / small / medium / large-v3 |
language |
zh |
語言設置：zh / en / auto |
device |
auto |
設備選擇：auto（有 N 卡自動走 GPU） / cpu / cuda |
使用示例¶
在任意支持文字輸入的程序中（如瀏覽器、編輯器、搜索框）：
- 按住 F2 開始說話。
- 鬆開 F2。
- 系統會在 1~2 秒內將識別到的文字粘貼到光標位置。
注意事項¶
- 權限要求：必須以管理員身份運行 DSH。普通權限無法向管理員窗口注入輸入，導致無法在所有程序中粘貼文字。
- 環境依賴：首次安裝會自動創建 Python 環境、下載依賴（約 2.5GB）。
- 模型下載：首次按 F2 時會自動下載 Whisper 模型（約 500MB）。國內環境默認走清華 PyPI + hf-mirror 鏡像。
- 性能：首次啓動和加載模型需要時間，之後每次識別大約需要 1~2 秒。
