前言¶

DeepSeek Harness（简称 dsh）把模型适配、工具、会话、智能体循环和界面都做成可替换的插件，官方说法是「一切皆插件」。日常使用里，很多人会开 Web 界面：一边看会话，一边切设置、找 Slash Command、在已经装上的插件之间跳转。插件一多，这些入口就散在侧边栏、斜杠菜单和设置页里，离开键盘去点鼠标会打断节奏。

macOS 有 Spotlight，不少编辑器有 Ctrl+K / ⌘K 命令面板，思路都一样：一个输入框，把当前能做的事搜出来再执行。dsh-spotlight 就是把这件事接到 DSH 网页界面上的社区插件。它由 0xsline 维护，按 MIT 许可证开源，社区目录归在「界面增强」一类。需要说明的是，DeepSeek Harness 插件目录 是独立站点，和 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。

截至 2026 年 8 月 18 日，GitHub 仓库显示 7 星；npm 包名为 @0xsline/dsh-spotlight，当前版本是 0.0.2。本文内容以插件目录页、GitHub README / 源码和 npm 页面交叉核对后的结果为准。

这是什么¶

dsh-spotlight 是一个面向 DeepSeek Harness Web 的键盘优先全局命令面板。打开后，可以在同一个面板里搜索原生 Slash Command、最近会话、当前页面上的界面操作，以及已安装插件的设置入口，用键盘完成筛选和执行。

它不是再造一套命令系统。README 写得很明确：插件会发现并触发 DSH Web 已经提供的操作，只向原生斜杠菜单贡献一条 /spotlight 命令，不维护第二套命令注册表。实现上，它是一个独立的 Cordis Bundle，带一个轻量 Web Client；package.json 里把客户端平台声明为 web，需要装到 Web Profile 里才会生效。

核心功能¶

根据仓库 README 和客户端源码，当前能力可以分成下面几块。

1、一个全局快捷键。macOS 默认是 ⌘K，其他平台默认是 Ctrl+K。面板底部可以改快捷键，设置写在当前浏览器里，按 Origin 和 Profile 分开保存，不会落到服务端。

2、四类可搜索条目，界面上分别标成「操作」「命令」「会话」「插件」：
- 操作：从当前页面发现可点击元素，以及若干内置动作。源码里目前包含聚焦输入框、新建会话、打开插件设置、跳到会话开头、跳到会话末尾；带 aria-label / title 的按钮、链接和标签页也会被收进来。
- 命令：读取当前会话的宿主命令目录，结果以 /命令名 的形式出现。无参数命令会尝试直接执行；需要参数或执行失败时，会把 /命令名 填回输入框，交给原生斜杠流程。
- 会话：直接读宿主的 sessions 服务，按最近顺序打开已有会话。
- 插件：读取已安装插件清单，选中后跳到设置里的插件分区。

3、稳定的模糊匹配。对标题、说明和关键词做规范化后再打分，空查询会列出当前能发现的条目；输入关键字后按相关度排序。单个目录 RPC 失败只让对应类别降级，不会把整个面板打挂。

4、全键盘操作。上下方向键选择，Enter 执行，Escape 关闭；也可以直接点结果。卸载时会摘掉事件监听、样式和 DOM 节点。

5、不新增服务端数据通道，也不保存持久化的服务端状态。快捷键配置只存在当前浏览器的 localStorage 中。

安装与启用¶

社区目录页给出的安装命令是：

dsh plugin add github:0xsline/dsh-spotlight

这条命令会从 GitHub 解析插件并装到当前配置。如需可复现安装，目录页建议固定 commit 哈希，写法是：

dsh plugin add github:0xsline/dsh-spotlight#<commit>

把 <commit> 换成仓库里实际的提交哈希即可，不要用占位符直接跑。

这个插件的客户端只挂在 Web 上，仓库 README 要求装进 DSH Web Profile。更稳妥的做法是带上 --profile web。从 npm 安装：

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

从 Git 源码安装（跟 main 分支）：

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

装好后启动 Web 界面：

dsh --profile web

进入页面后按 ⌘K 或 Ctrl+K，就应该能看到命令面板。如果快捷键没有反应，先确认当前用的是 web profile，而不是 headless 或其他没有网页客户端的组合。

插件以当前 dsh 进程的权限运行，安装时可能会执行代码。装之前应查看 GitHub 仓库 的源码和 MIT 许可证，确认可以接受再安装。

典型用法¶

下面步骤来自 README，可以按同样顺序复现。

1、打开面板。用全局快捷键，或者在 DSH Web 输入框里输入 /spotlight，从斜杠菜单里选「打开 Spotlight」。

2、输入关键词过滤。例如搜会话标题、Slash Command 名称、插件名，或「新建会话」「设置」这类界面文案。中英文关键词都可以，源码里对内置动作同时写了中英文检索词。

3、用上下方向键移动高亮，Enter 执行；也可以直接点击某一条。结果右侧会看到类别标签，方便区分这是操作、命令、会话还是插件。

4、改快捷键：点面板底部的「快捷键」，按一次新的组合键即可。点「恢复默认」会清掉本地覆盖，回到平台默认的 ⌘K / Ctrl+K。

一个常见路径是：Ctrl+K 打开面板 → 输入会话名切过去 → 再打开面板输入 / 后面的命令名直接执行。需要改插件配置时，搜插件名或「打开插件设置」，会先点开设置，再切到插件分区。

适用场景与注意事项¶

比较适合这些情况：已经在用 DSH Web，会话和插件都不少，希望少碰鼠标；习惯 Slash Command，但记不住每一条的名字；需要在「当前页面上看得见的按钮」和「宿主服务里的命令 / 会话 / 插件」之间快速跳转。

使用前有几点需要知道。

第一，它依赖标准 DSH Web 部署里的 sessions、命令平面、插件清单和命令 UI 服务。这些在官方 Web 组合里是固定组成；如果自己裁过 profile，缺了其中某一项，对应类别就会空，或者面板挂不上。

第二，部分动作发现跟着当前页面的 DOM 走，选择器写在 src/spotlight/discovery.ts。宿主界面改版后，内置操作或界面条目可能失效，需要同步改选择器。这是仓库自己标出的限制，不是使用问题。

第三，快捷键存在当前浏览器，换机器、换 Origin 或清站点数据后要重新设置。它不会在服务端同步。

第四，社区目录和其他汇总列表里的安装写法可能不一致。以目录页原文和本仓库 README 为准：包名是 @0xsline/dsh-spotlight，GitHub 源是 github:0xsline/dsh-spotlight。不要从第三方列表里抄未经核对的 scope 名称。

第五，项目仍是早期版本（0.0.2），GitHub 主题标了 dsh-plugin。DeepSeek Harness 本身也还在 developer preview，核心插件和 API 会继续变。把它当提高 Web 操作效率的小工具即可，不要默认它能覆盖 TUI 或无界面运行。

小结¶

dsh-spotlight 做的事情很集中：在 DSH 网页里提供一个键盘优先的命令面板，把 Slash Command、最近会话、可见界面操作和插件设置收进同一次搜索。安装按目录页或 README 的命令执行，记得放到 web profile；用之前看一眼源码和许可证。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-spotlight/

GitHub：https://github.com/0xsline/dsh-spotlight

npm：https://www.npmjs.com/package/@0xsline/dsh-spotlight