dsh-keyboard-manager：DeepSeek Harness Web UI 鍵盤快捷鍵

DeepSeek Harness (DSH) Web UI 側重於插件化架構，但在日常使用中，開發者仍需頻繁通過鼠標點擊來切換側邊欄或打開設置。dsh-keyboard-manager 通過監聽鍵盤事件，將常用的 UI 操作映射爲快捷鍵，減少鼠標交互頻率。

插件概況¶

插件提供了三個默認快捷鍵，通過一個監聽器統一處理，並根據頁面狀態路由到對應的 UI 元素。

Ctrl+Q 切換左側邊欄
直接調用佈局服務的切換方法，控制內置左側邊欄的顯示與隱藏。
Ctrl+E 切換右側邊欄
智能路由邏輯：
- 若加載了 dsh-better-sidebar 插件，點擊右側面板的切換按鈕。
- 若未加載該插件，則切換原生對話詳情面板。
- 需要活躍的會話才能觸發。
Ctrl+S 打開/關閉設置
- 點擊設置觸發器按鈕以打開模態框。
- 在 dsh-better-sidebar 編輯器聚焦時，該快捷鍵會透傳給編輯器，用於保存操作。
- 關閉設置模態框需按 Escape 鍵。

使用官方 CLI 命令添加插件到當前 Web 配置文件中。

dsh plugin --profile web add github:Aafff623/dsh-keyboard-manager

安裝完成後，建議硬刷新瀏覽器頁面（Ctrl+Shift+R）以確保插件加載生效。

插件支持通過配置文件覆蓋默認的按鍵代碼。配置文件路徑爲 ~/.dsh/profiles/web/cordis.patch.yml。

# ~/.dsh/profiles/web/cordis.patch.yml
- id: dsh-keyboard-manager
  config:
    sidebar: KeyQ
    rightPanel: KeyE
    settings: KeyS

配置項驗證規則僅允許 A-Z 字母數字組合，重複或無效的代碼將回退到默認值。修改配置後需重啓 DSH 並刷新頁面。

按鍵規則：僅支持嚴格和絃，即僅使用 Ctrl 鍵，不混用 Cmd、Shift 或 Alt 修飾鍵。
事件隔離：插件不干擾頁面原生事件處理。對於 IME 組合輸入、按鍵自動重複以及已被其他監聽器消費的事件，插件會保持靜默，避免衝突。
依賴要求：需要 @deepseek-ai/cordis 版本 ^4.0.2 和 DSH Web UI 環境。
可選依賴：dsh-better-sidebar 是可選的。如果未安裝，Ctrl+E 會自動回退到原生對話詳情面板；Ctrl+S 在編輯器中的保存行爲僅在該插件加載時生效。
Headless 配置：在 Headless 配置下無法獲取插件配置，插件將直接使用默認按鍵值。

該插件遵循 DSH 的插件化理念，與 DeepSeek 官方無直接從屬關係。源碼與文檔位於：