DeepSeek Harness plugin

dsh-command-palette

A searchable command palette for DeepSeek Harness and its plugins

Jump to install

Source facts

Repository
hajimixiaojie/dsh-command-palette
Latest update
Aug 15, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/hajimixiaojie/dsh-command-palette
Plugin: dsh-command-palette
Author: hajimixiaojie

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-command-palette

> 给 DeepSeek Harness(DSH)加一个「命令面板」: > 按一下 Ctrl+Shift+K,输入关键词,回车——就能完成各种操作,不用到处找按钮。

如果你用过 VS Code 的 Ctrl+Shift+P,就是那个感觉。

---

产品目标

DSH 的界面以图形化为主,但日常高频操作(新建/切换会话、切换 workspace、开关视图、执行命令、调用 skill)其实都可以不碰鼠标完成。本插件的目标是在保留图形化界面的同时实现「去光标化」:

  • 纯键盘完成所有日常操作:会话 / workspace / 视图 / 命令 / skill 的查找与执行都走一个面板,↑↓ 选择、Enter 执行、Esc 退出,手不用离开键盘;
  • 统一的键盘入口:无论操作藏在哪个菜单/侧栏/插件里,都收敛到这一个入口,不用记入口在哪、也不用逐层点开;
  • 鼠标只是可选:需要时仍然可以点击面板按钮或列表项,但没有任何日常操作*必须*用鼠标。

命令面板就是这一切的入口:一个快捷键(或按钮)唤起,打字即搜,回车即达。

---

安装

第一步:确认你已经装好 DSH

  • 已经装好 DSH 0.1.0-rc.6,并且能正常打开它的 Web 界面(Node.js ≥ 22)。
  • 还没装好?先按 DSH 官方文档安装。这一步通常由维护 DSH 环境的人完成,普通使用者可以直接问他们要一个已装好的环境。

第二步:安装插件(复制一条命令)

在终端里,复制粘贴下面这一行,按回车:

dsh plugin --profile web add npm:@dsh-community/dsh-command-palette

这一行命令在做什么:

  • dsh plugin → 让 DSH 管理插件
  • --profile web → 装到「网页版」配置里
  • add npm:@dsh-community/dsh-command-palette → 从 npm(一个软件商店)下载并安装本插件

看到什么算成功: 屏幕开始滚动一些文字,最后停下来,回到可以输入命令的状态(通常看到 Done 或类似字样)。整个过程一般不超过 1 分钟。

装好后重新打开(或刷新)DSH 网页:按 Ctrl+Shift+K 能弹出面板、输入框左侧出现面板按钮,就说明装好了。想逐项完整验收,照着 [docs/manual-inspection.md](./docs/manual-inspection.md) 勾一遍即可(约 30 分钟,不需要编程)。

没有发布 npm 包?想先在本机测试?

① 先在插件源码目录(有 package.json 的文件夹)打开终端,运行 npm pack,会生成一个 dsh-community-dsh-command-palette-0.1.0-alpha.0.tgz 文件;

② 然后用这条命令安装(把路径换成你的文件位置):

dsh plugin --profile web add "$PWD\dsh-community-dsh-command-palette-0.1.0-alpha.0.tgz"

(在插件源码目录里运行时,$PWD 会自动替换成当前目录路径;升级包时先删掉旧的 .tgz 再重新打包。)

> ⚠️ 如果粘贴后报 ENOENT: no such file or directory,且报错里的路径把 profile 目录和你的文件路径拼在了一起,说明从聊天软件/网页复制命令时混入了不可见字符。把命令手动敲一遍(或先粘到记事本再复制)即可解决。

卸载

在终端里复制粘贴这一行,按回车:

dsh plugin --profile web remove @dsh-community/dsh-command-palette

卸载后,按钮、快捷键和面板里的命令会自动消失,不留残留。

---

它能帮我做什么?

  • 一个入口找所有操作:新建会话、切换会话、切换 workspace、打开详情面板……不用记入口在哪。
  • 只显示现在能用的命令:用不了的命令会变灰,并直接告诉你为什么(例如「需要两个以上会话」)。
  • 插件的命令也会自动出现:其他 DSH 插件注册的命令,面板会自动收录,统一管理。
  • 键盘全程可操作 选择,Enter 执行,Esc 关闭,手不用离开键盘。
  • 执行结果看得见:成功了有提示,失败了告诉你原因、可以一键重试,长时间任务可以取消。

怎么打开?

有三种方式,任选其一:

方式说明
快捷键Ctrl+Shift+K,再按一次关闭(可在设置中修改)
按钮输入框左侧有一个命令面板按钮,点它(手机上用这个)
设置里改了快捷键以你自己的设置为准,见下文「设置」

