前言¶
在 DSH Desktop Web GUI 中，常用操作往往依賴鼠標點擊。dsh-hotkey 插件爲這些操作提供了鍵盤入口，支持 VS Code 風格的快捷鍵配置，並在設置頁內提供可視化編輯器。該插件維護者爲 melt502，旨在減少鼠標交互，提升操作效率。
前置條件¶
部分快捷鍵驅動其他 DSH 插件提供的功能，使用前需安裝對應插件，否則這些綁定在設置頁將顯示爲不可用。
| 前置插件 | 提供的功能 | 解鎖的快捷鍵 |
|---|---|---|
| dsh-vision-router | 輸入框右下角的識圖模式開關按鈕 | Ctrl+Alt+V — 切換識圖模式 |
| dsh-better-sidebar | 承載終端、文件、Git、側邊對話與底部面板的右側邊欄 | Ctrl+`、Ctrl+J、Ctrl+Alt+B、Ctrl+Shift+E、Ctrl+Shift+G、Alt+E |
安裝與啓用¶
從本地目錄安裝插件：
dsh plugin --profile web add "link:<absolute path to this repo>"
安裝後重啓 DSH Desktop。配置入口位於 系統設置 → 快捷鍵。
功能¶
- 基礎配置：包含 20 個動作，默認綁定 16 個鍵位。
- 可視化編輯：在設置頁內可改鍵、禁用、單條恢復默認或全部恢復默認。
- 衝突檢測：檢測組合鍵衝突，衝突時按動作表順序確定優先級。
- 數據管理：支持 JSON 導入/導出完整鍵位表。
- 持久化：配置持久化到 DSH settings scope（命名空間
hotkey）。 - 多語言支持：跟隨 DSH 界面語言（中文 / 英文）。
- 導航增強：
- 右側邊欄鍵盤導航：
↑/↓在可見按鈕間移動，Enter模擬點擊。 - Side Chat 兩階段打開：
Alt+E先展開右側邊欄，再打開或新建對話。 - 健壯性：服務與 DOM 雙路徑，避免服務延遲註冊導致快捷鍵完全失效。
默認快捷鍵¶
| 快捷鍵 | 動作 | 說明 |
|---|---|---|
Ctrl+B |
切換左側邊欄 | 會話 / 工作區欄 |
Ctrl+` |
打開 / 聚焦終端 | 右側終端標籤 |
Ctrl+J |
切換底部面板 | 底部終端 / 面板 |
Ctrl+Alt+B |
切換右側邊欄 | 承載文件、Git、側邊對話的側邊卡片 |
Ctrl+Shift+E |
文件樹 / 編輯器 | 打開文件標籤 |
Ctrl+Shift+G |
Git 面板 | 打開源代碼管理標籤 |
Alt+E |
側邊對話 | 先展開右側邊欄，再打開對話 |
Ctrl+Alt+V |
切換識圖模式 | 點擊 dsh-vision-router 識圖按鈕（需先安裝該插件） |
Ctrl+F |
打開新的工作區 | 打開「添加工作區」選擇器 |
Ctrl+N |
新建會話 | 在當前工作區新建會話 |
Enter |
同意審批 | 僅審批卡片可見時接管 |
Esc |
拒絕審批 | 僅審批卡片可見時接管 |
Ctrl+[ |
上一個會話 | 會話列表導航 |
Ctrl+] |
下一個會話 | 會話列表導航 |
Ctrl+I |
聚焦輸入框 | 光標移至末尾 |
Ctrl+, |
打開系統設置 | DSH 設置入口 |
另有 4 個動作默認不分配鍵位：右側詳情列、子代理面板、系統終端窗口、命令菜單。Enter / Esc 只在審批卡片可見時攔截，其他情況保持 DSH 原生行爲。
運行時診斷¶
在 DSH web DevTools 控制台中可調用以下接口進行調試：
window.__DSH_HOTKEY__.effective() // 獲取當前生效的鍵位表
window.__DSH_HOTKEY__.availability() // 獲取各動作的可用性（用於設置頁顯示）
window.__DSH_HOTKEY__.probe() // 檢測服務、DOM、標籤頁、會話、面板狀態
window.__DSH_HOTKEY__.readiness() // 檢測處理器的就緒狀態
window.__DSH_HOTKEY__.debug(true) // 開啓按鍵調試日誌
測試¶
插件無額外的開發依賴，測試使用 Node.js 內置模塊。
npm test
適用場景與注意¶
- 適用場景：需要頻繁操作 DSH Desktop Web GUI 的開發者，特別是習慣使用鍵盤導航的場景。
- 注意事項：
Enter/Esc僅在審批卡片可見時攔截，否則保持 DSH 原生行爲。- 避免綁定瀏覽器或 Electron 保留的組合鍵。
- DOM 兜底機制依賴 DSH UI 的當前 DOM 結構；若 DSH 升級導致 DOM 結構變化，需重新運行測試並驗證。
- 生態背景：DSH 理念是「一切皆插件」，社區目錄與 DeepSeek / 幻方無官方從屬關係。
短結尾¶
dsh-hotkey 通過提供 VS Code 風格的鍵盤快捷鍵和可視化編輯器，降低了 DSH Desktop Web GUI 的操作門檻。更多細節與源碼可訪問 GitHub。
