Back to directory

dsh-search-index

In a curated listMaintenance: Active

drscrewdriver/dsh-search-index

Lets a DSH user search past session titles and message content (filtered by user/reply/tool) from the sidebar or a full page.

View on GitHub
$ dsh plugin --profile web add dsh-search-index

10

stars

3

forks

JavaScript

Language

MIT

License

2026-08-19

Created

2026-11-18

Last push

MIT DSH plugin that adds title and FTS5 full-text search over past DeepSeek Harness sessions, installed with a single `dsh plugin add` and reachable from the sidebar, a full page or `/sfind` in the terminal.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-15

License

MIT

01What can it help you accomplish?

  • Find a past DeepSeek Harness session by its title, or find which session contains a phrase

    Instant title hits, or content hits aggregated per session with the matched snippet and filters for type (user / reply / tool), domain (all / active / archived), date range, sort order and hit expansion

    DSH users whose session history is long enough that scrolling the sidebar no longer finds anything

  • Repair a stale or incomplete search index so hits land on the right line

    A rebuilt local FTS5 index (shadow build → atomic switch → bounded archive), and for stale DRS projections a deep sync that slow-rescans the projection library before rebuilding

    DSH users who see missing or outdated results, or whose hits open the session without jumping to the matched line

02How to install into DeepSeek Harness

Prerequisites

  • A DSH host with the `dsh plugin` CLI — the README's install command targets a profile named `web`
  • `dsh-reference-session-collector` (DRS): ships as a formal dependency of this package, so no separate download is needed, but as a transitive dependency the host may never activate it
  • A host process restart after installing — the README says it is mandatory

Installation steps

  1. 01

    Run `dsh plugin --profile web add dsh-search-index` (the same command also accepts a local `.tgz` path in place of the package name)

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

  2. 02

    Restart the host process; content search stays unavailable until DRS is activated, title search works without it

  3. 03

    If the settings card reports that DRS is not activated, run `dsh plugin --profile <name> add dsh-reference-session-collector` and restart the host

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

  4. 04

    When upgrading from the merged `dsh-session-steward` (≤0.5.x, which bundles search), remove it first with `dsh plugin remove dsh-session-steward`, then install `dsh-manage-session` plus this plugin

    $ dsh plugin remove dsh-session-steward

Verify the integration

  • In dsh-tui, run `/sfind` — it prints the search-channel status: DRS availability, session count and whether indexing is running
  • In the web host, `search-status` reports `available:false` together with a reason code when neither transport arm works, and `/switch-search/api/index-status` returning 200 with `available:true` means the index surface is live

Rollback

  • Set `enabled` to false in the `switch-search` settings namespace — no methods are registered and the whole entry disappears

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH plugin installed into a DSH profile with `dsh plugin add`: registers its own `/switch-search/api` route surface, a sidebar panel row plus a main page (host ≥ 0.1.7) or a footer button plus dialog (older hosts), a settings card, and host-side slash commands

  • Title-mode search

    a query typed into the search entry; `defaultMode` defaults to `title`→session titles that contain the query, returned as you type

  • Content full-text search with filters

    keyword plus type (user / reply / tool), domain (all / active / archived), date range, sort by relevance or time, expand hits→hits aggregated per session with the matched snippet, expandable

    reads its corpus from the `dsh-reference-session-collector` projection library, over the same-origin HTTP route or a read-only in-process connection
  • Hit navigation into the session

    a content-search hit→the session opens and patrols to the matched line, with a diagnostic badge; cold data asks for confirmation and then pages back with a HUD showing progress

    cold hits (target more than 40 turns away from the newest turn) ask for confirmation before paging back
  • Index lifecycle: incremental sync, non-destructive rebuild, deep sync, snapshots

    host `sessionQuery` for a rebuild; the DRS projection library for a deep sync→a shadow-built FTS5 index switched atomically with a bounded archive, plus JSON Lines snapshot export and import

    writes into `~/.dsh-switch-search/`: its own FTS5 index database, historical archive copies and a tombstone ledger`~/.dsh/storages/workspace.json` is read-only for this plugin — archive set and workspace membership only
  • Terminal search via `/sfind`

    `/sfind`, `/sfind <q>` or `/sfind <q> --content` in dsh-tui→channel status, title-mode hits or content-mode FTS hits, printed in the TUI one-line format

04Who is it for? When not to use it?

