聚光命令面板 0xsline/dsh-spotlight

DSH Spotlight

为 DeepSeek Harness Web 打造的键盘优先命令面板。打开一个面板，就能找到原生斜杠命令、最近会话、可见 UI 操作和已安装插件设置——全程不用离开键盘。

功能

- 一个快捷键： macOS 上是 ⌘K，其他平台是 Ctrl+K。
- 可自定义： 点击页脚的快捷键控件，然后按下新的组合键。设置保存在当前浏览器里。
- 原生操作： 自动发现并触发 DSH Web 已经提供的操作，同时向原生斜杠菜单贡献一个 /spotlight 命令，而不是再维护一套命令注册表。
- 快速搜索： 对斜杠命令、最近会话、UI 操作和插件设置做确定性模糊匹配。
- 键盘导航： 上下方向键选择，回车执行，Esc 关闭。
- 干净的生命周期： 卸载时移除自己的事件监听器、样式和 DOM 节点。

安装

把 bundle 装进你的 DSH Web 配置档。从 npm 安装：

dsh plugin --profile web add "@0xsline/dsh-spotlight"

或者从 Git 源码安装：

dsh plugin --profile web add "github:0xsline/dsh-spotlight#main"

Git 安装会运行包的 prepare 生命周期，因为生成的 lib/ 文件没有提交到仓库。它只用仓库本地的 TypeScript 和 tsdown 可执行文件，删除并重建这个包的 lib/ 目录；不访问网络，也不会写到 checkout 之外。如果生命周期脚本被禁用，请改从 npm 安装发布版：发布版已经包含构建好的 lib/ 文件，安装时不会运行 prepare。

然后启动 DSH Web，按下 ⌘K 或 Ctrl+K：

dsh --profile web

用法

1. 用全局快捷键打开 Spotlight，或者在 DSH Web 输入框里输入 /spotlight，再从斜杠菜单里选中对应条目。
2. 输入内容筛选命令和操作。
3. 用上下方向键加回车，或者直接点击结果。
4. 点击页脚的 Shortcut，录制不同的组合键。
5. 点击 Reset，恢复平台默认值。

快捷键偏好只对当前浏览器 origin 和配置档生效。

工作原理

DSH Spotlight 是独立的 Cordis bundle，带一个很小的 Web 客户端。宿主一旦具备 sessions、command-plane、plugin-inventory 和 command-UI 服务——这些在任何原版 DSH Web 部署里都是标配——客户端就挂载，然后直接从这些服务读取最近会话、斜杠命令和插件清单。它还会发现当前页面里可操作的元素，并把执行交回给这些原生元素。catalog RPC 失败只会让对应分类降级。插件不新增服务端数据通道，也不保存任何服务端持久状态。

src/index.ts Loader metadata
src/client/index.ts Web client activation and disposal
src/spotlight/ Host + DOM discovery, search, keyboard handling, and UI
cordis.patch.yml DSH Web 配置档组成

发现流程有一部分依赖当前的 DSH Web DOM，所以宿主 UI 一旦改动，可能就要更新 src/spotlight/discovery.ts 里的选择器。

开发

环境要求：Node.js ^22.19.0 || >=24.0.0，pnpm 11.7.0。
sh
git clone https://github.com/0xsline/dsh-spotlight.git
cd dsh-spotlight
pnpm install

pnpm run verify:self-contained
pnpm run typecheck
pnpm test
pnpm run build

在 DSH Web 里测试本地检出的代码： sh
pnpm run prepare
dsh plugin --profile web add "link:$(pwd)"
dsh --profile web

发布前检查包内容： sh
pnpm pack --dry-run --json

许可证

MIT