DeepSeek Harness Plugin

luorenyu/dsh-deepsearch

Stars ★ 0 Downloads (30d) 494 Category Sessions & Messages Added 2026-11-16 npm @renyuluo/dsh-deepsearch

Local conversation full-text search with Chinese substring matching, highlighted previews, workspace filters, local search history and native conversation opening.

Install

# from npm (prebuilt)

dsh plugin --profile web add @renyuluo/dsh-deepsearch

# from a prebuilt release tarball

dsh plugin --profile web add "https://github.com/luorenyu/dsh-deepsearch/releases/download/v0.1.17/renyuluo-dsh-deepsearch-0.1.17.tgz"

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:luorenyu/dsh-deepsearch

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

CI

简体中文 | English

A local full-text search plugin for DeepSeek Harness. Find a conversation from a fragment you remember, without having to remember its title.

  • Search Chinese fragments: literal substring matching without FTS tokenization, case-insensitive English matching, and literal punctuation.
  • Search message content: conversation titles, user messages, and completed final assistant replies. Results show highlighted snippets and the message's local date and time.
  • Current conversation first: search its newest messages first, then automatically scan the remaining conversations in batches.
  • Native conversation navigation: open the original DSH conversation, load the exact message, and attempt to scroll to and highlight it—without replacing the conversation view.
  • Scope and appearance controls: project/workspace filters, optional archived conversations, frosted glass, host theme, and custom color, opacity, and blur.
  • Optional manual unread: enable session context-menu marking in settings, with the native leading unread dot, automatic clearing on re-entry, and local-only persistence.
  • Local search history: record keywords after one idle second, keep up to 30, replay or delete them, and choose the default start tab without storing chat content.
  • Projects and shortcuts: start native conversations from project results with a bounded sidebar reveal; optionally use macOS ⌘K and restore the original binding when disabled.
  • No chat uploads: reuse the host's authentication and history services with no additional production listener. Messages are never edited; archive state changes only after explicit restoration confirmation.

Feature Preview

Except for the explicitly labeled sidebar illustration, these images use the actual plugin components in an isolated mock host with fictional demo data. They are not screenshots of your chats or the native DSH conversation page. Native message navigation must be verified in the real host; the demo does not simulate successful navigation. The screenshots show the Chinese UI; this English README does not change the plugin's interface language.

Full-text search, highlighted snippets, and message timestamps

Full-text search with Chinese matches and local message timestamps

Project and workspace filters

Narrow the search to a project or workspace

Archived conversations

Optionally include archived conversations

Three panel appearance modes

Frosted-glass search panel

Use the host theme

Customize background color, opacity, and blur

Optional extension: manual unread

Enable it in Settings, then mark a sidebar conversation unread/read from its context menu. Re-entering the conversation clears the mark. Preferences and marks remain local to this client. The settings image uses the actual plugin component. The context-menu image places a faithful fictional sidebar illustration inside the matching feature-card frame; it is not a native screenshot or runtime-verification evidence.

Enable manual unread in Settings

Session context menu and leading unread indicator demonstration

Search history and compact settings

Keywords stay local, with a preferred start tab, replay and deletion. The CmdK demonstration uses an in-memory mock shortcut service, not real host configuration writes.

Local history and preferred start tab

Compact settings and optional CmdK takeover

Installation

The verified host is DSH Desktop 0.2.2-rc.3. Other versions and platforms have not completed real-desktop regression testing. The package's compatibility range is currently restricted to this host version.

Install from npm (recommended)

The public package is @renyuluo/dsh-deepsearch. The feature release documented here is 0.1.17. Use the commands below; npm and GitHub Releases are the source of truth for publication status.

dsh plugin --profile desktop add @renyuluo/dsh-deepsearch

The public package name is @renyuluo/dsh-deepsearch. The product name and GitHub repository name remain unchanged.

Install from GitHub

dsh plugin --profile desktop add 'https://github.com/luorenyu/dsh-deepsearch.git#v0.1.17'

Alternatively, download the package from Releases, then install it:

dsh plugin --profile desktop add /path/to/renyuluo-dsh-deepsearch-0.1.17.tgz

