前言¶
在 DeepSeek Harness(dsh)裏寫提示詞,常見做法是手打或從別處粘貼。語音輸入能省 keystroke,但識別結果常有同音字、漏標點;草稿往往又偏籠統,還要再改一輪。社區插件 dsh-voice-enhance 在消息輸入區增加兩個控件:按住 Alt 說話,鬆開後在 Host 上轉寫並用默認模型糾錯再插入光標處;輸入框左側、模型選擇器前的 ✨ 按鈕則用同一默認模型把當前草稿改寫成更清晰、更具體的提示。下面介紹它做什麼、依賴什麼、如何安裝與使用。
這是什麼¶
dsh-voice-enhance 由維護者 Chrono-rigger 發佈,面向 DeepSeek Harness Web 客戶端。插件通過 Cordis patch 注入會話 UI(@deepseek-ai/dsh-client-ui-conversation),在消息 composer 上增加聽寫與提示增強能力;自身不配置、不讀取 API Key,糾錯與潤色走 Host 的 llm 服務,並使用當前 composition 的 default model route。許可證爲 MIT(package.json 版本 1.0.0)。
核心功能¶
按住 Alt 聽寫¶
- 按住
Alt開始錄音;鬆開Alt停止。 - 錄音在 Host 側轉寫,再經 Host 模型修正識別常見錯誤(同音字、錯字、缺標點等),結果插入當前光標位置。
- 若鬆開
Alt時同時還按了其它鍵(例如Alt+Tab、輸入法組合鍵),本次採集會被丟棄,避免誤觸。 - 錄音過程中按
Esc可取消。
✨ Enhance prompt¶
composer 左側、緊挨模型選擇器之前的 ✨ 按鈕,會用默認模型把當前草稿改寫成更清晰、更具體的 prompt,並 替換 草稿;完成後提供 Undo 可恢復原文。
進行中的狀態條¶
聽寫或潤色進行時,composer 卡片下方會出現狀態 pill:已用秒數、「send on release」開關、轉寫無法自動插入時的 Insert 按鈕,以及潤色後的 Undo 按鈕。
| 按鍵 / 控件 | 行爲 |
|---|---|
Alt(按住) |
開始錄音 |
鬆開 Alt |
停止、轉寫、糾錯、插入 |
Alt + 其它鍵 |
視爲快捷鍵,丟棄本次採集 |
錄音中 Esc |
取消 |
| ✨ 按鈕 | 潤色當前草稿 |
依賴與運行環境¶
- 語音轉寫 依賴 Harness 的 Voice Input 插件(
dsh-experimental-voice-input-bundle),須已啓用並完成 SenseVoice 模型準備;未就緒時插件會提示語音服務不可用。 - 糾錯與潤色 在 Host 上通過
llm完成;Remote 側各有一次性文本改寫調用:promptTools/refine,轉寫糾錯爲mode: "correct",草稿潤色爲mode: "enhance"。 - 瀏覽器 需麥克風權限(HTTPS 或
127.0.0.1,以及系統級麥克風授權)。 - DSH 版本:
engines.dsh要求>=0.2.1-rc.1 <0.3.0-0(見package.json)。
音頻鏈路端到端有超時(權限、recorder flush、解碼、重採樣、轉寫等),避免瀏覽器 API 卡死時出現 endless「transcribing」;錄音在轉寫後丟棄,不寫盤。
安裝與啓用¶
CLI 安裝(命令摘自倉庫 README,<profile> 換爲你的 profile 名):
dsh plugin --profile <profile> add github:owner/dsh-voice-enhance
倉庫地址爲 github.com/Chrono-rigger/dsh-voice-enhance;若 CLI 要求完整 GitHub 座標,以你當前 dsh plugin add 文檔與上述倉庫爲準。
或在 Web UI:Settings → Plugins,按包名或從本地目錄安裝 bundle。
安裝前請自行查看 GitHub 源碼 與 MIT 許可證;插件在 當前 dsh 進程權限 下運行,與其它 DSH 插件相同,安裝前應確認你信任該來源。
典型用法¶
- 確認
dsh-experimental-voice-input-bundle已啓用且 SenseVoice 就緒,瀏覽器已允許麥克風。 - 在會話消息框內將光標放到要插入文字的位置,按住
Alt說話,鬆手;等待轉寫與糾錯完成後文本出現在光標處。 - 若狀態條裏出現 Insert,說明未能自動插入,可手動點 Insert。
- 寫好草稿後點 composer 左側 ✨,等待潤色完成;不滿意則用 Undo 恢復。
- 可選:狀態條中的 send on release 開關會寫入瀏覽器本地偏好(
localStorage鍵dsh-voice-enhance.autoSend);除該項外插件不持久化其它數據。
適用場景與注意¶
- 適合:經常在 DSH Web 裏寫長 prompt、希望少打字又願意用 Host 默認模型做一輪識別糾錯或結構化潤色的開發者。
- 不適合:未安裝或未配置 Voice Input / SenseVoice 的環境;需要獨立配置 LLM API Key 的場景(本插件不讀 Key,完全依賴 Host 路由)。
- UI 樣式使用 Host 主題 token(
--dsw-alias-*),亮暗主題無需單獨資源。 - 社區目錄 skillhub.cn 上的插件頁 與 GitHub 均爲社區維護信息源,與 DeepSeek / 幻方無官方從屬關係;DSH 生態強調「一切皆插件」,是否安裝由你自行評估。
結尾¶
dsh-voice-enhance 把聽寫、識別糾錯和草稿潤色收進消息 composer 的兩個控件裏,依賴 Voice Input 做轉寫、依賴 Host 默認模型做文本改寫,本地幾乎只存「鬆手是否發送」一項偏好。進一步瞭解可訪問目錄頁 https://www.skillhub.cn/plugins/Chrono-rigger/dsh-voice-enhance 與倉庫 https://github.com/Chrono-rigger/dsh-voice-enhance。