← 返回列表
⚠ 装前注意
DSH 使用 Everythinges.exe 工具进行 NTFS 全盘搜索，使用 POSIX 风格路径进行交互，兼容…
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/10 · 已提供中文文档
DSH 使用 Everything(es.exe) 工具进行 NTFS 全盘搜索，使用 POSIX 风格路径进行交互，兼容 MSYS(git bash) 路径。
综合分
28.8
GitHub 分
28.8
用户评分
—
★ Stars
0
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add Rosmeowtis/dsh-es未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
信任档位：已验证本站已于 0 天前真实安装成功
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 本站已真实安装成功（非静态推断）
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 活跃：最近一次提交在 15 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
🟢实装验证通过· 2026/9/25
由本站实装验证器在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/21（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-es（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/24 11:38:35
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-subprocess@deepseek-ai/dsh-tools用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-es
面向 DeepSeek Harness 的全盘 NTFS 文件发现工具，由 Everything 的索引通过 es.exe 提供支持。
harness 自带的 glob/grep 仅限于工作区。此插件添加了 es_search，它能在毫秒级内从 Everything 索引中回答“这台机器上的……在哪里”——覆盖每一个已索引的卷——并且双向使用 POSIX 路径，因此 Windows 反斜杠永远不必在 JSON/工具调用转义层中存活。
要求
- Windows，且 Everything 1.4+ 正在运行（它拥有索引；es.exe 只是一个客户端）。
- es.exe 位于 PATH 中（随 Everything 一起提供；或用 config.executable 指向它）。
安装
pnpm install
dsh plugin --profile web add .
然后重启 profile（dsh web）。必须重启：bundle 层在启动时组合。dsh plugin add 会记录依赖并自动将 dsh-es 追加到 dsh.profile.bundles，因为此包声明了 dsh.bundle.patch。
无需启动即可验证组合后的树：
dsh --profile web --dump-config | Select-String es-search
配置
默认值位于 cordis.patch.yml。从你自己的 profile 的 cordis.patch.yml 覆盖该行（它最后应用）：
- id: es-search
config:
executable: 'C:/Program Files/Everything/es.exe'
maxResults: 500
| 键 | 默认值 | 含义 |
|---|---|---|
| executable | es.exe | 在 PATH 上解析的裸名称，或绝对路径。 |
| maxResults | 200 | 当模型省略 max 时的默认分页大小（硬上限 1000）。 |
es_search 工具
| 参数 | 含义 |
|---|---|
| query（必填） | Everything 查询文本：普通单词匹配文件名（以空格分隔的单词为 AND 关系），.zip / report?.docx 是通配符，过滤器可组合：ext:md handbook、size:>1gb ext:iso、dm:today folder:downloads、parent:D:/projects report。 |
| path | 限制到某个文件夹及其下级，POSIX 风格。相对路径相对于会话 cwd 解析。 |
| max | 分页大小（默认 maxResults，硬上限 1000）。 |
| regex | 使用 es.exe -r（Everything 正则）而非查询语法。 |
| matchPath | 将查询匹配到整个路径，而不仅仅是文件名（es.exe -p）。 |
| kind | any（默认）、files（/a-d）、folders（/ad）。 |
| sort | name、path、size、extension、date-modified、date-created、date-accessed、run-count，每个都有 -descending 变体。 |
返回 { query, results, count, max, truncated }，results 为 POSIX 形式。
路径约定
| 方向 | 示例 |
|---|---|
| 输入（path） | D:/ros/proj、/d/ros/proj（MSYS）、//server/share/proj、D:\ros\proj 均可接受；相对路径相对于会话 cwd 解析。 |
| 输出（results） | D:/ros/proj/app.ts —— 正斜杠，保留盘符。 |
盘符被保留而不是重写为 /d/...，这是有意为之：在 Windows 上，D:/x 对于所有其他 dsh 工具（Node、PowerShell、read、edit、glob）来说都是有效路径，而 /d/x 则不是，重写会导致结果无法作为后续参数使用。
注意事项
- 索引的是事实，而非实时扫描。 几秒前创建的文件可能尚未被列出；Everything 会在片刻内从 NTFS USN 日志中追赶上。
- Everything 必须正在运行。 否则 es.exe 会以退出码 8 退出，并显示 Error 8: Everything IPC window not found，该信息会原样作为工具错误呈现。
- 在 Everything 1.4 上正则表达式不可靠。 使用 -r 时，诸如 zip$ 这样的锚定模式在 1.4 安装上会静默地返回零行（退出码 0）；请优先使用 Everything 通配符（.zip）。不含元字符的模式确实有效。
- 以 - 开头的查询会被 es.exe 当作开关读取；工具会预先拒绝并给出该提示。请改用通配符搜索此类名称（*-report.txt）。
- 工作区之外的命中项只能由被允许访问它们的工具读取；沙箱仍然适用于你接下来所做的任何操作。
- 卷只有在 Everything 对其建立索引时才会出现（默认是 NTFS；exFAT/网络文件夹必须添加到其索引中）。
运行方式
每次调用使用一个 ctx.subprocess.spawn，并传入 argv 向量——不使用 shell，因此模型提供的查询中没有任何内容会被引号包裹或解释——另外还使用 resolveExecutable 进行 es.exe 查找，并将来自协作式工具超时（30 秒）的中止信号转发出去。退出码 0 即为成功，即使结果为零；其他任何退出码都会成为工具错误，并附带 es.exe 自身输出的第一行。
验证
npm test
覆盖纯逻辑层（双向路径转换、argv 组装、对 CRLF/BOM/重复项容错的解析）以及一次实时 es.exe 往返测试，当 Everything 或 es.exe 不可用时该测试会自行跳过。spawn 通过文件描述符而非管道写入，因此该检查也能在测试框架自身的 Windows 沙箱下运行。