omdsh-shortcuts：爲 DeepSeek Harness 綁定按鍵和絃

DeepSeek Harness (DSH) 採用插件化架構，當需要爲不同界面（桌面與 Web）分配快捷鍵時，現有方式往往難以統一管理。omdsh-shortcuts 解決了這一問題，它允許通過單一文檔爲 Harness 的任何功能綁定按鍵和絃，覆蓋桌面原生菜單與 Web 頁面監聽。

這是什麼¶

omdsh-shortcuts 是一個 DSH 輸入類插件，由 omdsh-plugins 維護。它將快捷鍵管理從硬編碼中解放出來，通過配置文件定義行爲，並在插件中心提供可視化的重新綁定表單。該插件採用 MIT 許可證。

核心功能¶

統一快捷鍵綁定：支持爲任何功能綁定按鍵和絃。
多端監聽：同時監聽桌面外殼原生菜單和 Web 頁面內的按鍵。
服務提供：提供 shortcut 服務，包含 register、bindings、onBindings、chordLabel 等接口。
命令執行：執行 12 個 UI 命令，包括 layout、sessions、workspaces、sessionModes。
窗口管理：支持打開新窗口。
可視化配置：在插件中心提供重新綁定表單。

安裝與啓用¶

安裝命令：官方安裝命令未在資料中明確給出。
環境要求：
- 運行環境需 Node.js 版本在 ^22.19.0 或 >=24.0.0 之間。
- 需安裝 pnpm@11.7.0。
安裝方式：通常通過 DSH 插件中心或直接從 GitHub 倉庫安裝。

典型用法¶

配置按鍵綁定¶

使用文檔配置 accelerator（桌面快捷鍵）和 webAccelerator（Web 端快捷鍵）。例如：

{
  "version": 1,
  "items": [
    {
      "id": "sidechat.open",
      "label": "Ask Here",
      "command": { "kind": "browser" },
      "accelerator": "CmdOrCtrl+L",
      "webAccelerator": "CmdOrCtrl+Alt+L"
    }
  ]
}

API 交互¶

焦點報告：前端頁面可通過 POST /api/desktop/shortcut.focus 報告自身處於焦點狀態，以便接收桌面端的按鍵事件。
菜單監聽：可使用 GET /api/desktop/menu.events 監聽菜單更新。

快捷鍵限制¶

瀏覽器端會保留 ⌘N、⌘T、⌘W、⌘Q，這些快捷鍵不可被覆蓋。若嘗試綁定這些快捷鍵，插件會在掛載時報錯，而非靜默失效。

適用場景與注意¶

適用場景：需要爲桌面應用和網頁端統一快捷鍵體驗的開發者或高級用戶。
注意：桌面與 Web 的按鍵監聽器不共享，配置需分別處理。瀏覽器保留的快捷鍵若嘗試綁定會導致插件掛載失敗，而非靜默失效。

omdsh-shortcuts 通過統一的文檔配置解決了多端快捷鍵管理的複雜性。它不僅提供了底層服務接口，還簡化了配置流程，適合需要在 DeepSeek Harness 中深度定製交互體驗的開發者。更多詳情可查看插件目錄或源碼倉庫。