前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許社區開發者擴展核心能力。在構建語音交互場景時，開發者通常需要精細的會話控制、明確的用戶授權流程以及安全的草稿管理機制。jstn-1g/dsh-live-voice 插件旨在爲 DSH 提供一個受控的語音交互層，確保每一次語音交互都在明確授權下進行，並嚴格隔離會話環境。
插件簡介¶
插件名稱：jstn-1g/dsh-live-voice
核心價值：提供有條件的一次語音回合、合成演示及草稿移交能力。
維護者：Jstn-1g
許可證：MIT
核心功能¶
該插件主要包含以下已覈實能力：
- 有條件的一次語音回合：限制在單次對話回合內，需用戶明確確認。
- 精確會話隔離：確保每個語音會話獨立運行，避免狀態污染。
- 明確的草稿移交：提供明確的按鈕操作將轉錄文本放入草稿區。
- 免憑證本地合成演示：在不依賴外部憑證的情況下提供本地合成演示。
- 手動回合檢測：由用戶手動觸發或控制回合流程。
安裝與啓用¶
通過 DSH 命令行工具安裝該插件。請確保已安裝 dsh 客戶端。
- 執行以下命令安裝指定預覽版本：
dsh plugin --profile web add github:Jstn-1g/dsh-live-voice#v0.3.0-preview.5
- 安裝完成後，重啓 Web profile 並打開一個 Live Session。
典型用法¶
使用該插件進行語音交互的典型步驟如下：
- 在 Live Session 的編輯器控制欄中，點擊麥克風圖標以打開 DSH Live Voice。
- 在彈出的界面中，確認目標顯示爲 Local deterministic synthetic demo。
- 開始語音交互，完成回合後，界面會提供兩個轉錄文本。
- 點擊 Use my transcript as draft 按鈕。
- 注意：此操作僅將文本放入當前草稿區，不會自動提交編輯器。
適用場景與注意事項¶
該插件適合需要在 Web 環境下進行受控語音交互的開發場景。
注意事項：
* 未經驗證功能：基於憑證的 Qwen 模型、物理麥克風或揚聲器、打包的 Desktop 環境目前尚未經驗證。
* 併發限制：不要讓多個 Harness 實例同時寫入同一個持久化的 Session，這可能導致數據衝突。
* 操作邊界：插件設計爲安全沙箱，絕不會自動提交編輯器或運行工具。
總結¶
jstn-1g/dsh-live-voice 插件通過明確授權、會話隔離和手動控制，爲 DSH 提供了基礎的語音交互能力。對於需要構建安全、受控語音界面的開發者，這是一個可用的技術方案。
