dsh-at-file-everything

LIMITATIONS

已知限制

- **仅 Windows**，且效果取决于 Everything 的索引范围。未纳入索引的文件同样搜不到——`find_files` 与 `@` 都一样。 - **必须让 Everything 保持运行。** 服务停掉时插件会单独记录这一原因、补全返回空；`find_files` 会抛出指明了原因、并指向 `glob` 的错误。随包的 `es.exe` 提供的是**客户端**，不是服务，所以这种情况下帮不上忙。 - **随包客户端是固定版本。** 它是按 Everything 1.4 的延迟选的（见 `bin/README.md`）。若未来的 Everything 让 `count:` 过滤变便宜，更新的客户端才是更好的钉子；`PATH` 上或 `esCommand` 里用户自带的 `es.exe` 永远优先，所以这只影响依赖兜底副本的机器。 - **检索限定在文件名。** 带 `/` 的查询会列出该目录，但裸查询匹配不到「文件名里不含、只在深层路径里出现」的片段——这是用上游的路径子串匹配换来了索引路径约 30 倍的提速。`find_files` 只搜名字，同理。 - **`find_files` 是分页的，不是流式的。** 单次最多返回 500 条，超过就得收窄查询或提高 `limit` 翻页；结果里会说明这一点。 - **每次查询一个 `es.exe` 进程。** 每次查询都是新进程（预热后约 70–80 ms），取消会杀掉它。 - **Everything 索引处于冷态时**，首次查询可能需要约 1 s 让服务把索引换入；`timeoutMs` 覆盖这段等待，`deadlineMs` 覆盖进程本身。