zemanzhang809/dsh-stt-plugin：DeepSeek Harness 語音輸入插件

DeepSeek Harness (DSH) 支持插件化擴展。語音輸入是對話界面中的常見需求，但原生支持有限。該插件通過在對話編寫器工具欄中增加麥克風按鈕，利用瀏覽器 Web Speech API 實現實時語音轉文本。

核心功能¶

1. 麥克風開關：在對話編寫器工具行中添加麥克風按鈕，點擊開始/停止錄音。
2. 語音輸入設置：在設置對話框中提供語音輸入頁面，支持設置識別語言和聽寫模式。
3. 自動發送：在單次模式下，短語結束後自動提交消息。
4. 連續聽寫：開啓後保持麥克風開啓，短語累積在草稿中。
5. 本地音頻處理：音頻僅在瀏覽器本地處理，不會發送給宿主或模型提供商。
6. 生命週期管理：使用 Clean Cordis 生命週期管理，卸載時清理插槽、樣式和字典。

安裝與啓用¶

使用前需確保環境滿足以下要求：

• DeepSeek Harness 需要從源碼運行 (pnpm dsh web) 或部署支持 profile 的版本。
• Node.js ≥ 18 / pnpm ≥ 8。

安裝¶

推薦使用 npm 註冊表安裝：

dsh plugin --profile web add dsh-stt-plugin

如果網絡受限，可以使用 GitHub 安裝：

dsh plugin --profile web add github:zemanzhang809/dsh-stt-plugin

驗證安裝¶

在終端運行以下命令確認配置：

dsh --profile web --dump-config

輸出中應包含 id: stt 和 name: dsh-stt-plugin。

使用方法¶

1. 打開會話，使對話編寫器處於激活狀態。
2. 點擊麥克風按鈕並開始說話。識別出的文本會實時追加到草稿區（臨時結果也會實時寫入）。
3. 再次點擊麥克風按鈕停止聽寫。在單次模式下開啓“識別後自動發送”時，短語結束後消息會自動提交。

語音輸入設置¶

打開 設置 → 語音輸入：

• 識別語言：默認爲 auto，跟隨瀏覽器語言，也可手動指定 BCP-47 代碼（如 zh-CN, en-US）。
• 連續聽寫：關閉時，說話結束即停止；開啓後需手動再次點擊按鈕停止。
• 識別後自動發送：僅在單次模式下有效，短語結束後自動提交。

設置偏好會持久化到 DSH 設置存儲，若不可寫則回退到本地存儲。

注意事項¶

• 瀏覽器支持：Chrome/Edge 支持完整；Safari 支持部分；Firefox 不支持（按鈕渲染爲禁用）。
• 麥克風權限：首次使用需授予瀏覽器麥克風權限。
• 中國網絡環境：如無法訪問 GitHub，請使用 npm 註冊表（推薦）或配置 pnpm 鏡像（如 https://registry.npmmirror.com）。
• 本地運行：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。