前言¶
DeepSeek Harness 的插件生態旨在通過擴展功能來提升開發與交互效率。在使用過程中，頻繁切換視圖、管理會話、切換模型或修改權限往往需要多次點擊菜單，操作路徑較長。dsh-plugin-cmdk 提供了一個全局快捷鍵入口，將上述操作整合到一個可模糊搜索的命令面板中，減少鼠標交互，提升操作流水的連貫性。
插件介紹¶
dsh-plugin-cmdk 是 DeepSeek Harness 的官方命令面板插件。它通過 ⌘K（Mac）或 Ctrl+K（Windows/Linux）喚起一個覆蓋層，利用模糊搜索快速定位並執行功能。該插件由用戶 ivanearisty 維護，遵循 MIT 許可證。
插件通過讀取 Harness 的實時服務來構建目錄，確保顯示的會話列表、模型選項和設置頁面始終與當前狀態同步。它完全在瀏覽器本地運行，不涉及網絡請求和遙測數據。
核心功能¶
該插件提供了以下能力：
-
會話管理
- 新建聊天（支持按工作區分組）。
- 跳轉到指定會話（顯示運行狀態與會話年齡）。
- 重命名當前聊天。
-
會話控制
- 切換模型及推理難度（如果模型支持）。
- 修改權限設置。
- 運行斜槓命令。
-
視圖與外觀
- 跳轉至當前對話顯示的任意標籤頁。
- 切換主題、語言和側邊欄配置。
-
設置與搜索
- 快速打開設置頁面。
- 全文搜索（需配合
dsh-session-search插件）。
安裝與啓用¶
該插件暫未發佈至 npm，需直接從 GitHub 安裝。
dsh plugin --profile web add github:ivanearisty/dsh-plugin-cmdk
安裝後，頁面刷新即可生效（客戶端插件）。
使用方式¶
打開命令面板後，支持以下快捷鍵操作：
| 快捷鍵 | 功能 |
|---|---|
⌘K / Ctrl+K |
打開命令面板 |
⌘⇧P / ⌘/ |
打開命令面板（VS Code / Firefox 安全別名） |
↑ ↓ 或 Ctrl+N / Ctrl+P |
移動選中項 |
↵ |
執行選中操作或打開子頁面 |
⌫（查詢爲空時） |
返回上一級 |
Esc |
關閉面板 |
技術細節與限制¶
- 性能與依賴：命令面板 UI 使用原生 React 手寫，不依賴
cmdk或kbar等重型庫，體積約爲 30 kB（壓縮）或 9 kB（Gzip）。 - 數據安全：僅讀取和驅動 Harness 的頁面內服務（會話、工作區、主題等），不進行網絡調用，不發送遙測數據。
- 目錄重建：每次打開面板時，目錄會從 Harness 的實時服務重建，因此新添加的視圖、設置頁或斜槓命令會自動出現。
- 快捷鍵限制：快捷鍵組合（
⌘K、⌘⇧P、⌘/）在當前版本中固定，暫不支持自定義重綁定。 - 瀏覽器兼容性：Firefox 瀏覽器會保留
⌘⇧P用於開啓隱私窗口，因此該插件將⌘K設爲主鍵，⌘/設爲通用回退鍵。
配置¶
插件在 settings.yaml 中註冊了 dsh-plugin-cmdk 配置項。默認情況下，別名快捷鍵保持綁定：
dsh-plugin-cmdk:
aliasChords: true # 保持 Cmd+Shift+P 和 Cmd+/ 的別名綁定
extraChords: [] # 可在此處添加額外的 KeyboardEvent.code 組合，例如 ["Shift+KeyP"]
適用場景¶
- 需要在 DeepSeek Harness Web 客戶端中頻繁切換模型或查看不同會話的用戶。
- 希望通過鍵盤快捷鍵減少鼠標點擊的開發者。
- 關注隱私，希望插件僅在本地瀏覽器環境中運行的團隊。
總結¶
dsh-plugin-cmdk 是一個輕量級、本地化的命令面板工具，它通過統一的快捷鍵入口解決了 DeepSeek Harness 中多層級菜單跳轉繁瑣的問題。對於追求操作效率的用戶，這是一個實用的增強工具。
