dsh-command-palette
中文 | English
适用于标准版 DeepSeek Harness（DSH）的键盘优先命令面板。连续快速按两次 Shift，即可搜索和打开会话、工作区、设置页面、已安装功能或可复用的自定义指令。
安装
dsh plugin --profile web add dsh-command-palette
安装后重启当前 DSH Web 进程，然后打开 设置 → 命令面板 管理自定义指令。
功能
- 双 Shift 唤起——只监听当前获得焦点的 DSH Web 窗口，不注册系统级全局快捷键
- 最近会话——默认展示最近更新的六个有效会话
- 会话搜索——按标题、工作目录、Agent 预设或会话 ID 搜索
- 工作区切换——从命令面板直接在目标工作区启动会话
- 设置页跳转——自动读取 DSH 已注册的设置菜单，搜索后直接打开对应设置页面
- 自定义指令——保存常用 Prompt，可选择每次新建会话或复用专属会话
- 工作区绑定——为自定义指令的新会话指定目标工作区
- 扩展 Provider——其他 Client 插件可以注册自己的命令或触发面板
使用
- 在 DSH Web 窗口内连续快速按两次 Shift。
- 输入关键词筛选命令。
- 使用
↑ / ↓ 选择，按 Enter 执行，按 Esc 关闭。
- 在 设置 → 命令面板 中添加、编辑或删除自定义指令。
插件会在每次打开面板时读取当前已注册的设置页面，因此其他插件新增的设置菜单也会自动出现在“设置”分组中。
自定义指令启用“复用专属会话”后，首次执行会创建会话并保存绑定；后续执行继续向同一会话发送内容。如果绑定会话已经归档或不可用，插件会自动创建新会话。
标准 DSH 与扩展接口
本包不依赖 Electron、DSH Desktop preload 或任何 window.dshDesktopCommandPalette 全局对象。会话、工作区、设置和 UI 均通过标准 DSH Client 服务实现。
插件在 Client Context 中提供 commandPalette 服务，后续增强插件可以注册附加命令：
exports.inject = ['commandPalette']
exports.apply = (ctx) => {
ctx.inject(['commandPalette'], (scope) => {
scope.effect(() => scope.commandPalette.registerProvider({
id: 'my-plugin',
collect: () => [{
id: 'open-dashboard',
group: 'features',
icon: '⌘',
title: '打开控制台',
subtitle: '由扩展插件提供',
keywords: ['dashboard'],
run: () => openDashboard()
}]
}))
})
}
服务接口：
| 方法 | 说明 |
|---|
registerProvider(provider) | 注册命令 Provider，返回卸载函数 |
collect(context?) | 收集当前所有扩展命令 |
open() | 打开命令面板 |
close() | 关闭命令面板 |
toggle() | 切换命令面板 |
isOpen() | 返回当前打开状态 |
subscribe(listener) | 监听打开状态或 Provider 变化，接收 { open, revision, reason } 快照 |
Provider ID 必须唯一。命令至少需要 id、title 和 run()；最终命令 ID 会自动加上 Provider 前缀。
动态 Provider 可以额外实现 subscribe(invalidate)。当外部状态变化时调用 invalidate()，命令面板会重新收集命令；subscribe 返回的卸载函数会在 Provider 注销时自动执行：
{
id: 'dynamic-plugin',
collect: () => buildCommands(currentState),
subscribe: (invalidate) => externalStore.subscribe(() => invalidate())
}
Desktop 原生浏览器标签、Electron IPC 和原生视图协调不属于本包，后续可以由独立 Desktop 增强插件通过上述接口接入。
数据存储
自定义指令通过 DSH 设置系统保存在 command-palette.commands，不单独创建数据库或读取模型凭据。
兼容性
- 标准版 DeepSeek Harness（DSH）
@deepseek-ai/dsh 0.1.1-rc.2- 标准 Web Profile
开发验证
npm test
npm run check
npm pack --dry-run
许可证
MIT
欢迎通过 Issues 反馈问题或建议。