> 💡 光标即使在输入框里,Ctrl+Shift+K 也能直接打开/关闭面板;普通打字(如直接敲字母)绝不会被抢占。

打开之后怎么用?

┌──────────────────────────────────────┐
│ > 输入关键词搜索命令                  │
├──────────────────────────────────────┤
│  Recent(最近用过)                   │
│    新建会话                           │
│  Session                              │
│    下一个会话                         │
│    打开详情面板        (灰色=不可用) │
└──────────────────────────────────────┘
按键作用
/ 上下选择
Enter执行选中的命令
Esc关闭面板
直接打字搜索命令(名称、关键词、分类都能搜,中文英文都行)

什么都不输入时,列表会按分类分组,最近用过的命令排在最上面

自带哪些命令?

命令作用什么时候是灰色的
新建会话连接最近的 workspace 并开一个新会话没有可用 workspace 时
下一个会话在会话列表里循环切换只有不到两个会话时
下一个 workspace切换到下一个 workspace没有可用 workspace 时
打开详情面板展开当前会话的详情侧栏
设置打开 DSH 设置面板
聚焦输入框把光标移到聊天输入框没有活动会话时

主机命令与 Skills

DSH 中注册的斜杠命令(slash 命令)和当前会话项目里用户可调用的 skill 会直接列在面板里(分类「Commands」/「Skills」),选中回车即可执行,不用手动敲 /

  • 不带参数的命令:选中 → 回车直接执行;
  • 带参数的命令(宿主声明了 input hint)与任意 skill:选中 → 回车进入「参数输入步」——输入框变为参数输入,回车以 /名字 参数 执行,Esc 返回命令列表。

另外,其他插件注册的命令会自动出现在面板里,不需要任何设置。

> 已知限制:由 Web 界面客户端注册的弹窗选择式命令(如 /model/mcp)没有公开的列举 API,暂不会出现在面板里;这类命令仍可从输入框直接输入使用。

设置(可选)

配置保存在 DSH 的设置文件 ~/.dsh/settings.yaml 中(也可在 DSH 设置界面找到 command-palette 一节)。直接编辑文件,加一段:

command-palette:
  shortcut:
    open: ctrl+shift+k   # 打开面板的快捷键
    enabled: true            # 全局快捷键总开关;关掉后仍能用按钮打开面板

保存后立即生效,不用重启。两个选项:

设置项默认值说明
shortcut.openctrl+shift+k打开面板的快捷键。写法:修饰键+键位,如 ctrl+shift+palt+kmod 表示 Windows/Linux 上的 Ctrl、macOS 上的 Cmd。默认值的选择理由:避开浏览器自带的 Ctrl+K 搜索键,也避开被输入法在系统层截获的 Ctrl+Space / Ctrl+Shift+Space(文本框聚焦时页面根本收不到这两组键,配了也无效)
shortcut.enabledtrue全局快捷键总开关。关掉后仍能用按钮打开面板
  • 填了不合法的快捷键会被拒绝并提示原因,原来的设置不受影响。
  • 如果新快捷键和浏览器/面板自带按键冲突(比如 Ctrl+KCtrl+Tab),面板会给出提示。

常见问题

Q:命令是灰的,点不了? A:灰色的命令旁边写了原因(例如「需要两个以上会话」)。满足条件后它就会恢复可用。

Q:按快捷键没反应? A:两种可能:① 快捷键被浏览器或其他插件占用;② 配置了被输入法截获的组合(Ctrl+SpaceCtrl+Shift+Space 在文本框聚焦时会被输入法在系统层截获,页面根本收不到事件,这不是插件能修复的)。去 ~/.dsh/settings.yamlshortcut.open 换成别的组合(如默认的 ctrl+shift+k),或者用输入框左侧的按钮。

Q:执行失败了怎么办? A:面板不会关,会显示失败原因和一个「重试」按钮,点重试即可。

Q:命令跑很久? A:长时间任务会显示「正在运行」,不会卡住界面;不想等了可以点「取消」,命令会被真正取消(不是假装关掉)。

Q:手机上能用吗? A:可以。屏幕较窄时面板会变成底部抽屉样式,按钮也会加大,方便手指点按。

Q:它会把命令列表发给 AI 模型吗? A:不会。命令面板只为人服务,不占用模型的上下文额度,也不会把命令伪装成模型工具。

---

深入阅读

  • 📖 设计与开发文档:[PROJECT_GUIDE.md](./PROJECT_GUIDE.md)
  • 🔌 给自己的插件贡献命令:[docs/contributing-commands.md](./docs/contributing-commands.md)
  • ✅ 人工检查手册(装机后逐项验收):[docs/manual-inspection.md](./docs/manual-inspection.md)
  • 🛠 开发者:npm installnpm test / npm run typecheck / npm run build

许可证

MIT