跳到主要内容

使用Everything搜索文件

调用Everything提供的接口搜索文件

当前模块定义

sys:everythingsearch系统操作Action
标准模块
输入 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表示是。

    填写 输入或变量默认 false
  • 匹配整个单词matchWholeWordBoolean可选

    匹配整个单词。如 quicker.exe 将会匹配:quicker.exe, quicker.exe.config等。0表示否,1表示是。

    填写 输入或变量默认 true
  • 匹配路径matchPathBoolean可选

    匹配路径的不同部分,而不仅是文件名。

    填写 输入或变量默认 false
  • 匹配大小写matchCaseBoolean可选

    是否大小写敏感。0表示否,1表示是。

    填写 输入或变量默认 false
  • 使用正则匹配useRegexBoolean可选

    是否使用正则匹配。0表示否,1表示是。

    填写 输入或变量默认 false
  • 最大结果数量maxCountInteger必填

    -1表示不限制

    填写 输入或变量默认 100
  • 排序方式sortEnum必填
    填写 输入或变量默认 1
    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可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 路径列表pathListList
  • 结果个数resultCountInteger
  • 原始结果rawResultObject

【安全提示】20220908,有传说everything软件的更新服务疑似被劫持,参考: https://www.v2ex.com/t/878475

为安全起见,请关闭everything的自动更新服务(菜单-工具-选项-常规-启动时检查更新),如有需要,通过https://www.voidtools.com/手动下载版本更新。

使用本模块需要已安装和运行Everything软件1.4.1.969+或以上版本。

使用Everything搜索文件

调用Everything提供的接口搜索文件
搜索内容
 
要搜索的内容,格式与直接在everything软件中搜索时相同。
限定目录
 
可选。在指定目录下搜索(包含子目录)。
扩展名
可选。半角分号分隔的扩展名列表。如"txt;docx;xlsx;"
最大结果数量
100
-1表示不限制
排序方式
是否成功
-- 选择变量 --
操作是否成功
路径列表
-- 选择变量 --
结果个数
-- 选择变量 --
原始结果
-- 选择变量 --
步骤注释
 

参数

【搜索内容】要搜索的文件名关键词。 支持的语法请参考:https://www.voidtools.com/support/everything/searching/

注:已知everything的sdk调用不支持宏(如exe:``doc:等),具体请以实际测试为准。作为变通,可以使用ext:mp3;aac;...的格式筛选文件类型。

【限定目录】搜索指定目录下的文件(包含子目录)。此参数的作用为在搜索内容前面增加路径限定,效果类似于:

注意,需要在目录路径末尾添加``字符,否则将匹配以此内容为开始的所有目录。

也可以将路径直接添加到【搜索内容】中(特别是当需要指定多个路径时,可以在搜索内容中使用这样的格式:"C:\Program Files"|"D:\Work\" 关键词)。

【扩展名】搜索指定类型的文件。使用英文半角分号分隔多种扩展名,如doc;docx;docm

此参数在内部会以ext:doc;docx;docm的形式添加到搜索内容中(也可以直接在【搜索内容】参数中指定)。

【匹配完整文件名】完整匹配某个指定的文件名。

此参数的内部实现为在【搜索内容】前面追加wfn:参数,会对整个搜索内容生效。

【匹配整个单词】匹配整个单词。例如,搜索内容为“quicker.exe”时,匹配的文件名可能为“quicker.exe”、“quicker.exe.config”等。

【匹配路径】关键词匹配路径的一部分而不仅是文件名。

【匹配大小写】搜索的内容是否大小写敏感。

【使用正则匹配】是否使用正则表达式搜索文件。

【最大结果数量】最多返回的结果数量。

【排序方式】筛选结果的排序方式。某些排序方式可能会对搜索性能有一定影响,建议测试验证。

输出

【是否成功】是否成功执行了搜索。

【路径列表】搜索到的文件路径的列表。

【结果个数】搜索结果的数量。

【原始结果】是一个对象列表,如果有深入的需要,可以在表达式中使用这个结果。每个对象包含这些属性:

  • FileName:文件名(C# String类型)
  • FilePath:文件完整路径
  • Modified:最后修改实际(C# DateTime类型)
  • Size:文件大小(C# long类型)

安装Everything的注意事项

  • 下载网址:https://www.voidtools.com/zh-cn/
  • 根据您的电脑操作系统,选择 安装版64位,或安装版32位
  • 安装时使用默认选项。确保选择“安装Everything服务”选项。

已安装好的everything软件,也可以在工具-》选项 菜单中修改相关设置。

更新历史

  • 20240619 增加说明:限定目录参数需要以``结束。

更新于