dsh-everything

dsh-everything

中文文档

A DeepSeek Harness (DSH) plugin that gives the agent an everything_search tool: whole-disk file and folder search in milliseconds, powered by the local Everything (voidtools) index.

Instead of recursively scanning directories (glob) when the model needs to locate a file, the agent asks Everything's pre-built index — instant even on drives with millions of files. Two channels are used: Everything's built-in HTTP JSON server (loopback only, auto-enabled — no process spawn per call, native UTF-8, exact totals) with the official command line es.exe as an always-available fallback for everything the HTTP server cannot express.

Requirements

• Windows (Everything is a Windows-only application; on other platforms the plugin registers a stub that fails with a clear message)
• Everything 1.4+ and the ES command line tool (es.exe) — installed automatically on first use (see below)

Automatic backend setup (default)

With autoInstall: true (the default), the plugin provisions the backend by itself when it is missing:

1. Resolves the latest stable ES CLI from the voidtools.com downloads page, downloads the zip, and extracts es.exe to %LOCALAPPDATA%\dsh-everything\bin (per-user, no admin).
2. Installs Everything via winget install voidtools.Everything when winget is available, otherwise downloads the latest stable official setup and runs it silently — either path may show one UAC prompt.
3. Launches Everything and waits for its IPC before searching.

Downloads always go direct first — no proxy is needed, and a stale system-proxy setting can never break the install. A proxy (HTTPS_PROXY/HTTP_PROXY env, or the Windows system proxy) is only used as a fallback. Integrity: when the resolved version matches the known-good release recorded in setup.js, the download is SHA256-verified; a newer upstream release is verified by its voidtools Authenticode signature instead. If the downloads page is unreachable, the recorded known-good release (SHA256-verified) is used. Installs fail closed when verification fails.

The plugin also keeps its self-installed copy of es.exe current: on startup it compares the file version against the pinned known-good release and upgrades the copy it owns (user-managed installs are never touched).

Set autoInstall: false if you prefer to install the backend yourself:

winget install --id voidtools.Everything --silent
Invoke-WebRequest https://www.voidtools.com/ES-1.1.0.37.x64.zip -OutFile ES.zip
Expand-Archive ES.zip -DestinationPath "C:\Program Files\Everything" -Force
Start-Process "C:\Program Files\Everything\Everything.exe"

Installation

In a DSH session, ask the agent or call the plugin manager:

plugin_manager install_bundle with target = dsh-everything

The plugin activates as dsh-everything and registers the everything_search tool for every agent in the profile.

Published on npm as dsh-everything; installing from the package directory works too.

Tool: everything_search

Parameter	Type	Description
query (required)	string	Everything search expression: report ext:docx, *.sln dm:thisweek, path:\projects\ ext:py. Space = AND, | = OR, ! = NOT. Multi-word queries are split into es.exe terms automatically.
path	string	Restrict to a directory and its subtree (absolute path).
maxResults	integer	Result cap (default 100, ceiling 1000).
offset	integer	Skip leading results (pagination).
sort	string	e.g. date-modified-descending, size-descending, name-ascending. Keys: name, path, size, extension, date-created, date-modified, date-accessed, run-count, plus -ascending/-descending.
regex	boolean	Treat query as a full-path regular expression.
matchCase	boolean	Case-sensitive matching (default: insensitive).
wholeWord	boolean	Match whole words only.
foldersOnly / filesOnly	boolean	Restrict result type.
dateCreated	boolean	Also return each result's creation date.
countOnly	boolean	Return only the total match count — the fastest way to check existence or estimate volume.
exactTotal	boolean	Default true. false skips the extra match-count round-trip on full pages and reports a ≥N total instead.

Returns { query, total, totalExact, truncated, results: [{ path, size, dateModified, dateCreated? }], channel, notes } (channel is "http" or "es"; notes carries query-interpretation remarks) and renders in the chat as a search-paths card.

Typical queries: report ext:docx · *.sln dm:thisweek · size:>500mb · notes !archive · recently changed files with sort: date-modified-descending + dm:thisweek.

Phrase quirks: a quoted phrase only matches the name part, so "report.docx" matches nothing — pass it unquoted. A quoted phrase containing spaces that is the whole query (an exact multi-word match) is automatically converted to an equivalent regex; one embedded alongside other terms degrades to ANDed words and is reported in notes (use regex=true for those). Encoding: the HTTP channel is UTF-8 natively; the es.exe fallback reads its UTF-8 -export-json output — non-ASCII file names (Chinese, Japanese, emoji, …) survive the round trip intact either way.

Scope note: searches names and paths only, never file contents — content search stays with grep. Coverage note: results follow the local Everything index — NTFS/reFS drives and folders explicitly added to the index. FAT/exFAT removable drives and network shares are typically not covered.

Configuration

Edit the plugin's config in cordis.patch.yml (or your profile's patch layer):

Key	Default	Description
esPath	auto-detect	Absolute path to es.exe.
everythingPath	sibling of esPath	Absolute path to Everything.exe, used by autoStart.
autoStart	true	Launch Everything and wait for its IPC when it is not running.
autoInstall	true	Download & install Everything + ES CLI when missing (see above).
installDir	%LOCALAPPDATA%\dsh-everything	Where the auto-installed ES CLI lives.
maxResults	100	Default per-call result cap.
timeoutMs	8000	Per-call timeout (ms).
httpPort	5151	Everything HTTP server port for the fast channel; 0 disables the HTTP channel entirely.
httpAutoEnable	true	When the HTTP server is down, once per session: patch Everything's own config (unlock + enable + loopback bind) and restart its GUI. Set false to never touch Everything's config.
httpUsername / httpPassword	''	Optional Basic-auth credentials for the HTTP server.

Fast path: the built-in HTTP server

Everything 1.4 ships with an HTTP JSON server, but it is disabled and policy-locked by default — installed builds write allow_http_server=0 next to Everything.exe, and the GUI cannot unlock it. With httpAutoEnable: true the plugin flips that switch itself (one-time, once per session): it patches both Everything.ini files, binds the server to 127.0.0.1 only, restarts the Everything GUI, and routes searches through it. The background index service keeps running untouched.

The HTTP channel serves plain searches, path/foldersOnly/filesOnly scope, countOnly, pagination, and the name/path/size/date-modified sort keys. Everything else — dateCreated, other sort keys, and regex combined with a path or type filter — automatically uses the es.exe channel instead. If the HTTP server cannot be started (port busy, Everything not installed yet), the plugin silently stays on es.exe and retries later; a path that does not exist is reported as an error rather than an empty result.

Privacy

The search scope is every indexed drive on the machine, and result paths are sent to the model as tool output. Keep that in mind on machines with sensitive directory layouts; use path to scope searches. The HTTP fast path listens on 127.0.0.1 only — nothing is exposed to the network.

Development

node --test                # unit tests (any platform)
node --test test/integration.test.mjs   # needs a running Everything (Windows)

License

MIT