给 DeepSeek Harness 侧边栏加一个会话内容检索——标题/内容一键切换，还能按用户/回复/工具筛选
中文 · English
# dsh-session-search-toggle
> DSH web 侧边栏**会话搜索增强**：在侧边栏底部新增 **"搜索"** 入口，浮层面板一键在 **标题搜索 ↔ 内容搜索** 间切换；内容模式按**会话聚合**展示标题与命中片段，并按 **用户 / 回复 / 工具** 分类筛选。
无需修改 dsh 源码、无需提 PR：`dsh plugin` 命令组装 + bundle patch 装配的 cordis 客户端 + 插件宿主半。
> **▼ DSH 版本适配**
> | DSH 版本 | 设置行 / 主机路由 | 关键差异 |
> | --- | --- | --- |
> | 0.1.1-rc.2 | ✅ | store 引擎在 `@deepseek-ai/dsh-client-runtime/client` |
> | 0.1.2-rc.1 | ✅ | 引擎改名 `@deepseek-ai/dsh-client-store`；本插件两个都不导入 |
>
> - **单一产物，运行时自适应**：同一份 `lib/client.js` 在两版都能加载，无版本号字符串分支。客户端 bundle 只 `require` `react` / `react-dom`，两者都在两版共享模块表内。
> - **store 座位本地实现**：设置行需要一个 store 座位（`StoreHandle` / `StoreInstance`，契约由 `@deepseek-ai/dsh-client-ui-slots` 拥有、两版一致）。原先用 runtime 的 `defineStore`，而该引擎包在两版之间改过名，因此改为约 30 行本地实现——只依赖 `create()` → `{ actions, getSnapshot, subscribe, clearPersisted }`，不再涉及任何版本专属 specifier。
> - **其余契约两版一致**：`settings.general.item` 槽、`SettingsScope.{getSnapshot,subscribe,set,unset}`、`sessionQuery` 三个查询面在两版签名相同。
> - 侧边栏入口目前仍处于关闭状态（`sidebar.footer.action` 注册已注释），两版都支持重新启用。
## 它能做什么
- **标题 ↔ 内容双模式**：一个入口两种搜法——切到"标题"按会话标题/工作目录子串即时过滤；切到"内容"走 DSH 自带 FTS5 全文索引搜会话消息正文。
- **内容按会话聚合**：内容搜索结果每个会话一行（会话标题 + 最强命中片段 + 类型标签），点击即打开该会话，不刷屏逐条堆消息。
- **内容类型筛选**：内容模式顶部筛选 chip——**全部 / 用户 / 回复 / 工具**；`工具` 放开 `tool/call` 与 `tool/result` 事件进结果，直接搜到工具调用参数与返回值。
- **索引可用性探测**：Host 侧 `search-status` 探测 `sessionQuery` 全文索引是否开启；未开启时内容模式给出一句具体配置指引，而非裸报错"内容搜索不可用"。
- **通用设置行**：设置 → 通用新增 **"会话搜索"** 行——启用开关 + 默认搜索模式（标题/内容），配置即写即生效。
- **点击直达**：搜索结果点击跳转打开对应会话，定位到命中内容所在上下文。
## 界面预览
侧边栏搜索入口与设置面板布局示意：
## 内容搜索的底层：DSH FTS5 派生索引
内容模式不自己建库，直接复用 DSH 本体的 **SQLite FTS5 派生索引**（`session-query-sqlite`）：
| 表 | 说明 |
|---|---|
| `persisted_docs` (FTS5) | 持久化会话的全文文档（`text` 可搜，`type/session_id/seq/...` 作过滤列） |
| `temp.live_docs` (FTS5) | 当前进程存活会话的全文文档 |
| `persisted_sessions` / `live_sessions` | 会话头 + `revision`/`fingerprint`（增量重建依据） |
| `search_state` | generation 计数，驱动分页游标失效 |
- **懒索引**：`openAt: first-search` 时首次搜索才建索引；每次搜索前**增量 reconcile**（只重建有差异的会话），大语料首搜稍慢、之后很快。
- **tool 内容能搜到**：`extraction.ts` 明确提取了 `tool/call`（工具名+参数）与 `tool/result`（结果文本）进索引——这正是本插件"工具筛选"的数据基础。
### ⚠️ 前置：开启全文索引
**DSH 官方 bundle 默认关闭全文索引**（`session-query-sqlite` 的 `openAt: never`，见 `deepseek-harness/packages/bundle/web-app/cordis.patch.yml`）。要内容搜索生效，在你的 profile 的 `cordis.patch.yml` 或 overlay 里覆盖：
```yaml
- id: session-query-sqlite
config:
path: ':memory:' # 或可持久化的绝对路径（重启不重建）
openAt: first-search # 或 startup
```
然后重启 DSH web。不开启时插件内容模式会显示配置指引，标题模式不受影响。
## 安装
```sh
# 方式一：从 GitHub 直装（推荐）——仓库已提交 lib/，无需本地构建
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
# 或用随包脚本
bash ~/.dsh/profiles/web/node_modules/dsh-session-search-toggle/restart-dsh-web.sh
```
装完侧边栏底部出现 **"搜索"** 按钮；设置 → 通用出现 **"会话搜索"** 配置行。
> ⚠️ **GitHub 网络可达性**：github: 直装需要能连通 github.com；网络受限时请先配置可用代理或镜像加速，否则 add 会在拉取阶段卡住。
## 开发
```sh
pnpm install # 含 @deepseek-ai client 包链 + tsdown/tsc
pnpm typecheck # tsc --noEmit
pnpm build # tsc(lib/types) + tsdown(lib/index.mjs + lib/client.js)
```
### 工作区结构
```
src/
├── index.ts # 宿主半（node）：Config schema + installSettingsSection + 路由
├── config.ts # 纯共享配置（enabled/defaultMode + 命名空间常量，client 免 schemastery）
└── client/
└── index.ts # 浏览器半：sidebar.footer.action 入口 + 浮层面板 + settings.general.item 配置行
```
- **宿主半**：注册 fenced HTTP 路由 `/switch-search/api`（`list-sessions` / `content-search` / `search-status`），浏览器信任围栏与 DSH `/api` 网关一致（loopback Host 或 trustedHosts，拒绝 cross-site）。
- **配置模式**：借鉴 dsh-thinking-levels——宿主经 `settings` 服务注册 `switch-search` 命名空间 + schemastery `Config`；client 半 `defineStore` + `settingsScope.bind` 镜像读写；共享纯模块 `src/config.ts` 保持 client bundle 无 schemastery。
- **构建链**：tsdown 复制 harness `packages/client/tsdown.client.ts` 语义（`__ModuleLoader__.load` banner、平台模块 external 表、bundle purity gate）。
- **lib/ 提交进仓库**：GitHub 直装靠已提交的构建产物运行（dsh 从 git 安装不跑 prepare），`.gitignore` 不忽略 `lib/`。
## 分支说明
| 分支 | 用途 |
|---|---|
| `master` | 稳定基线（标题 ↔ 内容切换，会话聚合） |
| `feat/type-filter-search` | 开发分支（内容类型筛选 + 设置页索引进口 + 索引可用性探测） |
| `release-v0.1.0` | 从已验证开发状态派生的**稳定可装版本**，含 lib/ 构建产物 |
## 与官方侧边栏搜索的关系
- 官方侧边栏的搜索框在 `sidebar.workspaces`（single slot），外部插件**无法替换**；本插件在侧边栏底部**新增独立入口** `sidebar.footer.action`，二者并存、互不干扰。
- 官方内容搜索在 apiproxy 硬编码只搜 `user/message` + `assistant/message`；本插件通过 `types` 参数放开 `tool/call` + `tool/result`，实现工具级筛选。
## 兼容性与隐私
- 需要已安装 DeepSeek Harness 并使用 web profile；数据全部经 DSH 现成 `sessionQuery` 服务（live-preferred 语料库），**不改任何官方源码、不建派生库**。
- 配置仅存于 DSH settings 命名空间与浏览器浮层状态；不读取、不上传会话内容以外的数据。
- 宿主/客户端契约类型在 `src/*.ts` 本地结构声明（npm 上 dsh client 包链不完整），构建时以 harness 源码核实为准。
## drscrewdriver DSH Plugin Family
本项目是 [drscrewdriver](https://github.com/drscrewdriver) 维护的 DSH 插件系列之一。如果这个对你有用，其他插件多半也有用：
| 插件 | 一句话描述 |
|---|---|
| [dsh-input-traffic](https://github.com/drscrewdriver/dsh-input-traffic) | DSH Web GUI 忙时输入队列：三档交通管制，拖拽重排，会话冻结 |
| [dsh-thinking-levels](https://github.com/drscrewdriver/dsh-thinking-levels) | 逐轮 reasoning_effort 控制：Auto 智能调度或手动固定档位 |
| [dsh-seatbelt-sandbox](https://github.com/drscrewdriver/dsh-seatbelt-sandbox) | macOS Seatbelt 沙箱适配器：libsandbox 原生 loader，接替弃用的 sandbox-exec |
| **[dsh-session-search-toggle](https://github.com/drscrewdriver/dsh-session-search-toggle)** | 侧边栏会话搜索增强：标题/内容切换，按用户/回复/工具筛选 |
## License
MIT