全盘秒搜 Luoning77/dsh-tool-everything

dsh-tool-everything

DSH（DeepSeek Harness）的 Everything 搜索工具插件。给 DSH 智能体注册 everything_search 工具：借助 Everything 索引，按文件名全盘秒搜 Windows 文件系统。

🚀 零配置：无需启用 Everything HTTP 服务器，无需 es.exe，不改 Everything 的任何设置。只要 Everything 在运行，装完插件就能用。

✨ 特性

- ⚡ 极速：直接调用 Everything SDK（koffi FFI），走 IPC 通道——毫秒级响应
- 🔍 完整语法：通配符 *.pdf、path:C:\code、ext:zip、size:>10mb、regex:、| 或、! 非
- 🎯 结构化结果：返回路径 + 文件大小 + 是否文件夹，UI 自动渲染搜索卡片
- 📦 零依赖安装：自带 Everything64.dll，无需系统安装任何额外组件
- 🔥 DSH 原生：Cordis 插件，支持 HMR 热重载，无需重启 DSH

📋 前提

- Windows 系统
- Everything 正在运行
- DeepSeek Harness（DSH）0.1.0-rc.6 ~ 0.2.x（含 0.2.1-rc.2；koffi 由 DSH 自带）

🛠️ 安装

dsh plugin --profile web add "github:roxyyn0304/dsh-tool-everything"

装完硬刷新浏览器（Ctrl+Shift+R），新开会话即可使用。

⚠️ 请确认安装的是 0.2.1 及以上版本。0.2.0 的 peerDependencies 只声明了 ^0.1.0-rc.6，会被 DSH 0.2.x 的兼容性检查判为不兼容并拒绝安装（报错 incompatible-version）。0.2.1 起改用 engines.dsh: ">=0.1.0-rc.6 <0.3.0-0" 声明兼容范围。

从旧版本升级

dsh plugin --profile web add "github:roxyyn0304/dsh-tool-everything"

若之前装过 0.2.0，重新执行上面的 add 即可覆盖。若 profile 里残留了 0.2.0 的版本豁免（compatibility.json），升级后可以删掉，不再需要。

⚙️ 配置

| 字段 | 默认 | 说明 |
| maxResults | 100 | 单次返回结果上限 |
| timeoutMs | 30000 | 工具超时预算（ms） |
| everythingDllPath | 包内 native/ | 自定义 Everything64.dll 路径（一般不用） |

❌ 错误码

| code | 含义 |
| EVERYTHING_SDK_LOAD_FAILED | 找不到或无法加载 Everything64.dll |
| EVERYTHING_NOT_RUNNING | Everything 未运行 |
| SEARCH_ABORTED | 工具被超时/用户取消终止 |

🧩 技术细节

┌─────────────────────────────────────────────┐
│ DSH Agent (你) │ │ 调用 everything_search("npm", max=10) │ ├─────────────────────────────────────────────┤ │ dsh-tool-everything (本插件) │ │ koffi FFI → Everything64.dll │ ├─────────────────────────────────────────────┤ │ Everything SDK (IPC 通道) │ ├─────────────────────────────────────────────┤ │ Everything.exe (全盘 NTFS 索引引擎) │ └─────────────────────────────────────────────┘

- Everything64.dll 来自 Everything SDK 1.5
- FFI 通过 koffi 实现（DSH 自带）
- 插件单文件 lib/index.js，ESM 模块，Cordis 插件规范
- 版本兼容：engines.dsh 声明 >=0.1.0-rc.6 <0.3.0-0，同时保留 peerDependencies 的 ^0.1.0-rc.6 || >=0.2.0-rc.1 <0.3.0-0 双区间，让 0.1.x 与 0.2.x 两代运行时都能通过 DSH 的兼容性检查

📄 License

MIT

🙏 致谢

- voidtools — Everything 文件搜索引擎
- koffi — Node.js FFI 库
- deepseek-ai/deepseek-harness — DSH 智能体框架