前言¶
在 DeepSeek Harness（DSH）Web 里操作会话、触发斜杠命令、调整插件设置时，常见做法是鼠标点菜单或在输入框里逐字输入命令名。功能分散在界面各处，切换成本不低。
DSH 生态遵循「一切皆插件」：能力通过 Cordis bundle 安装到 profile，而不是改宿主源码。dsh-spotlight 是维护者 0xsline 发布的客户端插件，用一个全局快捷键打开统一面板，在同一处搜索并执行原生斜杠命令、最近会话、当前页面可操作项和已安装插件设置，全程可键盘完成。
这是什么¶
@0xsline/dsh-spotlight（GitHub：0xsline/dsh-spotlight）是面向 DSH Web 的命令面板插件。README 将其定位为 keyboard-first command palette for DeepSeek Harness Web。
插件不维护第二套命令注册表，而是读取 DSH Web 已有的 sessions、command-plane、plugin-inventory 等服务，并扫描当前页面可触发操作的 DOM 元素，把执行委托回这些原生入口。它向原生斜杠菜单贡献 /spotlight 命令，卸载时会清理事件监听、样式和 DOM 节点。
当前 npm 版本为 0.0.2，许可证 MIT。GitHub 仓库约 12 stars、2 forks；SkillHub 目录分类为「客户端」。
核心功能¶
下面介绍 README 中列出的能力，均可在仓库文档核对。
统一入口
- macOS 默认
⌘K，其他平台默认Ctrl+K打开面板。 - 也可在 DSH Web 输入框输入
/spotlight，从原生斜杠菜单进入。
可搜索的内容
- 原生斜杠命令。
- 最近会话。
- 当前页面可见 UI 操作。
- 已安装插件的设置项。
搜索使用确定性模糊匹配；方向键上下选择，Enter 执行，Escape 关闭，也可点击结果。
快捷键自定义
面板页脚提供 Shortcut 控件，点击后录制新的组合键；Reset 恢复平台默认。偏好保存在当前浏览器 origin 与 profile 下，不写服务端持久状态。
生命周期
插件为独立 Cordis bundle，挂载于宿主标准服务就绪之后。某类目录 RPC 失败时仅降级对应分类，不影响其他来源；卸载时移除自身资源。
安装与启用¶
先把 bundle 安装到 DSH Web profile。官方 README 提供两种方式。
从 npm 安装（发布包已包含构建产物 lib/，安装时不跑 prepare）：
dsh plugin --profile web add "@0xsline/dsh-spotlight"
从 Git 源码安装（会执行包内 prepare，在仓库本地用 TypeScript 与 tsdown 重建 lib/；若禁用了 lifecycle scripts，请改用 npm 发布包）：
dsh plugin --profile web add "github:0xsline/dsh-spotlight#main"
安装后启动 DSH Web：
dsh --profile web
按 ⌘K 或 Ctrl+K 即可打开面板。
本地开发调试时，README 建议在克隆仓库并 pnpm install 后执行：
pnpm run prepare
dsh plugin --profile web add "link:$(pwd)"
dsh --profile web
开发环境要求 Node.js ^22.19.0 || >=24.0.0、pnpm 11.7.0。
典型用法¶
- 用全局快捷键打开 Spotlight，或在 composer 输入
/spotlight并从斜杠菜单选中。 - 输入关键字过滤命令与操作。
- 方向键选择后 Enter 执行，或直接点击条目。
- 需要改快捷键时，点页脚 Shortcut 录制新组合；点 Reset 恢复默认。
面板里的条目最终仍由 DSH Web 原生服务或页面元素执行，插件本身不新增服务端数据通道。
适用场景与注意¶
适合谁
- 经常在 DSH Web 里切换会话、调用斜杠命令或改插件设置，希望减少鼠标路径的用户。
- 已按 DSH 插件方式管理 Web profile，愿意在浏览器端增加一个客户端 bundle 的开发者。
使用前请知悉
- 插件以当前
dsh进程及其 Web 客户端权限运行；安装前建议阅读 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。 - 部分发现逻辑依赖当前 DSH Web DOM；宿主 UI 变更时，可能需要更新
src/spotlight/discovery.ts中的选择器（README「How it works」有说明）。 - SkillHub（目录页）是社区插件目录，与 DeepSeek / 幻方无官方从属关系；版本与安装命令以仓库 README 为准。
小结¶
dsh-spotlight 把 DSH Web 里分散的原生能力收进一个可搜索、可键盘导航的命令面板，并复用宿主命令平面而非平行维护注册表。若你已在用 DSH Web，可按上文命令安装到 web profile，用 ⌘K / Ctrl+K 试用。
