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

🙏 致谢

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