前言¶
用 DeepSeek Harness（DSH）的 web profile 时，侧边栏通常用来找历史会话。标题搜索可以按目录找，但如果你要定位某句话、某次工具调用或某段回复，就需要内容检索。
DSH 的理念是「一切皆插件」。dsh-session-search-toggle 就是在 DSH web 侧边栏增加一个“搜索”入口，让标题搜索和内容搜索在同一个浮层里切换，并支持按用户、回复、工具筛选内容命中。
这是什么¶
dsh-session-search-toggle 是 drscrewdriver 维护的 DSH 插件，许可证为 MIT。
它面向已安装 DeepSeek Harness 并使用 web profile 的用户，在不改官方源码、不建派生库的前提下，通过 DSH 现成的 sessionQuery 服务提供会话搜索增强。
核心功能¶
标题搜索与内容搜索¶
插件在 DSH web 侧边栏底部新增“搜索”入口。点击后会打开浮层面板，面板里可以在标题搜索和内容搜索之间切换。
标题模式按会话标题或工作目录子串做即时过滤。
内容模式复用 DSH 自带的 FTS5 全文索引，搜索会话消息正文。
内容结果按会话聚合¶
内容搜索的结果按会话聚合展示，不逐条堆消息。
每个会话一行，展示会话标题、最强命中片段和类型标签。
内容类型筛选¶
内容模式提供以下筛选：
- 全部
- 用户
- 回复
- 工具
其中“工具”筛选覆盖 tool/call 与 tool/result。
索引可用性提示¶
插件会在 Host 侧通过 search-status 探测 sessionQuery 全文索引是否开启。
如果全文索引未开启，内容模式会给出配置指引；标题模式不受影响。
设置与结果定位¶
设置页在“通用”里新增“会话搜索”配置行，支持启用开关和默认搜索模式。
搜索结果点击后，会打开对应会话，并定位到命中内容所在上下文。
安装与启用¶
安装插件¶
从 GitHub 直装稳定版：
dsh plugin --profile web add github:drscrewdriver/dsh-session-search-toggle#release-v0.1.0
如果需要使用基线或开发分支，也可以分别安装：
dsh plugin --profile web add github:drscrewdriver/dsh-session-search-toggle#master
dsh plugin --profile web add github:drscrewdriver/dsh-session-search-toggle#feat/type-filter-search
资料中给出多个可安装分支，具体选择分支应按使用场景决定。
重启 DSH web¶
运行中实例不热载 bundle 层，安装后必须重启 DSH web：
dsh web
也可以使用随包脚本：
bash ~/.dsh/profiles/web/node_modules/dsh-session-search-toggle/restart-dsh-web.sh
开启内容搜索所需的全文索引¶
DSH 官方 bundle 默认关闭全文索引，内容搜索需要覆盖 session-query-sqlite 的 path 和 openAt。
可在 profile 的 cordis.patch.yml 或 overlay 中加入：
- id: session-query-sqlite
config:
path: ':memory:'
openAt: first-search
保存后重启 DSH web。
未开启全文索引时，内容模式会显示配置指引，标题模式仍可使用。
典型用法¶
1、安装插件并重启 DSH web 后，侧边栏底部会出现“搜索”入口。
2、点击“搜索”，打开浮层面板。
3、切到标题模式，输入会话标题或工作目录子串，查看过滤结果。
4、切到内容模式，输入关键词，再选择 全部、用户、回复 或 工具 进行筛选。
5、查看按会话聚合的结果，包括会话标题、最强命中片段和类型标签。
6、点击某条结果，打开对应会话并定位到命中内容所在上下文。
适用场景与注意¶
- 需要已安装 DeepSeek Harness，并使用 web profile。
- GitHub 直装需要能连通
github.com；网络受限时需配置可用代理或镜像加速。 - 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 许可证为 MIT。
- 不改任何官方源码、不建派生库，数据经 DSH 现成
sessionQuery服务。 - 配置仅存于 DSH settings 命名空间与浏览器浮层状态。
- 不读取、不上传会话内容以外的数据。
- 宿主 HTTP 路由
/switch-search/api的浏览器信任围栏与 DSH/api网关一致，拒绝 cross-site。
结尾¶
dsh-session-search-toggle 把 DSH web 侧边栏的会话检索补成标题和内容两种模式，并加入用户、回复、工具的内容筛选。适合需要在 DSH web 里快速查找历史会话、工具调用和上下文片段的场景。
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。资料中给出的目录页：
https://www.skillhub.cn/plugins/drscrewdriver/dsh-session-search-toggle
GitHub 仓库：
https://github.com/drscrewdriver/dsh-session-search-toggle
