前言¶
在 DSH Web 中同時維護多個會話時,切換會話、聚焦搜索框、打開模型選擇、歸檔或重命名會話,通常需要點擊側邊欄。當聊天輸入框裏還有未發送內容時,這種操作會打斷輸入節奏。
dsh-session-hotkeys 針對這個場景,把常用會話操作映射到鍵盤快捷鍵上,讓用戶在打字狀態下也能切換會話。
這是什麼¶
dsh-session-hotkeys 是 YEYEYEYESHIFU 維護的 DSH Web 會話快捷鍵插件,用於給 DeepSeek Harness Web 提供鍵盤會話管理。
它解決的主要問題是:用鍵盤在已渲染的會話列表之間切換,並減少在聊天、搜索、模型選擇和會話管理之間的鼠標操作。
它是純瀏覽器插件,無網絡請求、無服務端狀態、不收集數據。許可證爲 MIT。
核心功能¶
下面介紹已覈實的幾類能力。
會話切換¶
- 支持
Alt+1-9直達第 N 個會話,Alt+↑/Alt+↓循環切換;這是 Windows 默認,macOS 對應⌃⇧1-9、⌃⌥↑/⌃⌥↓。 - 聊天輸入框聚焦時也能切換會話,普通打字不會觸發。
- 所有鍵位都可以在面板中重新綁定,並提供 Windows / macOS 預設。
固定槽位¶
- 支持固定槽位(pin/jump/unpin)與跳轉固定槽位。
會話管理與聚焦¶
- 支持新建會話、歸檔當前會話、打開歸檔列表、重命名當前會話。
- 支持導航模式、聚焦搜索框、聚焦模型選擇、聚焦回聊天輸入框,以及替代忙時發送方式。
默認鍵位¶
以下只列出已覈實資料中明確給出的鍵位。
| 動作 | 鍵位 |
|---|---|
| 切換到第 N 個會話(Windows) | Alt+1-9 |
| 上一個 / 下一個會話(Windows) | Alt+↑ / Alt+↓ |
| 切換到第 N 個會話(macOS) | ⌃⇧1-9 |
| 上一個 / 下一個會話(macOS) | ⌃⌥↑ / ⌃⌥↓ |
| 新建會話 | Alt+N |
| 歸檔當前會話 | Alt+Shift+A |
| 打開已歸檔列表 | Alt+Shift+U |
| 打開面板 | Alt+P |
其他動作的鍵位均可在面板中重新綁定;Windows / macOS 預設已在資料中提及,但已覈實資料未逐項列出所有默認鍵位。
安裝與啓用¶
使用 dsh plugin¶
先執行安裝命令,再重啓 DSH Web:
dsh plugin --profile web add "dsh-session-hotkeys"
經過上面的步驟後,重啓 DSH Web 即可啓用。
舊版 CLI¶
如果舊版 CLI 中沒有 dsh plugin 子命令,按下面步驟處理:
1、在 profile 的 package.json 中,將 dsh-session-hotkeys 加入 dependencies 與 dsh.profile.bundles。
2、在 profile 目錄中運行:
pnpm install
3、重啓 DSH。
典型用法¶
安裝後重啓 DSH Web,即可按默認鍵位使用:
1、確保側邊欄已展開,因爲切換依賴側邊欄展開狀態,顯示順序讀取已渲染的側邊欄行。
2、按 Alt+1-9 切換到第 N 個會話;按 Alt+↑ / Alt+↓ 切換到上一個 / 下一個會話。
3、macOS 上使用 ⌃⇧1-9 切換到第 N 個會話;使用 ⌃⌥↑ / ⌃⌥↓ 切換到上一個 / 下一個會話。
4、按 Alt+N 新建會話,按 Alt+Shift+A 歸檔當前會話,按 Alt+Shift+U 打開已歸檔列表。
5、按 Alt+P 打開面板,在按鍵頁重新錄製鍵位。
改鍵支持字母、反引號、F1-F12 與數字 1-9;使用小鍵盤數字時,需要開啓 NumLock。
開發自檢¶
如需運行開發自檢,先克隆倉庫,再運行自檢命令:
git clone https://github.com/YEYEYEYESHIFU/dsh-session-hotkeys.git
cd dsh-session-hotkeys
npm run verify
適用場景與注意¶
- 適合在 DSH Web 中維護多個會話、希望減少鼠標操作的使用者。
- 插件以當前 DSH 進程權限運行;安裝前應檢查源碼、許可證和權限聲明。
package.json中聲明的權限包括:ui:sidebar、ui:session、browser:keyboard、dom:read、storage:localstorage。 - 已在
@deepseek-ai/dsh@0.1.1-rc.2的 DSH Web 上測試,最後驗證時間爲 2026-08-23。package.json版本爲1.6.0,compatibility中dshVersions爲0.1.1-rc.2。 - 會話順序、搜索框和模型選擇定位依賴 DSH Web DOM 類名;DSH 升級後可能需要更新插件。
- 鍵位與固定關係保存在瀏覽器
localStorage;清除站點數據會重置。 - 歸檔操作有確認且從不刪除;DSH
0.1.1-rc.2無公開取消歸檔接口,恢復需宿主端操作。 - Windows 下爲避免 Chrome 吞掉
Alt+數字,輸入框內小鍵盤 Alt 碼(如Alt+0167)不可用。
結尾¶
經過上面的介紹,dsh-session-hotkeys 的價值在於:把 DSH Web 中常見的會話切換、會話管理和聚焦操作集中到鍵盤上,並在聊天輸入框聚焦時仍然可用。如果你主要在 DSH Web 中處理多個會話,可以按上面的安裝步驟啓用,並根據面板重新綁定鍵位。
GitHub:https://github.com/YEYEYEYESHIFU/dsh-session-hotkeys
目錄頁:已覈實資料中未提供可用 URL。