前言¶
DeepSeek Harness（DSH）裏不少操作依賴鍵盤快捷鍵。默認組合未必符合個人習慣，而宿主本身未必提供統一的「列出全部綁定、對照默認值、一鍵改鍵」入口。若只靠改配置或猜鍵位，容易與已有命令衝突，或在 Web 與桌面端行爲不一致。
下面介紹社區插件 dsh-shortcut-editor（維護者 sezhiyanhua）：在 Settings → 快捷鍵 / Keyboard shortcuts 增加一頁，枚舉通過宿主 shortcuts 服務註冊的命令，對照默認與當前綁定，錄製新組合並支持按項或全部還原。插件分類爲客戶端，當前 GitHub 星標爲 0（以目錄頁爲準）。
這是什麼¶
dsh-shortcut-editor 是一個 DSH 客戶端插件（package.json 中 dsh.client.platform 爲 web，版本 1.0.0，許可證 MIT）。它在設置中掛載「快捷鍵」頁，讀寫與主程序鍵位路由相同的 shortcuts 存儲（catalog、config、edit、registry），因此修改後一般無需重啓進程即可生效。
核心功能¶
README 中列出的能力如下，均已覈實：
- 並列對照：每個已註冊命令同時顯示 default 與 current 綁定。
- 錄製改鍵：點 修改 (Edit) 後按鍵錄入；
Esc取消。錄製期間按鍵不會進入宿主自身的快捷鍵處理邏輯。 - 狀態提示：
已修改（自定義）、衝突（與其他命令衝突）、不可用（系統/瀏覽器保留或當前平臺不支持）。 - 還原：還原 (Restore) 恢復單項默認；全部還原默認 (Restore all defaults) 清空全部自定義。
- 固定鍵位：只讀列出不可重綁的固定序列。
- 搜索：按標籤、命令 id、鍵帽與別名過濾。
- 中英雙語：隨應用語言切換。
安裝與啓用¶
官方 README 給出的安裝方式爲：
dsh plugin --profile <profile> add <this-repo-or-package>
也可在 SkillHub 插件目錄 一鍵安裝。安裝後重啓或刷新 Web GUI，打開 Settings → 快捷鍵 / Keyboard shortcuts 即可使用。
卸載：
dsh plugin --profile <profile> remove <package-name>
說明：若在卸載前未還原默認，自定義綁定可能仍留在 localStorage 中（見下文存儲位置）。
典型用法¶
經過上面的安裝與刷新，按下面步驟操作即可復現 README 中的流程：
- 打開 Settings → 快捷鍵，瀏覽全部已註冊命令及默認/當前綁定。
- 對需要調整的項點 修改，按下目標組合；若組合不合法，頁面會就地說明，不會寫入。
- 用搜索框縮小列表範圍（標籤、id、鍵位等）。
- 單項 還原 或 全部還原默認 恢復出廠鍵位。
存儲與生效（How it works）：
- Web 端綁定保存在
localStorage的dsh.keybindings.v1，按runtime:platformprofile 區分。 - 桌面客戶端通過
window.dshDesktop.shortcuts持久化。 - 僅當宿主接受的組合纔會保存：至少含一個修飾鍵、非系統/瀏覽器保留組合、且鍵碼受支持。
平臺差異：
- Web：插件在錄製時自行監聽
keydown（宿主在 Web 上不做原生按鍵攔截），錄製結束會釋放監聽。 - 桌面：宿主會調用
recording(true/false)暫停自身快捷鍵攔截。
適用場景與注意¶
適合誰：經常在 DSH Web GUI 或桌面客戶端裏用快捷鍵、且希望可視化改鍵、避免盲猜配置的智能體開發者或日常用戶。
限制（README）：
- 列表只包含經
shortcuts服務註冊的命令；未註冊命令不會出現。 - 錄製與衝突檢測依賴當前宿主與平臺能力，部分組合會被標爲不可用。
安全與許可：插件隨當前 DSH 進程的客戶端上下文運行；安裝前建議在 GitHub 閱讀源碼與 MIT 許可證。DSH 生態奉行「一切皆插件」；SkillHub 爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-shortcut-editor 把快捷鍵管理收斂到設置頁：對照默認、錄製重綁、衝突與不可用提示、單項或全部還原，並與宿主鍵位存儲一致。需要安裝或 issue 時，可參考目錄頁與倉庫：
