前言¶
DSH 的插件生態強調「一切皆插件」。在實際使用 DeepSeek Harness WebUI 時，新建會話、切換視圖、複製上下文、調整模型與權限等操作常分散在界面菜單中。對需要頻繁切換會話、模型和權限的開發者來說，這些操作如果都依賴鼠標，會打斷輸入節奏。
dsh-shortcuts 是爲 DeepSeek Harness 的 WebUI 提供的一套可完全自定義鍵盤快捷鍵系統。它把常用功能映射到鍵盤，並允許用戶自行綁定、清除和禁用快捷鍵。下面介紹它的能力、安裝方式和需要注意的事項。
這是什麼¶
dsh-shortcuts 由 Ricketts-Guo 維護，許可證爲 MIT。它定位爲 DSH 的鍵盤快捷鍵插件，主要解決 WebUI 中常用操作依賴鼠標和菜單的問題。
該插件以瀏覽器端爲主，不發起網絡請求、不觸碰業務數據；權限切換通過宿主側通道直寫。它支持 WebUI 會話級動態插件與 Desktop 宿主級靜態插件兩種形態。
核心功能¶
已覈實的功能點包括：
- 34 個預置功能，6 個分組：會話 / 視圖 / 剪貼板 / 模型 / 權限 / 系統。
- 任意功能都可錄製任意組合鍵、清除、禁用，並做衝突自動檢測。
- 快捷鍵速查表（⌘/）可查看全部綁定，並打開內置診斷面板。
- ⇧Tab 無留痕權限切換：只讀 / 工作區寫入 / 完全訪問。
- 支持 WebUI 會話級動態插件與 Desktop 宿主級靜態插件。
- 瀏覽器端爲主，無網絡請求、不觸碰業務數據；權限切換經宿主側路由直寫。
這些功能圍繞 WebUI 的日常操作展開：快捷鍵綁定可調整，權限切換爲無留痕操作，配置保存在本地瀏覽器環境。
安裝與啓用¶
先做一鍵安裝，在終端執行：
curl -fsSL https://raw.githubusercontent.com/Ricketts-Guo/dsh-shortcuts/main/install.sh | bash
這一步完成後，需要完全退出並重新打開 DeepSeek Harness，讓插件加載。
更新時重新運行同一安裝命令，再重啓 DSH 生效：
curl -fsSL https://raw.githubusercontent.com/Ricketts-Guo/dsh-shortcuts/main/install.sh | bash
也可以手動安裝。步驟如下：
1、克隆倉庫：
git clone https://github.com/Ricketts-Guo/dsh-shortcuts.git ~/dsh-shortcuts
2、編輯 ~/.dsh/profiles/web/package.json，將插件加入該 profile 的依賴配置。
3、執行安裝依賴：
cd ~/.dsh/profiles/web && pnpm install
4、重啓 DSH。
經過上面的步驟，插件會進入 DSH 的 Web profile 依賴中。
注意：1.1.0 起安裝改爲 pnpm 託管，node_modules/dsh-shortcuts 是受管副本而非符號鏈接，不應手動 ln -sfn 覆蓋。
典型用法¶
自定義快捷鍵時，進入「設置 → 快捷鍵」。點擊「錄製」後按下任意組合鍵即綁定；Backspace 清除綁定，Esc 取消錄製。
查看全部綁定和診斷面板時，按：
⌘/
進行權限切換時，按：
⇧Tab
會循環切換隻讀 / 工作區寫入 / 完全訪問。
卸載靜態安裝：
cd ~/.dsh/profiles/web && pnpm remove dsh-shortcuts
卸載動態插件可用：
cordis_stop
cordis_undefine
卸載後，自定義配置可能殘留在瀏覽器 localStorage 的鍵 dsh.shortcuts.v1 中，可在瀏覽器開發者工具中刪除。
開發或修改插件後，可以運行：
npm test
或：
npm run check
測試需要本機裝有 DSH；npm test 通過 host node_modules 解析 react。
適用場景與注意¶
適合頻繁在 DeepSeek Harness WebUI 中切換會話、視圖、模型、權限，並希望減少鼠標操作的開發者。對需要在不同權限級別之間反覆切換的工作流尤其有用。
使用前需要注意：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。項目許可證爲 MIT。
配置保存在瀏覽器 localStorage。權限切換經宿主側通道直調 permissionPresets；靜態版本地 HTTP 路由爲 /dsh-shortcuts-permission，僅在部署掛載權限服務時激活，DSH Web 服務應保持 loopback 綁定。
思考強度檔位取決於當前模型；權限輪換順序取決於部署配置的預設表。
該插件的 peerDependencies 包括：
react ^18.2.0
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6
會話級動態插件爲臨時加載，進程重啓後失效。
結尾¶
dsh-shortcuts 提供的是可自定義、可診斷、可本地卸載的鍵盤快捷鍵層。若主要依賴 WebUI 操作，先安裝並驗證速查表與權限切換；若需要長期修改源碼，再關注 pnpm 受管副本與測試命令。
項目倉庫：
https://github.com/Ricketts-Guo/dsh-shortcuts
