0xsline/dsh-spotlight

DSH Spotlight

简体中文 | English

DeepSeek Harness Web 的键盘优先全局命令面板。无需离开键盘，即可在一个面板中搜索原生
Slash Command、最近会话、当前界面操作和已安装插件的设置入口。

功能

- 一个快捷键： macOS 默认 ⌘K，其他平台默认 Ctrl+K。
- 自由设置： 点击面板底部的快捷键按钮，再按下新的组合键；设置保存在当前浏览器。
- 复用原生操作： 自动发现并触发 DSH Web 已有操作，只向原生斜杠菜单贡献一条
/spotlight 命令，不维护第二套命令注册表。
- 快速搜索： 对 Slash Command、最近会话、界面操作和插件设置进行稳定的模糊匹配。
- 全键盘操作： 上下方向键选择、Enter 执行、Escape 关闭。
- 干净卸载： 插件卸载时移除事件监听、样式和 DOM 节点。

安装

将 Bundle 安装到 DSH Web Profile。通过 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/ 目录，不访问网络，也不写入仓库外部。若禁用了生命周期脚本，请安装
npm 发布包；其中已包含构建好的 lib/ 文件，安装时不会执行 prepare。

然后启动 DSH Web，按 ⌘K 或 Ctrl+K 即可使用：

dsh --profile web

使用

1. 使用全局快捷键打开 Spotlight，或在 DSH Web 输入框输入 /spotlight 从斜杠菜单打开。
2. 输入关键词筛选命令和操作。
3. 使用上下方向键与 Enter，或直接点击结果。
4. 点击底部的「快捷键」并按下新组合键，即可修改快捷键。
5. 点击「恢复默认」可还原平台默认值。

快捷键配置按当前浏览器的 Origin 和 Profile 独立保存。

工作原理

DSH Spotlight 是一个独立的 Cordis Bundle，附带轻量 Web Client。客户端在宿主的会话、
命令平面、插件清单和命令 UI 服务就绪后挂载（这些服务是每个标准 DSH Web 部署的固定组成），
然后直接从这些服务读取最近会话、Slash Command 和插件清单；同时从当前页面发现可执行元素，
并把执行交还给原生界面。单个目录 RPC 失败只降级对应类别。插件不新增服务端数据通道，
也不保存持久化的服务端状态。

src/index.ts             Loader 元数据
src/client/index.ts      Web Client 激活与卸载
src/spotlight/           Host + DOM 发现、搜索、键盘处理和界面
cordis.patch.yml         DSH Web Profile 组合配置

部分动作发现依赖当前 DSH Web 的 DOM；宿主界面结构变化时，可能需要同步更新
src/spotlight/discovery.ts 中的选择器。

开发

环境要求：Node.js ^22.19.0 || >=24.0.0、pnpm 11.7.0。

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 中测试本地代码：

pnpm run prepare
dsh plugin --profile web add "link:$(pwd)"
dsh --profile web

发布前检查包内容：

pnpm pack --dry-run --json

许可

MIT