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）profile 的 node_modules 中有 koffi（DSH 自带）

🛠️ 安装

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

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

⚙️ 配置

字段	默认	说明
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 插件规范

📄 License

MIT

🙏 致谢

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