Important: do not install the unscoped npm package with add dsh-deepsearch. That package belongs to another author and is unrelated to this repository. Use @renyuluo/dsh-deepsearch or this repository's GitHub/Release URL instead.

If you previously installed this project under its old unscoped name from GitHub, remove that entry before installing the scoped package so that two copies do not load at once:

dsh plugin --profile desktop remove dsh-deepsearch
dsh plugin --profile desktop add @renyuluo/dsh-deepsearch

This migration applies only to this project's old installation; it is not a recommendation to remove another author's similarly named plugin. The appearance storage key is unchanged, so existing preferences are preserved on the same host page origin.

Component screenshots have been refreshed for 0.1.17; the approved fictional sidebar illustration is preserved. All demos use an isolated mock host and invented data, never private conversations. Native navigation and persisted shortcut integration require actual-host verification.

Discover it in the DSH plugin marketplace

Marketplace submission #15379 has been opened as a draft. It is awaiting the repository's 24-hour minimum age before being marked ready for maintainer review. Awesome DSH Plugin is the third-party community catalog used by dshmarket. Availability depends on the PR being merged and the marketplace being synchronized. A GitHub release does not mean the plugin is already listed in the marketplace.

Once accepted, search the relevant marketplace for DeepSearch or 会话全文搜索. Check that the source is luorenyu/dsh-deepsearch, not another author's similarly named plugin. DSH also supports custom indexes, so catalog sources may differ between clients.

Usage

Action Shortcut / control
Open or close search macOS ⌘⇧K; Windows/Linux Ctrl⇧K (not tested on physical devices)
Select a result ↑ / ↓
Open a result Enter; clicking a project result or pressing Enter starts a native conversation in that workspace
Close the panel Esc or click outside
Set the search scope All / Conversations / Projects, workspace dropdown, include archived
Adjust the panel and extensions “设置” (Settings) in the upper-right corner

By default, DeepSearch leaves DSH's native ⌘K alone; takeover is optional in Settings. It does not claim ⌘F, commonly used by other search plugins.

Include archived is checked by default and can be unchecked. With an empty query, recent conversations show the project and session's last update in local time (YYYY/MM/DD HH:mm); missing metadata displays 未分配项目 / 时间未知. The reset-arrow icon after the blur slider restores default appearance and exposes a hover tooltip.

With an empty query, switch between Recent conversations and Search history. The Default history checkbox, before Include archived, remembers a local preference: checked puts Search history first; unchecked puts Recent conversations first. Changing it reorders tabs without switching the current content; reopening selects the first tab. Keywords are saved after one second of idle input, never during IME composition; at most 30 exact-deduplicated keywords are kept, newest first. Clicking a history entry or selecting it with Enter searches again without directly opening a conversation. Individual deletion and Clear history affect only local keywords, not results or chat messages.

Enter a Chinese fragment or an English keyword. Search continues automatically, with results appearing as each batch is scanned—no manual paging is required. “No results” is shown only after a complete scan finds no matches. Read failures, timeouts, incomplete scans, and the 200-result limit are reported separately. Changing the query or closing the panel cancels the previous task.

Opening a message result takes you to the native conversation. The plugin verifies the exact message using sessionId + seq, then attempts to locate and highlight the corresponding native row. The status area lets you return to search or clear the highlight. Switching conversations or feature pages releases navigation resources. Title results only open the conversation; they do not claim successful message positioning.

Project results open the native new-conversation page first, then make one bounded attempt to expand the target workspace and folded ancestors and reveal the workspace and conversation in the sidebar. Manual scrolling, further input, or another result stops the attempt. A collapsed sidebar, flat/filtered view, or changed host DOM may skip sidebar reveal without preventing navigation. The workspace dropdown still only filters search scope.

Optional native ⌘K takeover

Enable “使用 ⌘K 打开 DeepSearch” in Settings to replace native session search with DeepSearch through the official DSH shortcut service on macOS Desktop. ⌘⇧K remains available. Off by default; disabling restores the original override, including custom bindings. This writes DSH shortcut preferences and saves a local recovery journal, surviving reload.

