返回目录

dsh-search-index

精选清单收录维护状态: 活跃

drscrewdriver/dsh-search-index

给 DeepSeek Harness 侧边栏加一个会话内容检索——标题/内容一键切换,还能按用户/回复/工具筛选

前往 GitHub
$ dsh plugin --profile web add dsh-search-index

10

星标

3

Fork

JavaScript

语言

MIT

许可证

2026-08-19

创建于

2026-11-18

最近推送

MIT 协议的 DSH 插件:给过去的 DeepSeek Harness 会话加上标题检索与 FTS5 全文检索,一条 `dsh plugin add` 安装,入口在侧栏、整页或终端 `/sfind`。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-15

许可证

MIT

01它能帮你完成什么?

  • 按标题找回过去的 DeepSeek Harness 会话,或找出某句话出现在哪个会话里

    标题模式即时出结果;内容模式按会话聚合展示命中片段,并支持类型(用户/回复/工具)、检索域(全部/活跃/归档)、日期区间、排序(相关度/时间)与命中展开

    会话历史长到在侧栏里翻不动的 DSH 用户

  • 修好过期或缺内容的索引,让命中真正落到目标行

    重建本地 FTS5 索引(影子库构建 → 原子切换 → 有界归档);DRS 投影库滞后时用深度同步先慢扫再整理

    结果缺失或陈旧、或者点了命中只打开会话却不跳到目标行的 DSH 用户

02如何接入 DeepSeek Harness?

前置条件

  • 具备 `dsh plugin` CLI 的 DSH 宿主 —— README 的安装命令针对名为 `web` 的 profile
  • `dsh-reference-session-collector`(DRS):作为本包正式依赖随包安装,包本身不需要用户单独下载;但作为传递依赖,宿主可能不会挂载它
  • 安装后重启宿主进程 —— README 明确写了「必须重启宿主进程」

安装步骤

  1. 01

    执行 `dsh plugin --profile web add dsh-search-index`(同一条命令也可用本地 `.tgz` 路径代替包名)

    $ dsh plugin --profile web add dsh-search-index

  2. 02

    重启宿主进程;DRS 未激活前内容检索不可用,标题面仍可用

  3. 03

    若设置卡提示 DRS 未激活,执行 `dsh plugin --profile <name> add dsh-reference-session-collector` 后重启宿主

    $ dsh plugin --profile <name> add dsh-reference-session-collector

  4. 04

    从合并包 `dsh-session-steward`(≤0.5.x,内含 search)迁移时,先用 `dsh plugin remove dsh-session-steward` 移除它,再安装 `dsh-manage-session` 与本插件

    $ dsh plugin remove dsh-session-steward

验证接入成功

  • 在 dsh-tui 执行 `/sfind`,读取检索通道状态:DRS 可用性、会话数与是否正在建索引
  • Web 宿主下两条通道都不可用时,`search-status` 返回 `available:false` 与具体原因码;`/switch-search/api/index-status` 返回 200 且 `available:true` 说明索引面就绪

回滚

  • 把 `switch-search` 设置里的 `enabled` 设为 false:不再注册任何方法,入口整体消失

03DSH 适配与能力边界

DSH 适配原生运行时

原生 DSH 插件:用 `dsh plugin add` 装入 DSH profile,自带 `/switch-search/api` 路由面;宿主 ≥ 0.1.7 时注册侧栏面板行 + 主栏整页,更早的宿主则是底栏按钮 + 弹窗,另有设置卡与宿主斜杠命令

  • 标题模式检索

    在搜索入口输入的查询词;`defaultMode` 缺省为 `title`→包含该查询词的会话标题,输入即出结果

  • 内容全文检索与筛选

    关键词,加上类型(用户/回复/工具)、检索域(全部/活跃/归档)、日期区间、按相关度或时间排序、命中展开→按会话聚合的命中结果与命中片段,可展开查看

    语料取自 `dsh-reference-session-collector` 投影库,走同源 HTTP 路由或进程内只读直连
  • 命中定位(跳转到目标行)

    一条内容检索命中结果→打开会话并巡逻定位到目标行,附诊断徽标;冷数据先弹确认,确认后按实测页宽回溯翻页,HUD 浮窗显示进度

    目标距会话最新回合 >40 的冷数据会先弹确认再回溯翻页
  • 索引生命周期:增量同步、非破坏性整理、深度同步、快照

    整理读宿主 `sessionQuery` 全量;深度同步读 DRS 投影库→影子库构建后原子切换的本地 FTS5 索引与有界归档,外加 JSON Lines 快照导出/导入

    写入 `~/.dsh-switch-search/`:独立 FTS5 索引库、历史索引份数与墓碑台账对 `~/.dsh/storages/workspace.json` 只读 —— 仅取归档集合与工作区成员表
  • 终端斜杠命令 `/sfind`

    dsh-tui 中的 `/sfind`、`/sfind <q>` 或 `/sfind <q> --content`→检索通道状态、标题模式命中或内容模式 FTS 命中,按 TUI 单行格式输出

