dsh-pattern-search

dsh-pattern-search

Regex pattern search for the current DSH conversation: a /pattern-search floating window plus a model-invokable pattern_search session tool. Search assistant text, reasoning, user messages and tool results with a regular expression, and get match statistics plus a paginated, highlighted detail table. Built to make behaviors like the model's "Actually, wait, let me …" phrasings countable and observable.

Install

dsh plugin --profile web add github:yzhangjy/dsh-pattern-search

Restart dsh web and hard-refresh the browser.

Update

dsh plugin --profile web remove dsh-pattern-search
dsh plugin --profile web add github:yzhangjy/dsh-pattern-search

pnpm up does not re-resolve unpinned github: dependencies (it reports "Already up to date"), so updating is remove + add, which re-resolves to the latest main. Then restart dsh web and hard-refresh the browser. To pin a specific commit, install github:yzhangjy/dsh-pattern-search#<commit>.

Features

• /pattern-search command — a client-owned '/' trigger source: opens a floating window, no host round-trip, no session-log records, nothing model-visible (leaves no trace).
• Regex with flags — i / s / m toggles (g always on), inline errors for invalid patterns, explicit Search button (never auto-searches while typing).
• Stats — total matches, unique matched strings, hit turns / hit messages with window denominators, message-based hit rate, per-source and per-turn breakdowns (hover ⓘ explains each metric).
• Paginated table — bordered table with header, 10/20/50/100 rows per page, <mark>-highlighted matches with ±60-char context.
• Partial toggle — include the in-flight streaming output (a snapshot at search time).
• Full-session overview — a host projection (patternTotals) shows whole-interaction turn/message counts next to the window-scoped numbers; Search full session pulls the complete history (loadOlder) before searching, so hit rates cover the whole interaction.
• Theme-native — every color resolves from the dsh web --dsw-alias-* tokens, so the window follows the app's day/night theme.
• pattern_search session tool — the same search logic as a host-side tool the model can invoke on the current session's durable event log, for in-session self-observation.

Usage

In the GUI: type /pattern-search + Enter → the window opens → paste a pattern (e.g. Actually,?\\s*wait,?\\s*let me\\b — i is on by default) → click Search.

By the model: call the pattern_search tool:

{ "pattern": "Actually,?\\s*wait,?\\s*let me\\b", "flags": "i", "source": "assistant", "context": 60, "limit": 20 }

Stat semantics

• 窗口内轮数 / 窗口内消息数 — the client snapshot keeps only a recent window of the conversation; early turns of a long session are outside it and not counted. The Full session (durable log) line comes from a host projection over the complete log; enabling Search full session loads the whole history before searching, making the hit rate full-session.
• 命中率 = 命中消息数 ÷ 窗口内消息数 — message-based, window-scoped.
• 去重匹配串 — distinct matched strings, counted once each, case-sensitive (with i on, wait/Wait/WAIT still count separately).

Development

npm install          # dev deps (tsdown, typescript, react types, dsh type packages)
npm run build        # tsdown → lib/index.js (host) + lib/client.js (browser bundle)
npm test            # vitest (shared search core, extraction, worker parity)
npm run register     # dsh plugin --profile web add . (after build)

Rebuilt client bundles are served by the running app immediately — a hard refresh (Cmd+Shift+R) is enough; no server restart is needed for client-only changes. Host-half changes (the tool) need a restart.

Architecture

src/
├── host/
│   ├── index.ts        # registers the pattern_search session tool (defineTool)
│   └── search.ts       # core search over the session event log
└── client/
    ├── index.ts        # client plugin body: command + window registration
    ├── command.ts      # /pattern-search inputTriggers source
    ├── store.ts        # window/result state + page size
    ├── extract.ts      # ConversationSnapshot → searchable text segments
    ├── search.ts       # regex execution (client side)
    ├── stats.ts        # statistics (window-scoped)
    ├── i18n.ts         # zh/en dictionaries
    └── ui/             # PatternWindow + ResultList (theme-native)

The design document lives in PRD.md.

License

MIT