dsh-everything
v1.4.1
Published
DeepSeek Harness plugin: millisecond whole-disk file search for agents via the local Everything (voidtools) index
Maintainers
Readme
dsh-everything
一个 DeepSeek Harness(DSH)插件,为模型注册 everything_search 工具:借助本机 Everything(voidtools)索引,实现毫秒级全盘文件/文件夹搜索。
当模型需要找文件时,不再递归遍历目录(glob),而是直接查询 Everything 预先建好的索引——即使磁盘上有数百万文件也是秒回。内部走两条通道:优先用 Everything 内置的 HTTP JSON 服务(仅绑定 127.0.0.1,插件会自动启用——每次调用无需再拉起进程、原生 UTF-8、精确总数免费自带),官方命令行 es.exe 作为兜底,覆盖 HTTP 服务表达不了的一切查询。
环境要求
- Windows(Everything 是 Windows 独占应用;其他平台上插件会注册一个明确报错的占位工具)
- Everything 1.4+ 与 ES 命令行工具(
es.exe)——缺失时插件会自动安装(见下文)
自动安装后端(默认)
autoInstall: true(默认)时,插件在检测到后端缺失后会自行准备环境:
- 从 voidtools.com 下载页解析最新稳定版 ES CLI,下载压缩包并把
es.exe解压到%LOCALAPPDATA%\dsh-everything\bin(用户目录,无需管理员)。 - 优先用
winget install voidtools.Everything安装 Everything;没有 winget 时下载最新稳定版官方安装包静默运行——两种方式都可能弹一次 UAC 授权框。 - 启动 Everything 并等待其 IPC 就绪后才执行搜索。
下载始终直连优先——无需任何代理工具,系统代理设置残留也不会影响安装;代理(HTTPS_PROXY/HTTP_PROXY 环境变量或 Windows 系统代理)只作为兜底。完整性校验:解析到的版本与 setup.js 记录的已知良好版本一致时做 SHA256 校验;更新的上游版本改验 voidtools 数字签名;下载页不可达时回退到已知良好版本(SHA256 校验)。校验失败一律中止安装。
插件还会保持自装的 es.exe 不过时:启动时会比对文件版本与插件内置的已知良好版本,落后才升级,且只升级自己装的副本(用户自装的 es.exe 永不动)。
想完全自己装后端,可设 autoInstall: false:
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"安装
在 DSH 会话中让插件管理器安装 npm 包名:
plugin_manager install_bundle,target = dsh-everything插件以 dsh-everything 激活,并为该 profile 下的所有 Agent 注册 everything_search 工具。已发布到 npm(dsh-everything),直接用本包目录安装也可以。
工具:everything_search
| 参数 | 类型 | 说明 |
|---|---|---|
| query (必填) | string | Everything 搜索表达式:report ext:docx、*.sln dm:thisweek、path:\projects\ ext:py。空格 = 与,\| = 或,! = 非。多词查询会自动拆分为 es.exe 的独立搜索词。 |
| path | string | 限定在某目录及其子目录内(绝对路径)。 |
| maxResults | integer | 返回条数上限(默认 100,封顶 1000)。 |
| offset | integer | 跳过前 N 条(分页)。 |
| sort | string | 排序,如 date-modified-descending、size-descending、name-ascending。键:name、path、size、extension、date-created、date-modified、date-accessed、run-count,可加 -ascending/-descending。 |
| regex | boolean | 把 query 当作全路径正则表达式。 |
| matchCase | boolean | 区分大小写(默认不区分)。 |
| wholeWord | boolean | 整词匹配。 |
| foldersOnly / filesOnly | boolean | 只看文件夹 / 只看文件。 |
| dateCreated | boolean | 一并返回每个结果的创建时间。 |
| countOnly | boolean | 只返回匹配总数——判断存在性、估量级的最快方式。 |
| exactTotal | boolean | 默认 true。设 false 时整页结果不再额外做一次计数往返,总数显示为 ≥N 下界。 |
返回 { query, total, totalExact, truncated, results: [{ path, size, dateModified, dateCreated? }], channel, notes }(channel 为 "http" 或 "es";notes 携带查询解释说明),在会话里以搜索路径卡片展示。
典型查询:report ext:docx · *.sln dm:thisweek · size:>500mb · notes !archive · 最近改动文件用 sort: date-modified-descending + dm:thisweek。
短语怪癖:带引号的短语只匹配文件名的“名字部分”,所以
"report.docx"永远搜不到——直接写不带引号的report.docx。整条查询就是一个含空格的引号短语(精确多词匹配)时,插件会自动转换成等价正则;与其他词混用的引号短语会退化为逐词 AND 并在notes里说明(这类场景请显式用regex=true)。 编码:HTTP 通道原生 UTF-8;es.exe 兜底通道从其 UTF-8-export-json输出读取——无论哪条通道,非 ASCII 文件名(中文、日文、emoji 等)都完整回传、不再乱码。
范围说明:只搜文件名和路径,不搜文件内容——内容搜索请继续用
grep。 覆盖说明:结果取决于本机 Everything 索引——NTFS/reFS 磁盘与显式加入索引的目录;FAT/exFAT 可移动盘与网络共享通常不在覆盖范围。
配置
在 cordis.patch.yml(或你 profile 的 patch 层)中修改插件 config:
| 键 | 默认值 | 说明 |
|---|---|---|
| esPath | 自动探测 | es.exe 的绝对路径。 |
| everythingPath | esPath 同目录 | Everything.exe 路径,供 autoStart 使用。 |
| autoStart | true | Everything 未运行时自动启动并等待其 IPC 就绪。 |
| autoInstall | true | 后端缺失时自动下载并安装 Everything + ES CLI(见上文)。 |
| installDir | %LOCALAPPDATA%\dsh-everything | 自动安装的 ES CLI 存放目录。 |
| maxResults | 100 | 单次返回条数默认上限。 |
| timeoutMs | 8000 | 单次调用超时(毫秒)。 |
| httpPort | 5151 | 快速通道的 Everything HTTP 服务端口;设 0 完全关闭 HTTP 通道。 |
| httpAutoEnable | true | HTTP 服务未开启时,每会话一次:自动改写 Everything 自身配置(解锁+启用+仅回环绑定)并重启其 GUI。设 false 则永不触碰 Everything 的配置。 |
| httpUsername / httpPassword | '' | HTTP 服务的可选 Basic 认证凭据。 |
快速通道:内置 HTTP 服务
Everything 1.4 自带 HTTP JSON 服务,但默认是关闭且被策略锁死的——安装版会在 Everything.exe 旁写入 allow_http_server=0,GUI 里也解不了锁。httpAutoEnable: true(默认)时插件会亲自翻开这个开关(每会话一次):同时补丁两份 Everything.ini、把服务只绑定到 127.0.0.1、重启 Everything GUI,之后搜索都走 HTTP。后台索引服务全程不受影响。
HTTP 通道覆盖:普通搜索、path/foldersOnly/filesOnly 范围限定、countOnly、分页,以及 name/path/size/date-modified 排序键。其余——dateCreated、其他排序键、regex 搭配 path 或类型过滤——自动改走 es.exe 通道。HTTP 服务起不来(端口被占、Everything 未安装)时插件静默留在 es.exe 通道、稍后重试;path 指向不存在的路径会直接报错,而不是返回空结果。
隐私
搜索范围是本机所有已索引磁盘,结果路径会作为工具输出发给模型。在目录结构敏感的机器上请注意,可用 path 参数收窄范围。HTTP 快速通道只监听 127.0.0.1——不向网络暴露任何东西。
开发
node --test # 单元测试(任意平台)
node --test test/integration.test.mjs # 需要运行中的 Everything(Windows)