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 明确写了「必须重启宿主进程」
安装步骤
- 01
执行 `dsh plugin --profile web add dsh-search-index`(同一条命令也可用本地 `.tgz` 路径代替包名)
$ dsh plugin --profile web add dsh-search-index
- 02
重启宿主进程;DRS 未激活前内容检索不可用,标题面仍可用
- 03
若设置卡提示 DRS 未激活,执行 `dsh plugin --profile <name> add dsh-reference-session-collector` 后重启宿主
$ dsh plugin --profile <name> add dsh-reference-session-collector
- 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 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 是安全的。
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 投影库)。
07相关的 DSH 工作流
dsh-univer-office
作者 dream-num
在 DSH 内预览、创建与编辑表格、文档和幻灯片,由 Univer 驱动
clearai-dsh
作者 clearailhc
ClearAI:以本体为纲的原生 DSH 插件 —— 经证据核验的研究长成可浏览的领域本体。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 鱼的记忆:给会话一份会淡忘的长期记忆,每条都带时间。名字里的「鱼」来自 DeepSeek 的鲸鱼。
dsh-trading
作者 zhu1090093659
基于 DeepSeek Harness 的智能体原生交易终端,三栏界面聚合币圈、美股、A股与港股,内置 19+ 可热插拔连接器,默认模拟交易并需人工确认。
08数据与来源
DSH 插件:**会话标题 / 内容全文检索**,自带独立 FTS5 索引;内容检索的语料与语义
dsh plugin --profile web add dsh-search-index
| **≥ 0.1.7** | 「插件页式」**主栏整页** |
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
