使用Everything搜索文件
调用本机 Everything 的接口搜索文件。需要已安装并正在运行 Everything 1.4.1.969 或更高版本。
2022-09-08 有传闻称 Everything 更新服务疑似被劫持,参见 V2EX 讨论。请关闭「启动时检查更新」,需要时到官网手动下载。
当前模块定义
sys:everythingsearch输入 11 · 输出 4 · 枚举 2
输入参数
- 搜索内容
searchText必填要搜索的内容,格式与直接在everything软件中搜索时相同。
- 限定目录
folderText可选可选。在指定目录下搜索(包含子目录)。
- 扩展名
extText可选可选。半角分号分隔的扩展名列表。如"txt;docx;xlsx;"
5 个选项可执行文件、文档、图片
可执行文件bat;cmd;exe;msi;msp;scr;cpl文档c;chm;cpp;csv;cxx;doc;docm;docx;dot;dotm;dotx;h;hpp;htm;html;hxx;ini;java;lua;mht;mhtml;odt;pdf;potx;potm;ppam;ppsm;ppsx;pps;ppt;pptm;pptx;rtf;sldm;sldx;thmx;txt;vsd;wpd;wps;wri;xlam;xls;xlsb;xlsm;xlsx;xltm;xltx;xml图片ani;bmp;gif;ico;jpe;jpeg;jpg;pcx;png;psd;tga;tif;tiff;webp;wmf视频文件3g2;3gp;3gp2;3gpp;amr;amv;asf;avi;bdmv;bik;d2v;divx;drc;dsa;dsm;dss;dsv;evo;f4v;flc;fli;flic;flv;hdmov;ifo;ivf;m1v;m2p;m2t;m2ts;m2v;m4b;m4p;m4v;mkv;mp2v;mp4;mp4v;mpe;mpeg;mpg;mpls;mpv2;mpv4;mov;mts;ogm;ogv;pss;pva;qt;ram;ratdvd;rm;rmm;rmvb;roq;rpm;smil;smk;swf;tp;tpr;ts;vob;vp6;webm;wm;wmp;wmv音频文件aac;ac3;aif;aifc;aiff;au;cda;dts;fla;flac;it;m1a;m2a;m3u;m4a;mid;midi;mka;mod;mp2;mp3;mpa;ogg;ra;rmi;spc;rmi;snd;umx;voc;wav;wma;xm - 匹配完整文件名
matchWholeFilenameBoolean可选匹配整个文件名。0表示否,1表示是。
- 匹配整个单词
matchWholeWordBoolean可选匹配整个单词。如 quicker.exe 将会匹配:quicker.exe, quicker.exe.config等。0表示否,1表示是。
- 匹配路径
matchPathBoolean可选匹配路径的不同部分,而不仅是文件名。
- 匹配大小写
matchCaseBoolean可选是否大小写敏感。0表示否,1表示是。
- 使用正则匹配
useRegexBoolean可选是否使用正则匹配。0表示否,1表示是。
- 最大结果数量
maxCountInteger必填-1表示不限制
- 排序方式
sortEnum必填26 个选项名称顺序 NAME_ASCENDING、名称倒序 NAME_DESCENDING、路径顺序 PATH_ASCENDING
名称顺序 NAME_ASCENDING默认1名称倒序 NAME_DESCENDING2路径顺序 PATH_ASCENDING3路径倒序 PATH_DESCENDING4大小顺序 SIZE_ASCENDING5大小倒序 SIZE_DESCENDING6扩展名顺序 EXTENSION_ASCENDING7扩展名倒序 EXTENSION_DESCENDING8类型名顺序 TYPE_NAME_ASCENDING9类型名倒序 TYPE_NAME_DESCENDING10创建时间顺序 DATE_CREATED_ASCENDING11创建时间倒序 DATE_CREATED_DESCENDING12修改时间顺序 DATE_MODIFIED_ASCENDING13修改时间倒序 DATE_MODIFIED_DESCENDING14属性顺序 ATTRIBUTES_ASCENDING15属性倒序 ATTRIBUTES_DESCENDING16文件列表文件名顺序 FILE_LIST_FILENAME_ASCENDING17文件列表文件名倒序 FILE_LIST_FILENAME_DESCENDING18运行次数顺序 RUN_COUNT_ASCENDING19运行次数倒序 RUN_COUNT_DESCENDING20最后变更时间顺序 DATE_RECENTLY_CHANGED_ASCENDING21最后变更时间倒序 DATE_RECENTLY_CHANGED_DESCENDING22最后访问时间顺序 DATE_ACCESSED_ASCENDING23最后访问时间倒序 DATE_ACCESSED_DESCENDING24最后运行时间顺序 DATE_RUN_ASCENDING25最后运行时间倒序 DATE_RUN_DESCENDING26 - 失败后停止
stopIfFailBoolean可选失败后是否停止动作
输出参数
- 是否成功
isSuccessBoolean操作是否成功
- 路径列表
pathListList - 结果个数
resultCountInteger - 原始结果
rawResultObject
概述
使用Everything搜索文件
参数说明
搜索内容:关键词,语法与 Everything 软件本身相同,见 官方搜索说明。SDK 调用不支持 exe:、doc: 这类宏;筛选类型请用 ext:mp3;aac 或下面的 扩展名。
限定目录:只搜该目录(含子目录)。模块会把路径加到搜索内容前面,效果相当于在 Everything 里写成 "c:\program files\" quicker.exe。路径末尾必须带 \,否则会匹配所有以此开头的目录。多个目录请直接写进 搜索内容,例如 "C:\Program Files"|"D:\Work\" 关键词。
扩展名:半角分号分隔,如 doc;docx;docm。内部会追加 ext:doc;docx;docm。下拉里有可执行文件、文档、图片、视频、音频等预设。
匹配完整文件名:内部在搜索内容前加 wfn:,对整段搜索生效。
匹配整个单词:默认开启。搜 quicker.exe 时,也可能命中 quicker.exe.config。
匹配路径:关键词也匹配路径的一部分,不只文件名。
匹配大小写:是否区分大小写。默认关闭。
使用正则匹配:是否按正则搜索。默认关闭。
最大结果数量:最多返回多少条,默认 100;-1 表示不限制。
排序方式:点开下拉看当前全部选项。部分排序会影响速度,建议先试。
失败后停止:搜索失败是否中止动作。默认开启。
输出
- 是否成功:是否完成搜索。
- 路径列表:找到的文件路径。
- 结果个数
- 原始结果:对象列表,表达式里可继续用。每项常见字段:
FileName(文件名)、FilePath(完整路径)、Modified(最后修改时间)、Size(大小)。
安装 Everything 的注意事项
- 到 https://www.voidtools.com/zh-cn/ 下载 安装版 64 位 或 安装版 32 位。
- 安装时用默认选项,并勾选 安装 Everything 服务。
- 建议勾选开机自动启动,这样 Quicker 调用时服务已在运行。
已经装好的,可在「工具 → 选项」里改同样两项:随系统自启动、Everything 服务。不要开「启动时检查更新」。
限制与排障
- Everything 没装、没运行,或版本低于 1.4.1.969,本模块会失败。
- 限定目录末尾漏了
\,会搜到其它以这段文字开头的路径。 exe:/doc:宏不可用,改用ext:或 扩展名。
相关链接
更新历史
- 20240619 说明:限定目录需要以
\结束。
更新于