dsh-everything
DeepSeek Harness 插件：通过本地 Everything (voidtools) 索引，为代理提供毫秒级全磁盘文件搜索
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-everything@1.4.1Everything 以 dsh-everything 发布，当前版本为 1.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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.
es.exe) — installed automatically on first use (see below)With autoInstall: true (the default), the plugin provisions the backend by itself when it is missing:
es.exe to %LOCALAPPDATA%\dsh-everything\bin (per-user, no admin).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.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"
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.
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 innotes(useregex=truefor those). Encoding: the HTTP channel is UTF-8 natively; the es.exe fallback reads its UTF-8-export-jsonoutput — 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.
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. |
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.
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.
node --test # unit tests (any platform)
node --test test/integration.test.mjs # needs a running Everything (Windows)