ivanearisty/dsh-plugin-cmdk

dsh-plugin-cmdk

一个用于 DeepSeek Harness 的命令面板。按下 ⌘K（Ctrl+K），输入几个
字母，回车——新建对话、跳转到某个会话、切换模型、更改
权限、运行斜杠命令、切换主题、打开任意设置页面。

就是 ChatGPT、Slack、Linear 和 Notion 放在 ⌘K 上的那个命令栏，
为 Harness 而做。

安装

dsh plugin --profile web add dsh-plugin-cmdk

还没上 npm——在它上架之前，直接从 GitHub 安装：

dsh plugin --profile web add github:ivanearisty/dsh-plugin-cmdk

仅客户端——页面重新加载后即刻生效。

使用

| 按键 | 操作 |
|---|---|
| ⌘K / Ctrl+K | 打开命令面板 |
| ⌘⇧P、⌘/ | 同上（VS Code / Firefox 安全的别名） |
| ↑ ↓（或 Ctrl+N / Ctrl+P） | 移动 |
| ↵ | 运行，或打开子页面 |
| 在空查询时按 ⌫ | 从子页面返回 |
| Esc | 关闭 |

里面有什么

一切都是模糊匹配的，所以 swm 能找到 Switch model（切换模型）。

- 对话 — 新建对话（以及按工作区新建）、跳转到会话（显示运行
状态和时长）、重命名当前对话
- 会话 — 切换模型，对于支持推理力度的模型还有一个子页面；
更改权限；运行宿主提供的任意斜杠命令
- 视图 — 跳转到当前对话显示的任意标签页
- 外观 — 主题、语言、侧边栏
- 设置 — 打开设置，外加每个已安装设置页面的一行

在空查询时，最近使用过的命令会优先显示。

工作原理

目录在每次打开时都从 harness 的实时服务重新构建，因此它
永远不会显示过期的会话列表或过时的模型集合。其他插件添加的任何内容
——新的视图标签页、新的设置页面、新的斜杠命令——都会自动出现，
而无需本插件知晓它们。

命令面板 UI 是用 React 和 harness 自己的设计令牌手工打造的。它
刻意不依赖 cmdk 或 kbar：两者都会引入一个对话框
库，而一个命令栏不值得在启动包中承担那样的重量。
压缩后约 30 kB，gzip 后约 9 kB。

权限与数据

仅读取和驱动页面内的 harness 服务（会话、工作区、主题、
语言环境、模型目录、命令）。无网络调用、无遥测，任何数据
都不会离开浏览器。 注册一个覆盖层和一个 keydown 监听器。

当 harness 将某项功能的状态设为私有时，命令面板会点击与你
相同的可访问控件（role="tab"、aria-label），因此一个操作走的
路径与鼠标完全一致。

可选配套插件

安装 dsh-session-search
后，会出现一行 Search messages…（搜索消息…），打开对每个
对话的全文搜索。在运行时检测；并非必需。

设置

该插件注册了一个 dsh-plugin-cmdk 设置命名空间，因此它会像
任何其他已安装插件一样，作为一张卡片出现在设置 → 插件下，其
配置段位于 settings.yaml 中：

dsh-plugin-cmdk:
aliasChords: true      # 保持 Cmd+Shift+P 和 Cmd+/ 别名绑定
extraChords: []        # 额外的 KeyboardEvent.code 组合键，例如 ["Shift+KeyP"]

兼容性

- DeepSeek Harness 0.1.x（基于 0.1.1-rc.2 开发），web 配置。
- Node ^22.19 || >=24。
- Harness 包是可选的 peer 依赖，从宿主安装中解析。

已知限制

- 本版本中组合键是固定的（⌘K、⌘⇧P、⌘/），尚不支持重新绑定。
- Firefox 将 ⌘⇧P 保留用于隐私窗口；正因如此，⌘K 是主要组合键，而 ⌘/ 是始终安全的备用方案。
- 模型和斜杠命令页面需要活动会话；在空白会话中，这些行会正确地不显示。

许可证

MIT