dsh-tool-everything
DSH（DeepSeek Harness）的 Everything 搜索工具插件。给 DSH Agent 注册
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
🙏 致谢
