前言¶
DeepSeek Harness (DSH) 的消息輸入框在移動端環境下受限於軟鍵盤,Shift+Enter 組合鍵難以觸發,導致換行功能失效。DSH Mobile Keys 插件旨在解決這一交互斷層,通過自動檢測設備環境並切換鍵位組合,確保在不同設備上均能順暢輸入。
插件定位¶
DSH 移動端熱鍵模式插件,由 liujuntao123 維護,開源協議爲 MIT。
核心功能¶
- 自動檢測與切換:插件會自動檢測當前設備環境。在移動端模式下,發送鍵位切換爲
Ctrl+Enter,換行鍵位爲Enter;桌面端保持默認的Enter發送 /Shift+Enter換行。 - 設置面板開關:DSH 設置 -> 通用 -> 「移動端熱鍵模式」開關,可實時顯示設備檢測狀態與當前生效的鍵位。
- 命令行交互:在消息輸入框輸入
/mobilekeys,即可選擇「自動檢測」、「開啓」或「關閉」模式。 - 控制台 API:提供完整的 JavaScript 接口,包括獲取狀態、設置模式和獲取鍵位綁定。
- 零後端與原生兼容:配置保存在瀏覽器
localStorage,不依賴後端服務;在 IME 合成、彈出層等場景下不影響原生行爲。
安裝與啓用¶
確保環境已安裝 pnpm。通過官方命令安裝:
dsh plugin --profile web add git+https://github.com/liujuntao123/dsh-mobile-keys.git
安裝完成後,必須重啓 dsh web 並在瀏覽器中強制刷新頁面(Ctrl+F5)以確保插件生效。
若需手動安裝,需執行以下步驟:
1. 在 web profile 目錄下執行 pnpm add git+https://github.com/liujuntao123/dsh-mobile-keys.git。
2. 將 "dsh-mobile-keys" 字符串添加進 package.json 的 dsh.profile.bundles 數組中。
使用方法¶
- 命令切換:在 DSH 的消息輸入框中輸入
/mobilekeys,根據提示選擇模式。 - 控制台調試:
// 查看當前狀態
window.__dshMobileKeys.getStatus()
// 設置模式('auto' | 'on' | 'off')
window.__dshMobileKeys.setMode('on')
// 獲取當前鍵位映射
window.__dshMobileKeys.getBindings()
注意事項¶
- 插件依賴
pnpm進行包管理。 - 安裝後必須重啓 DSH 進程並刷新瀏覽器,否則插件不會生效。
- 手動安裝時需特別注意
dsh.profile.bundles數組的配置。
結語¶
該插件通過輕量級的本地邏輯解決跨設備輸入差異,適合需要在多種設備上保持一致交互體驗的 DSH 用戶。