Good for

  • DSH users whose session history is long enough that scrolling the sidebar no longer finds anything
  • DSH users who see missing or outdated results, or whose hits open the session without jumping to the matched line

Not for

  • It cannot be installed alongside the merged `dsh-session-steward` (≤0.5.x, which bundles search): both register the `/switch-search/api` prefix, and on the 0.1.5 host line the host fails to start with a duplicate prefix route. Remove the old package, then install `dsh-manage-session` plus this plugin.
  • Content search depends on the DRS projection library (`dsh-reference-session-collector`). It arrives as a transitive dependency, and hosts only activate bundles listed in the profile's top-level `dependencies`, so the projection library may never update; the settings card then asks for `dsh plugin --profile <name> add dsh-reference-session-collector` followed by a host restart. Title search keeps working without DRS.
  • Version-coupled with drsc 0.2.6: a package older than 0.7.15 treats a time-budgeted pause (`syncing=false` with non-zero `deferred`) as a finished scan and rebuilds the local index from a partial corpus. Upgrade this package before upgrading drsc; package ≥0.7.15 with an older drsc is safe.

05Compatibility, maintenance and safety notes

  • It cannot be installed alongside the merged `dsh-session-steward` (≤0.5.x, which bundles search): both register the `/switch-search/api` prefix, and on the 0.1.5 host line the host fails to start with a duplicate prefix route. Remove the old package, then install `dsh-manage-session` plus this plugin.
  • Content search depends on the DRS projection library (`dsh-reference-session-collector`). It arrives as a transitive dependency, and hosts only activate bundles listed in the profile's top-level `dependencies`, so the projection library may never update; the settings card then asks for `dsh plugin --profile <name> add dsh-reference-session-collector` followed by a host restart. Title search keeps working without DRS.
  • Version-coupled with drsc 0.2.6: a package older than 0.7.15 treats a time-budgeted pause (`syncing=false` with non-zero `deferred`) as a finished scan and rebuilds the local index from a partial corpus. Upgrade this package before upgrading drsc; package ≥0.7.15 with an older drsc is safe.
2026-08-192026-11-10v0.7.18

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

06Frequently asked questions

How do I install dsh-search-index into DeepSeek Harness?

Run `dsh plugin --profile web add dsh-search-index` (the same command accepts a local `.tgz` path instead of the package name) and then restart the host process — the README says the restart is mandatory. On host ≥ 0.1.7 the plugin becomes a sidebar panel row plus a full main-column page opened with Ctrl/⌘+K; on older hosts it stays a footer button plus dialog.

Content search is greyed out even though the plugin installed — why?

Content search needs the DRS projection library, `dsh-reference-session-collector`. It ships as a formal dependency, but hosts only activate bundles listed in the profile's top-level `dependencies`, so as a transitive dependency it may never be mounted and the projection library stops updating. The settings card then shows the activation command `dsh plugin --profile <name> add dsh-reference-session-collector`; run it and restart the host. Title search works without DRS.

Does it work on the DSH NEXT desktop host?

Yes. The desktop host answers `403 Browser access is disabled` to non-rendered-process requests in the web layer, so the HTTP transport never works there; with `contentTransport` at its `auto` default the plugin switches to the read-only in-process arm on its own and the user does nothing. `search-status` returns `available:false` plus a specific reason code only when both arms are unavailable.

What does the plugin write to disk, and can a rebuild damage my data?

The index lives in its own directory, `~/.dsh-switch-search/` — an FTS5 database, historical archive copies and a tombstone ledger — while `~/.dsh/storages/workspace.json` is only read, for the archive set and workspace membership. Rebuilds are non-destructive: shadow database build, atomic switch, bounded archive. The in-process arm creates no directories, runs no DDL and writes no `meta`; when the database schema does not match expectations it only reports an error and never clears the database.

Can I search from the terminal instead of the web UI?

dsh-tui does not load the plugin's client half (panels, cards, settings page) and cannot call the plugin's own RPC, but the plugin registers host slash commands itself: `/sfind` prints the search-channel status, `/sfind <q>` runs title mode and `/sfind <q> --content` runs content mode against the DRS projection library.

08Data and sources

  • Author-claimedgithub.com5e989ae7d15a…

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

  • Author-claimedgithub.com5e989ae7d15a…

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

  • Author-claimedgithub.com5e989ae7d15a…

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

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-15. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.