04适合谁?何时不该用?

适合

  • 会话历史长到在侧栏里翻不动的 DSH 用户
  • 结果缺失或陈旧、或者点了命中只打开会话却不跳到目标行的 DSH 用户

不适合

  • 不能与合并包 `dsh-session-steward`(≤0.5.x,内含 search)同装:两者都注册 `/switch-search/api` 前缀,0.1.5 线宿主会直接启动失败(duplicate prefix route)。迁移时先移除旧包,再安装 `dsh-manage-session` 与本插件。
  • 内容检索依赖 DRS 投影库(`dsh-reference-session-collector`)。它作为传递依赖随包安装,而宿主激活 bundles 只扫 profile 顶层 `dependencies`,因此投影库可能永远不更新;此时设置卡会提示执行 `dsh plugin --profile <name> add dsh-reference-session-collector` 再重启宿主。DRS 缺席时标题检索照常可用。
  • 与 drsc 0.2.6 存在版本耦合:低于 0.7.15 的本包会把「时间预算用完」当成扫完(`syncing=false` 但 `deferred` 不为 0),进而拿残缺语料重建本地索引。升级时先升本包、再升 drsc;本包 ≥0.7.15 搭配旧版 drsc 是安全的。

05兼容性、维护与安全提示

  • 不能与合并包 `dsh-session-steward`(≤0.5.x,内含 search)同装:两者都注册 `/switch-search/api` 前缀,0.1.5 线宿主会直接启动失败(duplicate prefix route)。迁移时先移除旧包,再安装 `dsh-manage-session` 与本插件。
  • 内容检索依赖 DRS 投影库(`dsh-reference-session-collector`)。它作为传递依赖随包安装,而宿主激活 bundles 只扫 profile 顶层 `dependencies`,因此投影库可能永远不更新;此时设置卡会提示执行 `dsh plugin --profile <name> add dsh-reference-session-collector` 再重启宿主。DRS 缺席时标题检索照常可用。
  • 与 drsc 0.2.6 存在版本耦合:低于 0.7.15 的本包会把「时间预算用完」当成扫完(`syncing=false` 但 `deferred` 不为 0),进而拿残缺语料重建本地索引。升级时先升本包、再升 drsc;本包 ≥0.7.15 搭配旧版 drsc 是安全的。
2026-08-192026-11-10v0.7.18

MIT · latest release v0.7.18 (2026-11-14), last push 2026-11-10

06常见问题

怎么把它装进 DeepSeek Harness?

执行 `dsh plugin --profile web add dsh-search-index`(同一条命令也可用本地 `.tgz` 路径代替包名),然后重启宿主进程——README 明确写了必须重启。宿主 ≥ 0.1.7 时插件变成侧栏面板行 + 主栏整页,配 `Ctrl/⌘+K` 打开;更早的宿主仍是底栏按钮 + 弹窗。

插件装上了,内容检索却不可用,为什么?

内容检索需要 DRS 投影库 `dsh-reference-session-collector`。它作为本包的正式依赖随包安装,但宿主激活 bundles 只扫 profile 顶层 `dependencies`,作为传递依赖可能不被挂载,投影库也就不再更新。此时设置卡会给出激活命令 `dsh plugin --profile <name> add dsh-reference-session-collector`,执行后重启宿主即可。DRS 缺席时标题检索照常可用。

DSH NEXT 桌面版能用吗?

能。桌面宿主在 web 层对非渲染进程请求一律返回 `403 Browser access is disabled`,所以 HTTP 通道在桌面版永远不可用;`contentTransport` 缺省为 `auto` 时插件会自行改走进程内只读臂,用户无需任何操作。只有两臂都不可用时 `search-status` 才返回 `available:false` 并给出具体档位码。

它往磁盘写什么?整理索引会毁数据吗?

索引写在自己的目录 `~/.dsh-switch-search/`:独立 FTS5 索引库、历史归档份数与墓碑台账;`~/.dsh/storages/workspace.json` 只读,仅取归档集合与工作区成员表。整理索引是非破坏性的:影子库构建 → 原子切换 → 有界归档。进程内臂不建目录、不跑 DDL、不写 `meta`;库 schema 与本包预期不符时只报错,绝不清库。

可以在终端里检索,而不打开 Web 界面吗?

dsh-tui 不加载插件的 client 半边(面板/卡片/设置页),也调不到插件自有 RPC,但命令由插件自己在宿主侧注册:`/sfind` 看检索通道状态,`/sfind <q>` 走标题模式,`/sfind <q> --content` 走内容模式(依 DRS 投影库)。

08数据与来源

  • 作者声明github.com5e989ae7d15a…

    DSH 插件:**会话标题 / 内容全文检索**,自带独立 FTS5 索引;内容检索的语料与语义

  • 作者声明github.com5e989ae7d15a…

    dsh plugin --profile web add dsh-search-index

  • 作者声明github.com5e989ae7d15a…

    | **≥ 0.1.7** | 「插件页式」**主栏整页** |

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。