前言¶
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 中多层级菜单跳转繁琐的问题。对于追求操作效率的用户，这是一个实用的增强工具。
