前言¶
在 DeepSeek Harness（DSH）里跑多会话、长对话时，侧边栏自带的搜索往往够用，但范围和预览方式有限：要在一堆 Session 和聊天记录里定位某句话，时常需要多次点开、来回翻。IDE 用户更习惯 Cmd/Ctrl+K 唤出居中搜索框，上面是命中列表、下面是带行号的上下文预览——这和「在路径中查找」的节奏接近。
下面介绍社区客户端插件 dsh-spotlight（维护者 mdalboni）：用居中模态搜索替换侧边栏搜索体验，同时覆盖 Session 与聊天消息，并支持实时检索与 SQLite FTS 持久化历史。插件归类为客户端，面向 Web 端 DSH（--profile web）；在 SkillHub 插件目录 可查阅条目，源码与说明见 GitHub 仓库。DSH 生态奉行「一切皆插件」；SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-spotlight 是 DSH 插件，将侧边栏搜索升级为 Apple Spotlight 与 IntelliJ/PyCharm 风格的居中搜索对话框，搜索对象包括 Sessions 与 chat messages。当前 package 版本为 1.0.2，许可证 MIT（Maxwell Dalboni）。运行要求：dsh 与 @deepseek-ai/dsh 均为 >=0.2.1-rc.3；客户端通过 cordis.patch.yml 注入，依赖 @deepseek-ai/dsh-client-ui-workspace 与 @deepseek-ai/dsh-client-ui-layout，并在 Web 端 immediately 加载。
核心功能¶
居中搜索与触发方式¶
- 点击侧边栏搜索放大镜，或按
Cmd+K/Ctrl+K，打开居中模态搜索框。 - Filter Selector 可在 Sessions、Chat messages 或两者同时（默认）之间切换。
IntelliJ「Find in Path」式布局¶
- 上方面板（搜索结果）：展示匹配的 Session 与聊天摘录，高亮查询词，并显示相对时间戳、目录标签。
- 下方面板（实时上下文预览）：以带行号的对话上下文（用户与助手轮次）展示命中位置，搜索词高亮。
键盘与快捷操作¶
↑/↓：在结果间移动。Enter或双击：打开所选 Session。- 每条结果上的快速打开按钮（
↗）。 Esc：关闭对话框。
检索与界面¶
- 即时 live search：检索当前活动 Session 收件箱；持久对话历史由 SQLite FTS 支撑。
- 移动端：全屏响应式布局、单击进入 Session、专用关闭按钮、虚拟键盘兼容、侧边栏抽屉自动收起。
- 主题：使用 DSH
--dsw-alias-*主题令牌，适配浅色与深色模式。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证；插件在当前 DSH 进程权限下运行，与任何 DSH 插件一样，只安装你信任的源。
通过 DSH 插件市场（dshmarket）¶
在 DSH Plugin Marketplace 中搜索 dsh-spotlight，点击 Install。
通过 DSH CLI¶
Web 配置档下添加插件名（与仓库 README 一致）：
dsh plugin --profile web add dsh-spotlight
仓库 README 还说明可从本地源码以 link: 方式添加；若你采用该路径，需自行 git clone 仓库并在本地执行 dsh plugin --profile web add link:./dsh-spotlight，此处不展开步骤细节。
典型用法¶
启用插件并重启或刷新 Web 客户端后，可按下面顺序操作：
- 在任意 DSH Web 界面按
Ctrl+K（macOS 为Cmd+K），或点侧边栏搜索图标。 - 输入关键词；观察上方结果列表中的 Session 与消息摘要。
- 用筛选器限定只搜 Session、只搜聊天，或保持默认的联合搜索。
- 用方向键选中条目，在下方面板核对对话上下文与高亮命中。
Enter、双击或↗打开对应 Session；Esc关闭搜索框。
维护者提供的单元测试命令（用于验证插件包，而非终端用户必做步骤）：
node --test test/index.test.js
适用场景与注意¶
适合谁：经常在 DSH 里维护多个 Session、需要在历史聊天中全文检索某配置名、报错片段或口令的开发者；习惯 IDE 式「搜索 + 预览」而非纯列表跳转的用户。
注意：
- 插件分类为客户端，安装命令使用
--profile web；其他 profile 是否适用应以你本地 DSH 文档与插件package.json中dsh.client声明为准。 - 引擎版本需满足 >=0.2.1-rc.3，过低版本可能导致注入或 UI 依赖不可用。
- 搜索范围与 FTS 索引行为以实现为准，升级 DSH 或插件后若结果异常，可对照 Issues 与仓库更新说明。
结尾¶
经过上面的步骤，你可以在 Web 端 DSH 里用统一快捷键完成 Session 与聊天内容的集中检索，并在打开 Session 前通过下方面板确认上下文。dsh-spotlight 把侧边栏搜索升级为居中、可筛选、可预览的流程，适合会话与消息都较多的日常开发。