Turn takeover off before uninstalling. Direct removal cannot automatically restore host preferences; use DSH shortcut settings to restore Session Search and clear the DeepSearch binding. Failed writes attempt a safe rollback; externally changed bindings are not overwritten and recovery data is kept. Currently macOS Desktop only, not an arbitrary shortcut recorder.

Opening archived results

With “含归档” (Include archived) enabled, archived title and message hits display an “已归档” badge. Selecting one keeps the results visible and asks for confirmation. Only “恢复并打开” (Restore and open) calls the host unarchive command, then opens the native conversation and attempts message positioning. Cancel does not change archive state.

Failures or timeouts keep results visible with an error. DeepSearch does not silently navigate or automatically rearchive. An issued restoration request cannot necessarily be withdrawn: closing the panel or changing the query cancels subsequent navigation, but the host may still finish the explicitly confirmed restoration.

Appearance

  • Frosted glass: prefer the host input field's glass background and blur only the area behind the search panel.
  • Follow DSH: use an opaque background from the host theme.
  • Custom: choose a color, opacity from 55–100%, and blur from 0–32px, or restore the defaults.

DeepSearch does not dim the screen or blur the entire DSH page. Its compatibility fix for wallpaper plugins' opaque-dialog rules applies only to its own panel. Preferences are saved locally in localStorage; if storage is blocked, settings remain usable for the current session. An opaque fallback is used when reduced transparency is requested or backdrop blur is unsupported.

Optional extension: manual unread markers

Enable “会话未读标记” in Settings (off by default). Right-click a sidebar conversation to mark it unread/read; the marker reuses DSH’s native unread StateDot component to the left of the title, with host-owned colors and dimensions. Entering a conversation clears its manual marker. Marking the already-open conversation does not immediately clear it.

Preferences and markers stay in this client’s local storage, do not sync across devices and do not change native completion notifications. Disabling the extension hides menus and dots but keeps markers. Markers share the native leading status seat; running, pending-interaction and native completion states take priority. Archived and blank conversations do not show manual dots. Storage failures are reported in Settings; changes remain usable for the current session.

Privacy and Limitations

  • Reads history through the host's public services, not by parsing private chat files directly. It does not upload chats or write to original messages. The search API uses the host's owner-authenticated connection.fetch routes.
  • By default, searches regular conversation titles, user messages, and completed final assistant replies. Tool output, reasoning, subagents, and unfinished replies are excluded. The UI includes archived conversations by default and lets you opt out; the underlying API still requires an explicit archive flag.
  • Uses bounded memory, short-lived cursors, and batch scanning—not a persistent incremental index. Initial searches through very long histories may be slower. At most 200 results are displayed. Cursors expire after two minutes of inactivity, requiring a new search.
  • Each conversation's history snapshot at its first read defines the scope of that scan. Messages appended during scanning appear only after a new search. History revisions or truncation explicitly require restarting the search.
  • Projects come from workspaces registered with the host. DeepSearch does not search file contents on disk or provide command search.
  • Message timestamps use the local time zone and the format YYYY/MM/DD HH:mm. Missing or invalid timestamps are not invented.
  • Exact positioning uses a DOM compatibility adapter for the current host, not a stable public scrolling API. Folded messages, Markdown transformations, non-Chat views, host upgrades, or native scrolling policies may prevent positioning or exact-text highlighting. The plugin reports these states without blocking the native conversation.

Development and Testing

No build step or third-party production dependencies are required. Use Node.js 22+:

git clone https://github.com/luorenyu/dsh-deepsearch.git
cd dsh-deepsearch
npm test
npm run check
npm pack --ignore-scripts

Core tests cover literal matching, Chinese and Unicode ranges, history projection, reverse pagination, automatic continuation, cancellation/timeouts/cursors, native navigation lifecycle, snippet rendering, timestamps, and appearance. Component screenshots and mock-service tests are not equivalent to real-host acceptance testing across every host version, theme, and platform.

Code overview:

  • client.js: search panel, shortcuts, snippets, appearance, and native navigation adapter.
  • host.js: authenticated routes and request limits.
  • search-core.js: conversation catalog, final-reply projection, substring matching, and pagination.
  • tests: host-independent unit and contract regression tests.

Uninstall:

dsh plugin --profile desktop remove @renyuluo/dsh-deepsearch

MIT License · Report an issue

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.