在使用 DeepSeek Harness 進行模型推理和調試時,Web 界面的交互體驗直接影響效率。針對長對話流中雜亂的工具調用顯示以及原生輸入框功能的侷限性,本插件提供了一套輕量級的增強方案。
Dsh UI 增強 (dsh-ui-enhance) 是由 xjackzenvey 維護的插件,旨在爲 DeepSeek Harness 的 Web 界面提供一組可選的交互與樣式增強。當前版本爲 0.4.0,基於 DeepSeek Harness 0.1.0-rc.6 客戶端包開發。
核心功能¶
語音輸入¶
在“發送消息”按鈕左側增加麥克風按鈕,利用瀏覽器 Web Speech API 將語音轉換爲文本。點擊麥克風可開始或停止識別,識別結果會追加到當前輸入框的內容中,不會自動發送消息。該功能需要瀏覽器授予麥克風權限,建議使用支持 SpeechRecognition 的 Chromium 瀏覽器。
工具調用摺疊¶
在工具調用較多時,該功能會自動將連續且類型相同的工具調用合併爲一張可展開的彙總卡。例如,多個 Read 調用會被合併爲一張卡片。展開彙總卡後,會恢復原有的工具行、文件鏈接和詳情交互能力。不同工具調用,或被思考、文本等內容隔開的同類調用不會被合併。該功能默認開啓,可通過設置即時切換。
自定義 CSS¶
在插件設置中提供多行 CSS 編輯器。編寫的內容會立即應用於整個 Harness 頁面並自動保存。清空編輯器即可移除自定義樣式。由於作用於整個頁面,錯誤或過於寬泛的選擇器可能會影響 Harness 原有佈局。
安裝與啓用¶
使用官方提供的安裝命令即可將插件添加到 Web profile 中:
dsh plugin --profile web add "dsh-ui-enhance"
安裝完成後,啓動 Harness Web profile:
dsh --profile web
典型用法¶
語音輸入¶
在輸入框中點擊麥克風圖標開始識別。識別出的文字會追加在光標處,確認內容無誤後點擊發送按鈕即可。
工具調用摺疊¶
進入插件設置頁面,路徑爲 設置 → 插件 → 插件配置 → Dsh UI 增強 → 工具調用摺疊。點擊開關即可切換摺疊功能。關閉時頁面會立即恢復爲原生工具調用列表。
自定義 CSS¶
在多行編輯器中編寫 CSS 代碼。修改完成後,頁面樣式會即時更新。若需恢復默認樣式,只需清空編輯器內容並保存。
環境要求¶
安裝及運行本插件需要滿足以下環境條件:
- Node.js:
^22.19.0或>=24.0.0 - pnpm:
11.19.0 - DeepSeek Harness: 當前依賴以
0.1.0-rc.6客戶端包爲基準
注意事項¶
- 語音輸入功能依賴瀏覽器的
SpeechRecognition接口,不支持該接口的瀏覽器將禁用麥克風按鈕。 - 自定義 CSS 作用於整個頁面,編寫時需注意選擇器範圍,避免覆蓋 Harness 原有的佈局結構。
- 插件卸載命令爲:
dsh plugin --profile web remove dsh-ui-enhance。
結語¶
Dsh UI Enhance 是一個針對 DeepSeek Harness Web 界面的實用補丁,通過語音輸入、工具摺疊和 CSS 定製,提升了本地開發與調試的體驗。更多細節和源碼可參考項目主頁。