事先说明

在介绍过程中，所有技巧均按XYplorer英文版进行说明，中文版的用户请自行对照。因为许多参考和官网文档都是英文的，我翻译过来还要用中文来写每个界面的按钮，太麻烦了也不利于深度使用。

第一，本文阅读最好连同Updates目录一起下载到本地，使用Typora进行阅读，阅读时打开“大纲”功能，选择你需要的章节阅读。

友情提示：下载速度慢的可以去下载一个Tampermonkey插件——Github 增强 - 高速下载，安装后不管是clone还是下载zip都可以选择分流节点。

第二，更新频率和内容。不定期更新，也可能不更新。同时更新的内容大多都是个人长期使用过程中遇到的问题和需求。

第三，提问和解惑。可以Google或者参考官方帮助文档，按F1呼出，若无法呼出，请下载XYplorer.chm。

提问的魔法进修课:point_right:Stop-Ask-Questions-The-Stupid-Ways。

第四，本文参考来源主要包括Google搜索、XYplorer Beta Club、官网帮助文档。

有时，为了书写方便，我会把XYplorer简称为XY。

第五，所有的图片都保存在Image文件夹，不上载到图传是因为鬼知道哪天图片服务器和存储器会不会突然坏掉。

20191011

使用过程中出现崩溃的原因和解决方法

出现崩溃现象效果如下图

会出现一个Coffee的俯视图。

原因就两种，具体看图片红字描述。

减少或避免出现崩溃的方法

选中非最后一个标签页，然后新建标签页
尽量少用设置(Configuration(F9))按钮，如果要用，记得在File -> Save Setting，否则会丢失本次打开的使用记录。

20200311 ~ Now

[Pin]关于XYplorer Scripting的一些事

XYplorer Scripting简介

XYplorer Scripting说白了就是用于XY的脚本文件。

快速入门

官网XYplorer - Tour - Scripting给出一份快速入门（英语版），介绍了Scripting可以用来干什么，如何编写和测试，以及一些简单的测试实例。

当然，初入使用XY的朋友们，你们不喜欢Scripting，可以先看下[XYplorer Native Variables]部分，因为这一部分在这份Markdown中会经常用到。

用什么语言开发的？

XY使用Visual Basic 6开发的，并且编译为本地代码(Native code)，以获取更快的运行速度[?]。

XYplorer Script用什么程序语言写成的，我们不得而知，不过Script借用了许多来自php特性(比如字符串的连接可以.来完成)。

完善的教程其实在帮助文档中

就像我们学习新的语言一样，它应该有规则和例子供beginner来学习。

具体用法和示例在XYplorer.chm->Content选项卡->Advanced Topics中的Scripting和Scripting Commands的部分。如何寻找这部分呢？在XYplorer菜单栏Help->Cotents and Index(F1)中，其中F1调用的是XYplorer目录下的XYplorer.chm(若无，可以在本GitHub Page中下载)，或者Help->Help on Scripting Commands切出帮助文档。

在确保已经下载Xyplorer.chm，并将其放置于XY目录下，在地址栏输入以下内容也可以进入Scripting部分：

rtfm "idh_scripting.htm";

地址栏输入如下内容，进入Scripting Commands部分：

rtfm "idh_scripting_comref.htm";

[Everybody]XYplorer Native Variables

作为XY Scripting,这一部分会经常用到，即使不学Scripting也建议看完，挺简单的。

下面是XYplorer Native Variables的部分实例：

设当前XY目录位于C:\PortableApps\XYplorer;设当前目录位于F:\PictureLib

目录结构如下，

C:\PortableApps\XYplorer>tree
Folder PATH listing for volume OS
Volume serial number is 080B-2E29
C:.
└─Data
    ├─AutoBackup
    ├─Catalogs
    ├─FindTemplates
    ├─Icons
    ├─NewItems
    │  └─New folder
    ├─Panes
    │  ├─1
    │  │  └─t
    │  └─2
    │      └─t
    ├─Paper
    ├─Scripts
    │  └─Everything
    ├─Temp
    └─Thumbnails

在地址栏分别输入::msg <xypath>、::msg <xydata>、::msg <xyicons>、::msg <xyscripts>、::msg <xypaper>、::msg <xycatalogs>、::msg <xynewitems>、、::msg <curpath>，结论如下，

<xypath> = C:\PortableApps\XYplorer
<xydata> = C:\PortableApps\XYplorer\Data
<xyicons> = C:\PortableApps\XYplorer\Data\Icons
<xyscripts> = C:\PortableApps\XYplorer\Data\Scripts
<xypaper> = C:\PortableApps\XYplorer\Data\Paper
<xycatalogs> = C:\PortableApps\XYplorer\Data\Catalogs
<xynewitems> = C:\PortableApps\XYplorer\Data\NewItems
<curpath> = F:\PictureLib

::msg <curname>的输出需要选中一个文件，比如鼠标选中F:\PictureLib\a.png，那么输出

F:\PictureLib\a.png

什么都不选中，则输出空白（即什么都没有）。

更多XYplorer Native Variables介绍，请参考XYplorer.chm->左上方Inbox->输入XYplorer Native Variables。或者XY地址栏输入：

rtfm "idh_variables.htm";

标识符集 | Tags

弄清楚Label,Tag,Comment区别

这里要介绍Tags，那么就有必要先说明下关于菜单栏Tags(标签)在英文XY界面菜单栏与中文XY界面的翻译。对应语义如下：

Tags	//标签
Tag		//标签
Label	//标注
Comment	//备注

其实这个翻译真心容易混淆，还不如英文Label, Tag, Comment来得清晰。

Oxford Advanced Learner's Dict给出的释义：

Tag

[C] (computing 计) a set of letters or symbols that are put before and after a piece of text or data in order to identify it or show that it is to be treated in a particular way

可见Tag中包含标识的意义。

我认为菜单栏Tags应该翻译为标识符集，即"a set of tags"的意思。

至于Label与Tag最大的区别在于是否有胶粘剂，Label是带粘合剂的标签，比如我买回来的固态硬盘中，有一个白色标签(Label)：

而Tag对应的例子是你买回来一件衣服，衣服上的价格标签就是Tag。因为Tag没有粘合剂，它是以其他形式附上物品上以辨识和解释物品。很明显，价格标签是通过一串线系上衣服上的，并没有粘合剂。

这样就区分出了Tag和Label，所以你会可以看出XY中Label是色彩标签且粘在文件(Item)上，而Tag是附在文件上的说明，具体表现为Column Tag：

至于Comment就更简单了，就是对文件的评论，解释。

开启Label,Tag,Comment列

-先备份当前列到<xydata>\Columns目录下。

由于我有四列，请按照列表顺序命名，方便区分和加载，由此我的命名为Modified-Ext-Size-Created.txt。

-添加新列Label, Tag, Comment

命名为Modified-Ext-Size-Created-Label-Tags-Comment.txt保存到<xydata>\Columns目录。

-加载布局Layout，按需加载布局。

简易版按Tag搜索

比如Anime-冰菓文件夹有一个“推理日漫”的Tag，我想要搜索这个标签，该如何做：

具体的Script名为CurpathSearchByTags.xys，我会放到Scripts文件夹中。在这里给出脚本内容：(注意前面都有一个Tab)

	$input="*".input("Search Items By Tags on the current path", “请输入Tags关键字”)."*"; 
	goto "<curpath>?tags:"$input" /r";

关于怎么安装这个Script，请参考用户自定义命名的使用中的设置快捷键调用Notepad的部分的设置方法。

使用

脚本启动后，支持如下输入：(给出常用的匹配逻辑AND, OR)

*o*	//匹配包含o的Tag
xy* | pro*		//匹配以xy开头 OR pro开头的Tag
d*,u*		//匹配d开头 AND u开头的Tag

效果如下

可以看到使用通配符*和?是十分必要的。若不使用通配符，比如输入apple,那么匹配Tag就必须是apple，如果有个Tag是apple2，那么也不会被匹配到。

参考

脚本参考：Function ID for 'Find by Tags'? - XYplorer Beta Club

地址栏如下内容以参考更多帮助：

rtfm "idh_find.htm#idh_findfilesbytags";	//"Wildcards in Tags" section.

定制文件列表 | Customize List

以下内容讲解都是在视图方式为“详细”(Details)的情况下进行的，操作如下图所示:(菜单栏/工具栏进行视图设置，二选一)

在菜单栏中可以找到，如下图所示：

这是我为列表设置的参数，几个打钩的选项都是常用的。

Rename On Slow Double-Click:推荐。双击可进行文件命名。注意，双击每次点击的时间间隔长一点。

Highlight Selected Row：选项勾选后，其背景颜色由如下图决定：

设置->Colors and Styles->Colors->Selected Rows

Full Row Select:不推荐，选中一个文件后，那么整行都被选择，鼠标在整行范围内双击都是打开文件。而使用Highlight Selected Rows后，高亮背景色范围内双击是返回上一级路径。

Autosize Columns:推荐，该选项可以让文件列表的所有列信息显示完整，也就是每个列都进行最大有效范围的拉伸。

Show Folder Size:不推荐。因为开启后每次浏览需要读取文件夹大小。如果文件夹大小过大，会让加载速度变慢。

加载速度有效改善的方法：

设置->Tree and List->List->Cache folder sizes

该选项可以加快浏览文件列表的速度，但是无法保证第一次计算的文件夹大小的准确性。再次计算文件夹大小可保证目标文件夹的有效性，操作如下图所示：

关于Cache folder sizes的作用详细说明，请在地址栏输入：

rtfm "idh_settings.htm#idh_foldersizecaching";

自定义列 | Custom Column

基本术语

什么是Column Layout?

所以文件统称为项目(Item)。

XY界面的布局是什么意思？布局就是各种组件的位置摆放以及是否摆放。组件有状态栏，树，目录，自定义列等等。

每个文件夹中所有items都有自己的列，这个列表取决于你如何设置Column Layout的参数。

什么是Column, Custom Column, Extra Column?

设置列布局 | Column Layout

添加列的方法

列属性的类型

一个列中可以载入三种类型的属性：Property, Special Property, Custom Column

对于Custom Column可以配置它的载入属性还多出了三种：Script, Template, Mixed:

定制属性列 | Property

[案例1]添加文件属性项列

定制自定义列

参考Overview of custom column snippets / scripts - XYplorer Beta Club

[案例1]Image size in inches

地址栏输入::snippet

在提示框中输入

Snip: CustomColumn 1
  XYplorer 18.90.0000, 22.03.2018 12:28:38
Action
  ConfigureColumn
Caption
  Size (inches)
Type
  3
Definition
      $dpi = get("Screen", "dpi");
      $hSize = property('System.Image.HorizontalSize', <cc_item>);
      $vSize = property('System.Image.VerticalSize', <cc_item>);
      if (!$hSize || !$vSize) { return "<unknown size>"; }
      return round(($hSize / $dpi), 2) . " x " . round(($vSize / $dpi), 2);
Format
  1
Trigger
  1
Item Type
  0
Item Filter
  {:Image}

这样就添加了名为Size (inches)的自定义列了，效果图如下
添加自定义列

这样就添加好了。

[案例2]Resolution

地址栏输入::snippet，在提示框中输入如下内容

Snip: CustomColumn 1
  XYplorer 18.90.0000, 22.03.2018 12:28:38
Action
  ConfigureColumn
Caption
  DPI
Type
  3
Definition
      $hSize = property('System.Image.HorizontalSize', <cc_item>);
      $vSize = property('System.Image.VerticalSize', <cc_item>);
      if (!$hSize || !$vSize) { return "<unknown size>"; }
      return $hSize." x " .$vSize;
Format
  1
Trigger
  1
Item Type
  0
Item Filter
  {:Image}

按照[Image size in inches]的方法添加DPI列到列布局中。

文件数量过多时Column加载卡顿的解决方法

文件数量过多会卡，这是XY应该背的锅吗，我认为责任应该对半分，因为这些文件要使用Shell Properties读取属性，然后将这些属性显示到Custom Column中，那么从软件层次考虑，速度取决于读取属性的速度(Windows侧)和载入到Custom Column(XY侧)的速度，XY侧再深入点讲，也要考虑到使用Script中涉及遍历的情况。可能会有人说，干吗不用到缓存技术，其实我也在想为什么不用到缓存技术呢，并不是XY没有使用到这一技术，只不过XY没有运用缓存技术到部分Custom Column上。因此，许多自定义列会卡的原因就在这里，也就是你打开文件夹，XY就开始扫描并载入属性到文件列这个过程卡，这取决你的文件数量。当然，我们可以利用Extra Tag进行模拟缓存（在下面会讲到），也或者改变载入自定义列的触发方式。

方法一:改变载入Custom Column的触发方式

-进入Custom Column配置界面。有两种方法

方法一。如下图所示，

方法二。F9呼出设置界面，按如下图所示进行操作，

主要改变的是Trigger参数，这里有三个，各有优缺点，其中List和Click都可以避免大量文件时的卡顿。

关于Click的运用场景就是：

添加一个关键字包含"MD5"的Custom Column，而不是Column，然后配置其触发方式为Click，然后再需要使用的时候点击MD5对应的Custom Column，读取MD5

Trigger参数介绍

地址栏输入：

rtfm "idh_customcolumns.htm";		//进入后，找到Trigger黑体字标题部分

可找到对应的英文解释，在这里给出：

Trigger

Here you can select at which point the script or process that generates the cell data is actually triggered. You have three choices:

Browse [Default]: Column is triggered when the list is filled with folder contents or search results.

List: Column is triggered when the items are listed. Only the currently visible items are processed. This option will be much faster than "Browse" on long lists, but the scrolling will be not as smooth.

Click: Column is triggered when the symbol that is shown as a placeholder is clicked (actually you can click anywhere in the cell). Maximum speed, also when scrolling. All data are only shown on demand.

Notes:

When you right-click a column header and select Refresh Column then the whole column data will be generated/refreshed.

Columns of type "Mixed" inherit the trigger per-cell from the chosen sub-column.

When Custom Columns of type Script are triggered by Click and the script has no "return" command then the click symbol remains in the list and can be clicked again and again.

利用Extra Column手动模拟缓存

下面模拟对所有文件列表加载DPI属性，效果如下，

这样做的好处是所有文件列需要DPI的属性都导入到Extra Column1中了，这样持久化的数据就避免了大量使用Shell Properties加载。

该脚本的功能是扫描当前文件夹的图片，若有子文件是不会去遍历的。该脚本一旦开始，无法结束，也就是你只能等待脚本执行结束，否则选择强制结束进程。这不是意味着脚本使XY卡住了，而是大量IO读写，能处理多快与磁盘性能有关，若扫描的文件处于磁盘坏道或扇区上，会造成卡死。

如果你一个文件夹有上万个图片，老实说我也不知道执行得有多慢。

	sel 1;
	while (<curitem> != "") {
		// msg <curitem>;
		$dims = property("#image.dimensions", <cc_item>);
		$width = gettoken($dims, 1, " x ");
		$height = gettoken($dims, 2, " x ");
		tag $width." x ".$height, <curitem>, "ex1";
		sel + 1;
	}

脚本已经贴出。

添加到目录栏的方法是添加一个项目Insert到目录，其中Location填写如下内容

::load <xyscripts>."\名称.xys";	//脚本文件请放在XY/Data/Scripts文件夹

Extra Column的命名通过以下方式实现，

参考

video folder with special custom columns opens slow - XYplorer Beta Club https://www.xyplorer.com/xyfc/viewtopic.php?t=18715

Slow Loading of Large Folders - XYplorer Beta Club https://www.xyplorer.com/xyfc/viewtopic.php?t=19296

Folders with a lot of files charge very slow - XYplorer Beta Club https://www.xyplorer.com/xyfc/viewtopic.php?f=3&t=19090&p=160050#p160050

地址栏输入可阅读涉及主题的参考：

rtfm "idh_customcolumns.htm#idh_ccscriptedcolumns";		// Scripted Columns
rtfm "idh_scripting_comref.htm#idh_sc_property";		// property()
rtfm "idh_variables.htm";		// XYplorer Native Variables
http://msdn.microsoft.com/en-us/library/windows/desktop/dd561977%28v=vs.85%29.aspx		// the locale-independent Windows canonical properties

保存和加载Column Layout

为了定制自定义列用于显示不同类型的文件，比如视频文件的自定义列有播放时间，分辨率，Codecs等等；音频文件需要的自定义列有Codecs，播放时间，Sample Rate等等；图片文件需要自定义列有DPI，Album，照相机类型，拍摄时间等等。由此定制自定义列显得必要，我们需要保存自定义列，在需要的时候进行加载。

-保存Column Layout

Column Layout的文件命名应该符合以下的格式，才会清晰便于确定列的顺序：

第1列名-第2列名-...-第N列明.txt

-加载Column Layout

在自定义列空白处右键->Load Column Layout...->选择想要的列布局。

自定义列布局应用到特定文件夹

假设你有StudyLib, PictureLib, Pothole, VideoLib这几个文件夹，分别装着同类的文件。如果你想让每个文件夹及其子文件都按需显示不同的自定义列，那么你就需要分别对StudyLib, PictureLib, Pothole, VideoLib的文件夹视图设置中勾选Cloumn layout，并且勾选Include subfolders：

Folder to apply the settings to的匹配规则：

F:\StudyLib	//匹配在F盘的StudyLib文件夹
*\Images*	//匹配所有名为Images(不区分大小写)的文件夹
*\Images*|*\Pics*	//匹配所有名为Images(不区分大小写)和Pics(不区分大小写)的文件夹

Match case: 勾选后，匹配时会区分文件大小写，比如*\Images*不会匹配名为images的文件夹。

这个地方我没法讲台细，等我用到就会补上一个具体案例，如果要讲解我会新起一个一级标题来讲"文件夹视图设置"。

定制化文件夹图标 | Customize File Icons(CFI)

CFI配置方法

File Icons的配置在XYplorer.ini中：以下内容就摘自此文件

[FileIcons]
Count=17
1=+readme.*>Papirus-Team-Papirus-Mimetypes-Text-x-readme.ico
2={:Image}>Papirus-Team-Papirus-Mimetypes-Image-x-generic.ico
3=+xys>Papirus-Team-Papirus-Mimetypes-Text-x-script.ico
4=+sql>Papirus-Team-Papirus-Mimetypes-App-x-sqlite-2.ico
5=+h>Papirus-Team-Papirus-Mimetypes-Text-x-chdr.ico
6=+readme.txt>Papirus-Team-Papirus-Mimetypes-Text-x-readme.ico
7=+c>Papirus-Team-Papirus-Mimetypes-Text-x-csrc.ico
8=+txt>Note Pad.ico
9=+md>Text Editor Typora.ico
10=+hex>Papirus-Team-Papirus-Mimetypes-Text-x-hex.ico
11=py>Python.ico
12=+java>Papirus-Team-Papirus-Mimetypes-Text-x-java.ico
13=+log>Papirus-Team-Papirus-Mimetypes-Text-x-log.ico
14=+cpp>Papirus-Team-Papirus-Mimetypes-Text-x-c-plus-plus-src.ico
15=+css>Papirus-Team-Papirus-Mimetypes-Text-css.ico
16=+py>Papirus-Team-Papirus-Mimetypes-Text-x-python.ico
17=+makefile>Papirus-Team-Papirus-Mimetypes-Text-x-makefile.ico

效果大概就是这样子的：

CFI语法

使用CFI定义可以对符合匹配规则的文件进行图标替换。

参考

更多参考CFI，请在XY地址栏输入：

rtfm "idh_cfi.htm";

定义

CFI定义如下：

"Caption" Pattern(s)>Icon Source

"Caption"[可选]:个人注释

Pattern(s)[必须]:匹配规则

Icon Source[必须]:图标目录。

比如，

txt;ini;xml>xxx.ico //图标位于<xyicons>/xxx.ico。匹配文件格式是.txt, .ini, .xml

注释

除了可以用双引号括起来并放置到最前面作为个人注释，还可以使用//。

//：注释符。当匹配项目被执行时，注释符前面的空格都会被剔除。

*.txt>Houellebecq.ico //comment

用例

从帮助文档(F1)摘出来的：

%computer%    matches the Computer special folder
%desktop%     matches the Desktop special folder
%personal%    matches the Personal special folder
%user%        matches the User special folder
%net%         matches the Network special folder
%recycler%    matches the Recycle Bin special folder
E:\           matches drive E:\
E:\*\         matches all folders in E:\
E:\ /r        matches all folders in E:\ and E: itself
E:\Jobs\*\    matches all folders in E:\Jobs\
[F-L]:\*\     matches all folders on drives F-L
*\            matches all folders that have no specific icon
**\           same as above for the current tree folder
pics\         matches all folders named "pics"
E:\*          matches all files in E:\
pics\*        matches all files in folders named "pics"
pics*\*       matches all files in folders beginning with "pics"
*.jpg;*.png   matches all JPG and PNG files
*.fnd         matches all FND files and is used for Search Results
*.            matches all files with no extension 
*?            matches all files of unknown file type
*23*          matches all files containing "23" in the name
*2013*.txt    matches all TXT files containing "2013" in the name
readme.txt    matches all files named "readme.txt"
<xyicons>\*   matches all files in the default Icons folder
\\Wagner\     matches server "Wagner"

问：我的文件夹都已经自定义图标了，这个File Icons设置的图标会不会覆盖Window设置的图标呢？

答：符合条件的File Icons会替换Windows设置的图标的。不过可以加下参数保留Windows设置的图标。

在帮助文档中已经给出了答案：

图标资源

如何找到Icon资源呢？

Caption	Site
Icon Archive	https://iconarchive.com/
我自己收集的到的	https://pan.baidu.com/s/1q39yFrAQF1v8jTlzPba_fg zdif

如何找出需要的命令?

按钮和用户自定义命令区别

工具栏上的都是按钮，这些按钮中，用户自定义的按钮(User Button)都是没办法分配快捷键的。

如果需要使用快捷键关联什么操作，那就需要使用用户自定义命令(User-Defined Commands)。

Buttons are meant for the mouse. UDCs are meant for the keys.[?]

工具栏的使用 | Toolbar

工具栏的摆放和使用

一个合理的工具栏按钮摆放，可以提高使用效率。这是我的工具栏按钮摆放(2020/11/10)：

按钮的高级用法

[案例1]使用Windows文件管理器打开XYplorer当前路径

-使用效果如下，

-具体方法如下，

1.提取图标。提取工具IcoFX3(下载地址若失效，自行下载)[可选]

2.添加按钮

内容信息如下

Explorer
<xyicons>\Explorer.ico
run "C:\Windows\explorer.exe" <curpath>

这个脚本不完善，仅限打开当前目录。需要功能更全的Explorer脚本，可以使用设置快捷键调用Explorer的脚本。

<xyicons>介绍请参考关于XYplorer Scripting的一些事

-END

[案例2]CMD集成到按钮

XY官网已经把Cmd的按钮集成到工具栏了，并且提供了热键Ctrl + Alt + P。

你现在可以在自定义工具栏中的列表中找到它，

不过下面我还是给出用户自定义Cmd按钮的方法。

按钮信息如下，

Cmd as Admin
<xyicons>\Cmd.ico

$comspec = ("%osbitness%" == 64) ? "%windir%\System32\cmd.exe" : "%windir%\SysWOW64\cmd.exe";
    $cscript = ("%osbitness%" == 64) ? "%windir%\System32\cscript.exe" : "%windir%\SysWOW64\cscript.exe";

    $vbsFile = "%TEMP%\~OpenElevatedCMD.vbs";

    $vbsContent = <<<>>>
        Set UAC = CreateObject("Shell.Application")
        UAC.ShellExecute "$comspec", "/k pushd ""<curpath>""", "", "runas", 1
>>>;

    writefile($vbsFile, trim($vbsContent));

    if (get("trigger") == "1") { // Left click -> Admin
        run """$cscript"" ""$vbsFile"" //nologo", , 0, 0;
    } elseif (get("trigger") == "2") { // Right click -> No admin
        run """$comspec"" /k pushd ""<curpath>""";
    }

按钮的添加方法在“按钮的高级用法”[?]部分有讲到。

使用评价：

这个cmd其实也不是很好用，也没有快捷键可以调用按钮，再加上XY官网已经集成了Cmd按钮。下面还是会给出一些替代方案。

Alternative Solution 1(比较笨(～￣(OO)￣)ブ): 偶尔我还是会Win + R来启动cmd，进入cmd，切换盘符（比如f:Enter)，然后在XYplorer某个目录下Alt + D Ctrl + C复制路径回到cmd粘贴。

Alternative Solution 2(我未测试过): 你也可以先把cmd集成到Windows右键的Context中，然后将windows右键菜单添加到XYplorer，XYplorer中使用Windows右键ContextMenu调用cmd。我不想折腾了，要命了。

Alternative Solution 3(推荐): 你完全可以使用XYplorer集成的Windows文件管理器按钮打开Explorer.exe[?]，使用Windows自带的文件管理器空白处右键运行cmd[?]。

用户自定义命令的使用 | User-Defined Commands

设置快捷键调用Notepad

创建OpenWithNotepad.xys存放在XYplorer/Data/Scripts目录下，内容如下，

	if (<curitem> != "" && filetype(<curitem>) != "Nofile") {
		run notepad "<curitem>";
	}

添加命令方法：User->Manage Commands...->Category:Load Script File->New-Add New Command填写Caption和Script File

Assign Keyboard Shortcut... ，我设置的Alt + 3。

Caption:Open With Notepad
Scripts Files:<xyscripts>\OpenWithNotepad.xys

使用方法：选中文件，Alt + 3速度调用notepad打开文本。

设置快捷键调用Explorer

设置方法同上，创建OpenWithExplorer.xys存放在XYplorer/Data/Scripts目录下，内容如下，

	if (<curitem> == "") {
		run "C:\Windows\explorer.exe" <curpath>
	} else {
		if (filetype(<curitem>) == "Nofile") {	//选中的是目录
		run "C:\Windows\explorer.exe" <curitem>
	}
		else {	
			run "C:\Windows\explorer.exe" <curpath>
		}
	}

我分配的快捷键是Ctrl + Alt + E

Caption:Open With Explorer
Scripts Files:<xyscripts>\OpenWithExplorer.xys

在XYplorer中使用QuickLook

QuickLook (此处下载)

-具体方法如下，

1.在你的XYplorer目录\Data\Scripts下在创建一个.xys脚本文件，命名为Run QuickLook.xys，内容如下

run "你的QuickLook目录\QuickLook.exe" "<curitem>";

2.然后，按下图完成设置，

我这里分配的按键Alt+1

Script File内容如下

<xyscripts>\Run QuickLook.xys

3.最后，请关闭语法检查，具体方法如下，

若未关闭语法检查，使用QuickLook配合快捷键会出现这样的错误，

4.方法介绍完了，使用时，先选中要预览的文件，然后Alt+1即可。

-说明事项：

XYplorer中使用QuickLook，是否可以使用空格键？

答：QuickLook在XYplorer使用中，不能使用Spacebar，因为它是被XYplorer保留[?]，因而你无法在XYplorer中使用它。

参考：QL-Win/QuickLook#96

导航面板目录的使用 | Navigation Panels - Catalog

打开侧边栏

F8->Ctrl+F8即可打开。

添加目录

Catalog栏是空白的，需要右键Add New Category...

自定义名称

确认右边栏就会变成这样

添加项目

拖动式添加项目

如果你需要添加文件到目录上，那么就把文件拖到“你需要的名称”上。

比如我把一张图片(Catalog-4.png)拖到目录名上，就会出现如下内容，

自定义式添加项目

添加脚本

选中目录名称，然后右键Add New Item Here...(快捷键式Insert)，可以自定义你要添加的项目。比如刚刚添加的.png文件就是一个项目(Item)。

若我想要添加一个脚本呢？

以下脚本的功能是选中一个文件，然后鼠标左键轻点一下就会复制文件的路径，不过这个文件的路径是以正斜杆/分割路径部分的。比如，D:/Work/GitWorks/XYplorer_Help/Updates/Image/Catalog-5.png，而不是D:\Work\GitWorks\XYplorer_Help\Updates\Image\Catalog-5.png。这么做是为了避免要在字符串中转义反斜杠\。

脚本内容如下，

Caption: Copy Path With Forward-slash to Clipboard

Location:

::if(<curitem>==""){copytext replace(<curpath>, "\", "/");} else{copytext replace(<curitem>, "\", "/");}

添加纸文件夹

-先创建纸文件夹

从地址栏输入<xypaper>，回车进入纸文件夹XYplorer\Data\Paper。

创建纸文件夹，纸文件夹以.txt结尾。我这里创建名为Test.txt。

-添加纸文件夹到目录

打开纸文件夹的语法格式:paper:纸文件夹名

-添加项目到纸文件夹

-请尽情探索纸文件夹

如果你打开<xypaper>/Test.txt，可以发现多处一行内容：

D:\Work\GitWorks\XYplorer_Help\Updates\Image\Catalog-8.png

纸文件夹不仅可以保存文件，还可以保存文件夹，纸文件夹主要用于存放同一个主题的素材。

目录数据的保存

-定位当前目录的数据文件

-数据文件保存位置

地址栏输入<xycatalogs>回车即可看到目录数据文件。丢失数据文件，那么目录栏就是空白的了，请保存好。

树的使用 | Tree

树的配置主要在View、Tools->Customize Tree、Configuration(F9)->Tree and List，少部分可以通过键入关键字"Tree"到Configuration(F9)->左下角Jump to Setting进行寻找、

菜单栏Windows->Show Tree(Shift + F8)，打开Tree记录功能。

View->Mini Tree：只显示选项卡(Tab)的路径的树，由于不需要显示无关目录的树，所以速度更快。

由于Tree会记录文件浏览历史，在退出XYplorer前，View->Reset Tree(Ctrl + Shift + F4)，如果路径历史过多，影响加载速度。

在Tree开启的情况下，每一次浏览目录，侧边的Tree都会追踪记录，所以你可以很容易看到当前目录和历史目录的层次结构。

Tools->Customize Tree->Tree Path Tracking：开启树追踪标记

View->Lock Tree：开启后，记住（冻结为）上一次树结构的状态，接下来无论怎样浏览目录，树的追踪记录都看不到。开启期间，应该是不会有目录追踪记录的。当关闭后，恢复树的追踪记录功能，并更新为当前目录的树结构。使用建议：需要树功能，XYplorer运行卡的情况下可锁定。

我的使用方法：关闭Mini Tree，Reset Tree，Lock Tree。把Tree的侧边栏空间压缩，只保留很小的地方，如图

之所以这样做，是因为我需要快速浏览C/D/E/F，对显示树结构的目录需求不是很大，并且在Tree侧边栏右键可以弹出收藏夹列表。

如果你需要使用树的功能，请一定要把XYplorer界面左右两侧拉长，如果不拉长，使用起来很没有体验。两侧拉长还有一个重要的理由：但你的文件夹视图是“详情视图”时，每一个文件的描述列：文件名、修改时间、创建时间、后缀名、文件夹大小等，想要把这些列的信息全，那么你就必须拉长。

XYplorer的搜索及最佳搜索替换工具Everything | Search | Find

XYplorer的搜索

搜索功能有哪些

使用List All Commands...命令，通过键盘依次按下Alt->H->O呼出，然后输入关键词find，得到相关的命令如下：

#260	Edit | Find Files...	 (Ctrl+F)
#261	Edit | Find Now	 (Ctrl+Alt+F)
#615	Tools | List Management | Find Files: Name...
#616	Tools | List Management | Find Files: Location...
#617	Tools | List Management | Find Files: Excluded Items...
#1058	Miscellaneous | Select Info Panel Tab | Find Files	 (Ctrl+7)
#1026	Miscellaneous | Find Files | Open Find Files and Reset	 (Ctrl+Shift+F)
#1030	Miscellaneous | Find Files | Search All Tabs

继续输入关键词search，其中与搜索有关的命令有：

#262	Edit | Repeat Last Search
#266	Edit | Quick Search...	 (F3)
#268	Edit | Toggle Quick Search	 (Ctrl+Shift+F3)
#267	Edit | Repeat Last Quick Search	 (Shift+F3)
#638	Tools | List Management | Quick Search...
#1030	Miscellaneous | Find Files | Search All Tabs

继续输入关键词Live Filter Box，其中与搜索有关的命令有：

#675	Window | Show Live Filter Box	 (Alt+F3)
#694	Window | Arrangement | Live Filter Box in Status Bar
#1080	Miscellaneous | Focus Functions | Focus Live Filter Box	 (Ctrl+Alt+X)

注意：使用List All Commands...命令搜索到的命令项目通过鼠标左键双击可以启动命令。

使用Customize Toolbar...命令，通过键盘依次按下Alt->T->B呼出，然后在左侧或右侧的搜索框输入关键词组Find by，得到相关的工具栏有：

Find by Tags
Find by Label

这两个按钮是特有的搜索关于Label(标签)和Tags(标注)的内容的按钮。

-XYplorer的搜索主要体现在四处: Find Files, Quick Search, Live Filter Box, 文件列表关键词匹配。

Find Files

1.Edit->Find Files(Ctrl +F)

需要指定搜索目录，关键字。其他过滤条件可选。但搜索速度慢，长时间运行可能会很卡。

什么是Find Files Tab

首先介绍什么是Find Files Tab，如下图所示：

Find Files Tab可以通过Ctrl+F呼出，也可通过在键盘依次按下Alt->E->F呼出。

Find Files Tab使用帮助

地址栏输入：

rtfm "idh_find.htm";

了解了Find Files Tab后，我们可以开始讲解Search Template了。

Search Template

什么是Search Template

首先，Template在XY语境中应该翻译为“模板”。那么Search Template就是用于Find Files Tab中搜索功能的一个模板。

那么Search Template保存的是什么呢？我们看Find Files Tab那张图片，可以看到有许多选项卡，比如Name & Location, Size, Date, Attributes, Tag, Contents, Dupes, Exclude。每个选项卡都是有参数可以勾选的，而这些参数都保存Search Template中。

Search Template的保存

如下图所示，这些勾选和添加的参数我都想要保存起来，并且会经常使用这些参数，我想要将其参数保存到Search Template中，下次打开Find Files Tab后，我可以很快地加载这些参数，而不用一个一个地设置它们。

那么我该如何保存？

Search Template命令在菜单栏Edit->Search Templates...中，可以通过按键依次按下Alt->E->A呼出。

如下图所示为Search Template的界面：

呼出Search Template界面后，点击Save to Template...：

这里我命名为Find:Everywhere-Label:Red-Excluded:C,D。

Search Template的载入

好了，我们点击Find Files Tab中的"Reset Filters"，如下图所示：

![FindFilesTab-Reset Filters](Image/FindFilesTab-Reset Filters.png)

这样"Reset Filters"按钮下方的Applied filters条件参数全部清空。

现在该如何加载每个选项卡的参数呢？

同样，我们先通过按键依次按下Alt->E->A呼出Search Template界面，然后选中对应的Search Template后点击"Load Template"按钮：

这样就可以看到Find Files Tab加载了各个选项卡的参数了。

Find Files Tab的使用

子选项卡和"Applied filters"的对应关系如下图所示

Find Files Tab共有8个子选项卡，每个选项卡参数设置后，为了使这些选项卡参数都生效，需要勾选对应的"Applied filters"，确认好搜索条件后，可以点击"Find Now"进行搜索。

Search Template进阶

Search Template使用说明指南

详细使用说明请在地址栏输入：

rtfm "idh_searchtemplates.htm";

Search Template保存文件命名

Search Template是一个模板，模板文件保存在<xydata>\FindTemplates中。

Template创建时，需要为当前Template进行命名，命名后进行保存，保存的文件名称与Template的一致，但由于Windows将如下字符作为保留字符：

The following reserved characters:

< (less than)

> (greater than)

: (colon)

" (double quote)

/ (forward slash)

\ (backslash)

| (vertical bar or pipe)

? (question mark)

* (asterisk)

关于Windows命名规范详情可参考Naming Files, Paths, and Namespaces - Win32 apps | Microsoft Docs，以上引用内容为保留字符的描述。

所以文件名就不应该出现这些保留字符，不然就会出现文件名非法的情况。然而XY允许使用这些被Windows作为保留字符的字符。为了避免Windows文件名非法，XY采用了"% & Hex(charcode)"的方案来转换这些字符。

在地址栏输入:<xydata>\FindTemplates,看到我(作者)保存的Search Template文件:

可以发现':'被解释成"%3A"了。Windows保留字符的对于的十六进制数如下：

/* 以下为十六进制数 */
< // 3D
> // 3E
: // 3A
" // 22
/ // 2F
\ // 5C
| // 7C
? // 3F
* // 2A

给出对应ASCII表

Search Template快速载入

每次载入都需要点击菜单栏"Edit->Search Templates..."然后选择模板文件，再载入，这样速度太慢了。于是参考了load search template and open search box directly - XYplorer Beta Club的脚本，其脚本如下：

    $template = popupmenu(replace(listfolder("<xydata>\FindTemplates", "*.ini", 4), ".ini"));
    loadsearch $template, "x";
    #260;

各位可以试着复制上面的内容，然后在菜单栏"Scripting->Run Scripting..."呼出Run Scripting...，也可以通过键盘依次按下Alt->S->R呼出。把复制的脚本内容粘贴，然后运行这个脚本（前提是你有保存Search Template文件哦）。

这个脚本受限于"loadsearch"函数，该函数不支持载入包含对Windows保留字符进行编码的文件名，所以我在上面脚本基础上进行修改，将编码的保留字符还原为ASCII字符，修改好后的脚本如下：

	// Get the base filename of user-selected template file
	$template = popupmenu(replace(listfolder("<xydata>\FindTemplates", "*.ini", 4), ".ini"));	
	// If $template is "", then terminate the running script, and else nothing be done.
	end $template == "";
	$invalid_characters = "<,>,:,/,\,|,?,|,*"; // a filename that doesn’t contain any control characters or these characters as follows
	$invalid_characters_ctr = 9;
	$searchlist =;
	$ctr = 1;
	// Get searchlist of invalid_characters which use for replacelist function.
	foreach($token, $invalid_characters, ",") {
		if ($ctr < $invalid_characters_ctr) {
			$temp = '%'.dectohex(asc($token)).',';
		} else {
			$temp = '%'.dectohex(asc($token));
		}
		$ctr += 1;
		$searchlist .= $temp;
	}
	loadsearch replacelist($template, $searchlist, $invalid_characters, ",", 0, 0), x; //Load specified search template ini file
	#260;	// This Command ID will invoke Find Files Tab

可以把脚本文件命名FastLoadSearchTemplate.xys，然后保存在<xyscripts>中，然后通过按键依次按下Alt->U-M呼出"Manager User-Defined Commands"，设置快捷键为Shift+T

使用效果如下：

Quick Search

2.Edit->Quick Search(F3)

功能很强大。需要结合匹配规则进行搜索，详细使用说明请在地址栏输入:

rtfm "idh_quicknamesearch.htm";

我写过的一个简易版按Tag搜索脚本就是参考以上内容才写出来的。

Live Filter Box

3.Live Filter Box。

使用方式：Window->Show Live Filter Box。在地址栏最右侧可以看到，如图

Ctrl + Alt + X进入，搜索关键字。

该功能用于当前目录下筛选文件（极其适合目录文件过量的情况下进行筛选）

假设我们需要筛选出C:\Windows\SysWOW64\certcli.dll，你只知道关键字"cert"，在Live Filter Box键入"cert"后，

这是一次模拟筛选，该功能场景范围过窄但好用。

文件列表关键词匹配

在浏览文件列表时，输入要匹配文件名关键词（必须从目标文件名的首位字母开始输入）可以快速查找文件，使用效果图如下：

Everything内容打开到XYplorer侧

Options->General->Context Menu，如图

Explore:

$exec("你的XYplorer目录\XYplorer.exe" "%1")

Explore Path:

$exec("你的XYplorer目录\XYplorer.exe" /select="%1")

Explore和Explorer Path的区别：前者打开这个文件；后者打开这个文件所在的父目录。

参考：Everything and XYplorer - My Everything Integration Settings - XYplorer Beta Club

这里有个以前用过目前弃用的Scripts的链接：Everything for xyplorer - XYplorer Beta Club。如果你感兴趣，可以尝试一下。

当然，纠结Scripts文件来调用Everything's command-line ES服务来搜索是没有必要的，复杂麻烦而且没直接使用Everything来得快。你可以跟我一样，添加一个Everything按钮，或者设置一个热键调用XY（请参考XYplorer间接调用Everything）。

XYplorer间接调用Everything

仅在当前目录下搜索（搜索的目标包括当前目录和当前目录的所有子目录)，示意图如下，

具体显示步骤如下，

1.创建脚本文件。菜单栏Scripting->Go to Scripts Folder来到<xyscripts>的目录下，创建名为EverythingCurpathSearch.xys脚本文件，内容如下，记得修改everything目录

版本一[可选，推荐]

	$everything = "D:\PortableApps\Everything\everything.exe";		//填写everything.exe路径
	runret ("cmd /c ".$everything." -path "."""<curpath>""");

以上每行语句都有一个Tab哦。

版本二[可选]

版本二特别注意：搜索的关键词首尾不能分别带有"。也就是没办法进行准确搜索。比如"Common Files"

	$everything = "D:\PortableApps\Everything\everything.exe";		//填写everything.exe路径
	$args = input("当前文件下搜索,请输入关键词:");
	runret ("cmd /c ".$everything." -path "."""<curpath>"""." -s "."""$args""");

2.绑定热键。菜单栏User->Manage Commands...(Ctril + Alt + F9)

Cpation:CurpathSearch
Script Files:<xyscripts>/EverythingCurpathSearch.xys

这样就设置完成了。开始使用吧，在XYplorer当前Tab所在当前目录下按Alt+2，键入你想要搜索的key words，然后Enter即可。

Script编写思路：通过命令行调用everything，everything想要完成当前目录搜索，需要知道主程序的外部接口[?]，需要获取当前目录和用户键入值。

Script中runret()可参考XYplorer.chm

编写的脚本很简陋，其目的主要是为了打开Everything，并自动化地添加上当前目录。

如果有兴趣的同学们可以自行研究下XYplorer Script(See 关于XYplorer Scripting的一些事)，熟悉流程控制语句和常用的Script Command就可以进行更高逻辑的功能实现了。

XYplorer的备份和还原 | Backup & Restore Configuration

说到这个问题，我们先得了解下XYplorer的目录结构。

注："XYplorer的目录结构"部分费时费精力，但可以了解你经常使用功能的对应数据文件的作用。当然你也可跳到备份什么文件才能保证数据不丢失并且换了新版也还继续用?进行阅读。

文件夹结构 | Folder Hierarchy

-文件夹结构(Folder Structure)[可选读,可跳过]

以下给出的是Portable版(便携版)的目录结构，

D:\PortableApps\XYplorer\Data>DIR
 Volume in drive D is Work
 Volume Serial Number is 2CC0-7192

 Directory of D:\PortableApps\XYplorer\Data

11/05/2020  16:48    <DIR>          .
11/05/2020  16:48    <DIR>          ..
11/05/2020  16:35           146,086 action.dat
11/05/2020  16:31    <DIR>          AutoBackup
11/05/2020  16:31    <DIR>          Catalogs
04/10/2019  10:28           858,784 ChineseSimplified.lng
11/05/2020  16:20    <DIR>          FindTemplates
11/05/2020  16:35             2,758 fvs.dat
11/05/2020  16:31    <DIR>          Icons
11/05/2020  16:35             8,224 ks.dat
11/05/2020  16:31                26 Language.ini
11/05/2020  16:35                18 lastini.dat
11/05/2020  16:31    <DIR>          NewItems
11/05/2020  16:31    <DIR>          Panes
11/05/2020  16:31    <DIR>          Paper
11/05/2020  16:31    <DIR>          Scripts
11/05/2020  16:35               980 tag.dat
11/05/2020  16:20    <DIR>          Temp
11/05/2020  16:35               552 udc.dat
11/05/2020  16:35           129,166 XYplorer.ini
               9 File(s)      1,146,594 bytes
              11 Dir(s)  271,924,928,512 bytes free

XYplorer/Data目录下文件信息介绍，

action.dat	//撤销或重做历史记录
ChineseSimplified.lng	//中文语言文件
fvs.dat	//fvs:folder view settings. 该.dat保存文件夹视图设置信息
ks.dat	//ks:keyboard shortcuts. 该.dat保存键盘快捷键设置信息
Language.ini	//XYplorer读取并根据该配置文件信息决定选择使用哪个语言作为界面交互语言。
lastini.dat	//如果存在,则该.dat用于决定让XYplorer载入哪个.ini信息，该.dat保存的值为XYplorer,那么XYplorer就会载入XYplorer.ini
tag.dat	//该.dat保存标注(tags)信息,这个标注信息应该包括标签(Label),注释(Comment),标签(tag)信息。
udc.dat	//udc:user-defined commands. 该.dat保存用户自定义命令信息
XYplorer.ini	//保存配置信息，该配置文件不可随意覆盖，XYplorer会调用它，如果随便覆盖它可能会出现版本使用到期。

XYplorer/Data目录下文件夹信息介绍，

AutoBackup	/*开启自动备份设置后，里面会保存catalog,fvs,tag,udc的dat文件,但不保存ks.dat,还会保存XYplorer.ini.该文件这些数据信息文件会在触发"Saving Settings"进行更新。该目录的文件可迁移到全新的XYplorer时,但记得把ks.dat也复制到新的XYplore/Data下*/
Catalogs	//存放catalog.dat
FindTemplates	//参考下面英语介绍
Icons		//<xyicons>表示的目录就是Icons目录,用户可以把Xyplorer需要用到的icon保存在这里
NewItems	//XYplorer空白处右键New->New Item的内容
Paper		//纸文件夹保存目录,保存的文件以.txt形式保存
Scripts		//<xyscripts>所指向的目录就是此目录
Panes		//保存tabsets信息
Temp		//保存XYplorer运行时会用到的临时文件

以下为XYplorer Beta Club论坛查找到的文件夹结构[?]，

Catalogs        catalogs
FindTemplates   search templates (saved searches)
Fresh           skip this, this is a temporary profile
Icons           icons default path
NewItems        new items menu items (Menu > Edit > New Items)
Panes           tabsets
Paper           paperfolders default save location
Scripts         scripts default path
Thumbnails      thumbnails cache default location
action.dat      undo/redo history
fvs.dat         folder view settings
ks.dat          keyboard shortcuts
pv.dat          permanent variables (for scripting)
tag.dat         tags, labels, comments
udc.dat         User-defined commands (Menu > User)
XYplorer.ini    main settings file (lastini.dat, if it exists, decides which ini file name is loaded)

language.ini信息来源:XYplorer Translation Guide - XYplorer Beta Club

Without "Language.ini" the app will load with the embedded English strings just as all the time before multilingual support.

Temp文件夹信息来源: What is the purpose of the Temp folder in application data folder - XYplorer Beta Club

Store temporary files used by XYplorer, instead of using %TEMP% (C:\Users[username]\AppData\Local\Temp).

综合上面的介绍，在进行迁移或备份用户数据时，可以选择保存Data文件夹或者保存以下用户数据文件：

action.dat[重要]	fvs.dat[重要]	ks.dat[重要]	Language.ini[重要]
tag.dat[重要]		udc.dat[重要]		XYplorer.ini[必要]	Catalogs目录[重要]
Scripts目录[重要]	
NewItems目录[可选]	Icons目录[可选]		Panes目录[可选]		
Temp目录[可选]	AutoBackup目录[可选]	Layout目录[可有,可选]		
FindTemplates目录[可选]		Paper目录[可选]

如果你的配置文件不是以XYplorer.ini名为的，你还需要保存lastini.ini文件。

备份什么文件才能保证数据不丢失并且换了新版也还继续用?

😩我说了这么多，你直接保存Data文件夹就好了，迁移时直接Copy这个Data到新的XYplorer目录下即可。

强调一遍，喜欢使用标签的同学们，一定要保存好tag.dat，里面装了你使用标签的数据信息，切记！

单项用户数据保存和载入

如果你不喜欢用户数据文件的命名，想要重新命名，或载入你已经保存的用户数据，可以参考以下方法。

-如何重命名配置文件？

File->Settings Special -> Save Configuration As..保存为其他名称，比如MyConfig.ini。

-如何启用自定义名字的配置文件呢？

File->Settings Special -> Load Configuration，选择MyConfig.ini，这时候应该会新生成一个lastini.dat文件，该文件的值为MyConfig，意思是当前XYplorer指向了MyConfig.ini配置文件。

-如何载入Tags信息？(两种方法)

1.载入自定义.dat文件。Tags->Load Tags Database。

2.载入catalog.dat文件。Tags->Import Local Tags。这时候的Local Tags应该是XYplorer正使用的catalog.dat文件，位于Data/Catalogs。

-如何重命名Tags信息?

Tags->Export Local Tags。

-如何删除Tags的全部信息?

Tags->Tags->Remove All Tags或Tools->Configuration(F9)->Information->Tags->有个Options,左键->Remove All Tags...。

-如何载入Catalog信息？

a或b都可用于载入Catalog信息。

-Layout保存和加载

Layout：布局，即，是否显示地址栏，工具栏，Tab栏，状态栏，树，目录等等以及他们的位置摆放信息。

Layout保存和加载通过Window->Save Layout As... / Load Layout。

-Tabsets保存和加载

Tabsets->Save/Save As.../Save Copy As...

Tabsets->Open .../Open As...

-用户自定义命令位于udc.dat,妥善保存。

-用户快捷键位于ks.dat,妥善保存。

还原(迁移)

为了使原版本的数据信息同步到新版本，你可以有几类操作方法：

方法1.准备一个全新版本XYplorer,然后把旧版本的Data覆盖到新的XYplorer/Data

迁移旧XY的数据目录到新XY，需要遵循以下步骤：

-先将你的Data目录复制一份到桌面（Desktop）。

-**(很重要)**对Desktop/Data/XYplorer.ini进行重命名，可以命名为MyXYConfig.ini。

-将Desktop/Data目录复制，然后粘贴到新XY目录下，覆盖新XY/Data目录。

-打开新XY，在新XY菜单栏File->Settings Special->Load Configuration...，通过载入配置选项来载入MyXYConfig.ini。

现在开始解释为什么要这么做：

如果直接将旧XY/Data/XYplorer.ini对新XY/Data/XYplorer.ini覆盖，会发生打开新XY出现许可证失效提示。不但如此，实际上，旧XY的数据也没有载入成功到新XY。

如图中Diagram所示：

方法2.直接在原版本XYplorer菜单栏Help->Online Support->Check for Updates进行升级。在21.20.0200以前版本每次升级都不会出现版本到期的现象，不过这一次升级到21.20.0200却出现了版本到期。因此使用方法1稳妥。

-END

批量命名 | Rename Special

案例1 寻找指定字符串进行替换

需求背景：保证视频文件名(不含后缀)与外挂字幕文件名(不含后缀)一致，Potplayer播放时就会自动载入字幕，为了完成这样的需求，需要改动网上下载到的字幕文件名。

我现有如下文件:

F:\Downloads\[VCB-Studio] Shokugeki no Souma][Ma10p_1080p][x265_flac]Subtitles繁体>dir ./b
[VCB-Studio] Shokugeki no Souma [01][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [02][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [03][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [04][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [05][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [06][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [07][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [08][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [09][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [10][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [11][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [12][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [13][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [14][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [15][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [16][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [17][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [18][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [19][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [20][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [21][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [22][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [23][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass
[VCB-Studio] Shokugeki no Souma [24][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass

我的替换要求是:

[VCB-Studio] Shokugeki no Souma [xx][Ma10p_1080p][x265_flac].TC-CASO&SumiSora.ass替换为[VCB-Studio] Shokugeki no Souma [xx][Ma10p_1080p][x265_flac].ass，即.TC-CASO&SumiSora需要替换为""(即内容为空白，体现在替换内容中就是什么内容都不输入)。

选中所有相关文件，然后菜单栏File->Rename Special->Search and Replace...

具体操作如下:

你还可以预览下结果:

语法格式：

before/now		//文件中含有的"before"替换为"now"

'/'的作用为:

define a string to be replaced by another string, both strings separated by '/'.

案例2 替换字符串中某个范围的内容

这个案例讲解正则表达式的运用。

Example1

Example1: 比如有以下文件，需要把「和」之间的内容去掉（包括边界「和」），该如何操作

问题儿童都来自异世界？ -01 「問題児たちが箱庭にやって来たようですよ？」 BDrip x264-ank.kna.mkv_20201106_184156.071.jpg
问题儿童都来自异世界？ -01 「問題児たちが箱庭にやって来たようですよ？」 BDrip x264-ank.kna.mkv_20201106_184206.959.jpg
问题儿童都来自异世界？ -04 「黒ウサギがエロイヤらしい奴に狙われたようですよ？」 BDrip x264-ank.mkv_20201107_233735.989.jpg
问题儿童都来自异世界？ -04 「黒ウサギがエロイヤらしい奴に狙われたようですよ？」 BDrip x264-ank.mkv_20201107_235627.895.jpg
问题儿童都来自异世界？ -04 「黒ウサギがエロイヤらしい奴に狙われたようですよ？」 BDrip x264-ank.mkv_20201107_235634.839.jpg
问题儿童都来自异世界？ -05 「誓いは星の彼方にだそうですよ？」 BDrip x264-ank.kna.mkv_20201108_164005.740.jpg
问题儿童都来自异世界？ -05 「誓いは星の彼方にだそうですよ？」 BDrip x264-ank.kna.mkv_20201108_220102.628.jpg
问题儿童都来自异世界？ -05 「誓いは星の彼方にだそうですよ？」 BDrip x264-ank.kna.mkv_20201108_220119.796.jpg
问题儿童都来自异世界？ -05 「誓いは星の彼方にだそうですよ？」 BDrip x264-ank.kna.mkv_20201108_220122.821.jpg
问题儿童都来自异世界？ -06 「問題児たちがお祭り騒ぎに参加するようですよ？」 BDrip x264-ank.kna.mkv_20201108_220533.452.jpg
问题儿童都来自异世界？ -06 「問題児たちがお祭り騒ぎに参加するようですよ？」 BDrip x264-ank.kna.mkv_20201108_220540.260.jpg
问题儿童都来自异世界？ -06 「問題児たちがお祭り騒ぎに参加するようですよ？」 BDrip x264-ank.kna.mkv_20201108_220544.739.jpg
问题儿童都来自异世界？ -06 「問題児たちがお祭り騒ぎに参加するようですよ？」 BDrip x264-ank.kna.mkv_20201108_220550.478.jpg

需要用到File->Rename Special->RegExp Rename...的功能。

两种语法格式如下:

RegExpPattern > ReplaceWith     (case-insensitive: a=A)
RegExpPattern > ReplaceWith\    (case-sensitive)

特别注意: >前后都需要补一个空格，否则不管匹配的正则表达式是正确的，也会出错。

正则表达式用于匹配符合规则的字符。匹配的规则就在正则表达式中，那么匹配时，会按正则表达式锁描述规则从头到尾扫描即将要匹配的字符串。

可以先去正则表达式在线测试 | 菜鸟工具测试下匹配结果：

接着，我们进行使用RegExp Rename...进行替换:

「[\s\S]+」 > 
// \s是匹配所有空白符，包括换行，\S是匹配非空白符，包括换行。
// [\s\S]匹配所有,但只匹配一个满足条件的字符
// +是限定符，用于指定它前面的表达式的匹配次数
// [\s\S]+表示多次匹配所有字符,匹配多个满足条件的字符
//「[\s\S]+」匹配以'「'开头和'」'结尾以及它们之间的所有字符

预览结果：

成功完成替换：

在BDrip前面加上-：

\s+BDrip > -BDrip

结果如下：

替换结束。

Example2

由于「和」比较特殊，我们考虑下面这种情况：

Example2: 比如形如以下文件，我想要将1和第一个B之间的内容（包括边界1和B）替换空串

问题儿童都来自异世界？ -061問題児たちがお祭り騒ぎに参加するようですよ？BBDrip x264-ank.kna.mkv_20201108_220550.4781.jpg
问题儿童都来自异世界？ -061問題児たちがお祭り騒ぎに参加するようですよ？BBDrip x264-ank.kna.mkv_20201108_220550.4782.jpg
问题儿童都来自异世界？ -061問題児たちがお祭り騒ぎに参加するようですよ？BBDrip x264-ank.kna.mkv_20201108_220550.4783.jpg
问题儿童都来自异世界？ -061問題児たちがお祭り騒ぎに参加するようですよ？BBDrip x264-ank.kna.mkv_20201108_220550.4784.jpg
问题儿童都来自异世界？ -061問題児たちがお祭り騒ぎに参加するようですよ？BBDrip x264-ank.kna.mkv_20201108_220550.4785.jpg
问题儿童都来自异世界？ -061問題児たちがお祭り騒ぎに参加するようですよ？BBDrip x264-ank.kna.mkv_20201108_220550.4786.jpg
...

因此，XY RegExp Rename匹配规则如下

1[\s\S]+B(?=B) >

Example3

Example3: 形如以下的文件，我想要将[和第一个]之间的内容（包括边界[和]）替换空串:

问题儿童都来自异世界？ -06 [問題児たちがお祭り騒ぎに参加するようですよ？]BDrip x264-ank.kna.mkv_20201108_220550.478.jpg
...

因此，XY RegExp Rename匹配规则如下

\[[\s\S]+\] >

你可以参考菜单教程的正则表达式部分进行学习，并且该网站也提供了正则表达式在线测试工具。

正则表达式重命名(RegExp Rename...)是一项很强大的功能，它相较于Search and Replace...，有更高的灵活性，可以定制搜索内容的类型和范围，但也提高了使用成本。

此外，XYplorer使用的是VB5 regex engine。

XY uses the VB5 regex engine.[?]

XYplorer最佳配套

XYplorer+Listary+Everything，这个模式我在好久前就在使用。

Everything以弥补XYplorer搜索的短板，但像要搜索XY中的Tags就需要使用XY

Listary集成XYplorer

无法有效集成的解决方法

为了保证Listary能集成到XY，请下载Listary6。

使用Listary5 Pro，有时不能集成到XY，而且对话框不能有效的基于XY当前目录进行切换。如果你还是要使用Listary5，我建议你将Listary按照非系统盘或者系统盘的两个Program Files文件夹以外且由你新创建的文件夹，比如C:\Listary。然后设置为管理员模式运行。

如果还是不能集成到XY，我建议你使用Listary6

目录快速切换

Listary与XY搭配中，最棒的功能是：所有弹出的对话框可以基于XY当前目录进行快速切换。

添加快捷方式文件夹到索引

同时，Listary可以用于快速启动应用软件。为了快速检索应用软件，建议按图要求进行操作：

以上是Listary6的设置方法，Listary5也是一样的设置方法。

在XY中对当前目录匹配时Listary Popup Menu(Listary弹出窗口)并不是最佳选择

Ctrl + Alt + X进入Live Filter Box输入，搜索关键字，即可筛选当前目录的文件。这部分可以参考[XYplorer的搜索]第3点

当然Popup Menu还有收藏夹，还有快速匹配关键字的结果，这个结果优先是当前目录，然后是其他目录。正是因为结果集列出除当前目录以外的结果，因此才建议使用XY的Live Filter Box功能。

便携式(定制化)文件关联 | Customize File Association(CFA)

基本语法

该功能在在QuickStart/ReadMe.md已经讲过了。CFA是可以用于关联特定格式的应用。指定格式对应调用的应用规则：

格式名1;格式名2;...;格式名N>应用路径

花(高)式(阶)玩法:无需POM,使用Script定制CFA

若你不了解POM，可以看关于POM章节的部分。这里讲解的是利用Script定制CFA。

友情提示：这部分需要掌握Scripting哦。

CFA中使用Scripting的示意图(以Batch文件为例)：

与下面POM进行比较：

先选择"MakeRAR_V0.3.cmd"，然后"Ctrl+Alt+Enter"，最后选择想要的功能。

对比两种方式，明显CFA中使用Scripting比使用POM要快捷多，其脚本(CFA/Batch.xys)如下：

	$sublime_text_dir = "D:\PortableApps\Notepad\SublimeText_x64_3211";
	$npp_dir = "D:\PortableApps\Notepad\Npp_Portable";
	$choice = popupnested("Run batch|Open with | Sublime Text| Notepad++");
	end $choice == "";
	if($choice == "Run batch") {
		run "<curitem>";
	}
	elseif($choice == "Sublime Text") {
		run $sublime_text_dir."\subl "."""<curitem>""";
	}
	elseif($choice == "Notepad++") {
		run $npp_dir."\notepad++ "."""<curitem>""";
	}

CFA中设置如下：

更多的例子及其示意图如下：

脚本如下:

CFA/Torrent.xys:

	$utorrent204_dir = "D:\PortableApps\uTorrent\uTorrent_2.0.4_绿色完美设置版";
	$utorrent35545828_dir = "D:\PortableApps\uTorrent\uTorrent_3.5.5.45828_Portable";
	$thunder11_dir = "D:\PortableApps\Thunder\Thunder11\Program";
	$thunderx_dir = "D:\PortableApps\Thunder\ThunderX\Program";
	$thunders_dir = "D:\PortableApps\Thunder\ThunderS_20201121_Green\Program";
	$thunder5_dir = "D:\PortableApps\Thunder\迅雷+v5.8.14.706+绿色共存版";
	$qbittorrent4191_dir = "D:\PortableApps\qBittorrent_Portable\qBittorrent-v4.1.9.1";
	$qbittorrentee41915_dir = "D:\PortableApps\qBittorrentEE_Portable\qBittorrentEE-v4.1.9.15";
	$qbittorrentee43110_dir = "D:\PortableApps\qBittorrentEE_Portable\qBittorrentEE-v4.3.1.10";
	$choice = popupnested("Open With: uTorrent| uTorrent_2.0.4| uTorrent_3.5.5.45828|Open With: Thunder| Thunder11| ThunderX| ThunderS| Thunder5|Open With: qBittorrent| qBittorrent-v4.1.9.1|Open With: qBittorrentEE| qBittorrentEE-v4.1.9.15| qBittorrentEE-v4.3.1.10");
	end $choice == "";
	switch($choice) {
		case "uTorrent_2.0.4":
			/* 
				Some characters of UTF-8 Unicode(65001) are found garbled. For example, the character '／'(not '/') is mistakenly interpreted as "￡ˉ".
			*/
			run("cmd /c start uTorrent.exe ".quote(<curitem>), $utorrent204_dir);
			break;
		case "uTorrent_3.5.5.45828":
			run("cmd /c start uTorrent.exe ".quote(<curitem>), $utorrent35545828_dir);
			break;
		case "Thunder11":
			// 如果查询到进程有迅雷运行时
			if(regexmatches(runret("cmd /c tasklist /v /fi ""IMAGENAME eq Thunder.exe"""), "Thunder") != "") {
				// 请保证你Thunder11目录包含"Thunder11"的关键字
				// 如果启动的是Thunder11
				if(regexmatches(runret("cmd /c tasklist /v /fi ""IMAGENAME eq DownloadSDKServer.exe"""), "Thunder11") != "") {
					run("cmd /c start Thunder.exe ".quote(<curitem>), $thunder11_dir);
				}
			} //否则重新启动Thunder11
			else {
				run("cmd /c start Thunder.exe ", $thunder11_dir);
				// 5000=5秒,请微调该时间直至Thunder11完全打开
				wait 5000;
				run("cmd /c start Thunder.exe ".quote(<curitem>), $thunder11_dir);	
			}
			break;
		case "ThunderX":
			run("cmd /c start Thunder.exe ".quote(<curitem>), $thunderx_dir);
			break;
		case "ThunderS":
			run("cmd /c start Thunder.exe ".quote(<curitem>), $thunders_dir);
			break;
		case "Thunder5":
			// 迅雷5打开后,在主界面手动打开种子
			run("cmd /c start 迅雷5.exe ".quote(<curitem>), $thunder5_dir);
			run("cmd /c start 迅雷L3.exe", $thunder5_dir);
			//run("explorer ".quote(<curpath>));
			break;
		case "qBittorrent-v4.1.9.1":
			run("cmd /c start qbittorrent.exe ".quote(<curitem>), $qbittorrent4191_dir);
			break;
		case "qBittorrentEE-v4.1.9.15":
			run("cmd /c start qbittorrent_x64.exe ".quote(<curitem>), $qbittorrentee41915_dir);
			break;
		case "qBittorrentEE-v4.3.1.10":
			run("cmd /c start qbittorrent_x64.exe ".quote(<curitem>), $qbittorrentee43110_dir);
			break;
		default:
			break;
	}

CFA/Video.xys:

	$potplayer_dir = "C:\Program Files\DAUM\PotPlayer";
	$mpc_dir = "C:\Program Files\MPC-HC";
	$mpv_dir = "C:\Users\vip57\scoop\apps\mpv-git\20201122";
	$choice = popupnested("Open With: Potplayer|Open With: MPC|Open With: MPV");
	end $choice == "";
	if($choice == "Open With: Potplayer") {
		run("cmd /c start PotPlayerMini64.exe ".quote(<curitem>), $potplayer_dir);
	}
	elseif($choice == "Open With: MPC") {
		run("cmd /c start mpc.exe ".quote(<curitem>), $mpc_dir, 866);
	}
	elseif($choice == "Open With: MPV") {
		run("cmd /c start mpv.exe ".quote(<curitem>), $mpv_dir, 866);
	}

便携式打开方式菜单 | File Association & Portable OpenWith Menu(POM)

POM使用前提

在CFA中添加关联规则。才可有效使用本功能。

便携式打开方式菜单

打开方式 | Open With...

背景引入

如下图，选中目标文件Ctrl + Alt + Enter，会弹出如下PopUp菜单：

上图就是便携式打开方式菜单的"打开方式"。可以看到这个"打开方式"菜单有三个视频播放，这是如何设置的呢？

我在自定义文件管理设置了三个视频播放器，并勾选：

按顺序，如果直接双击打开，默认是最上面的Potplayer。如果要使用其他视频播放器打开，就可以用到"打开方式"这个功能，刚才讲过，通过Ctrl + Alt + Enter就可以调用这个功能。

介绍

对比Windows右键打开方式，它虽然可以关联和设置某个格式的应用，但是依托宿主系统，不具备便携式。我们将的这个"打开方式"是属于Portable OpenWith Menu(POM)中的功能。通过Ctrl + Alt + Enter就可以调用POM中的"Open With..."(打开方式)。POM是可配置的，可便携式，这便是它的优点。

对同类格式文件需要用到不同应用软件,通过配置POM以满足不同的打开需求。

[案例]：比如对于.c和.h文件来说，有时我想要用notepad打开，有时想用VS Code打开，有时想用Dev-C++打开，通过将格式规则写到"自定义文件关联"就可以了。

对比Windows文件管理器，它的右键打开就显得繁琐。

基于这样的需求，我修改了我的"自定义文件关联"：

这是官网关于POM的介绍：XYplorer - Tour - Portable Openwith Menu™

Generic File Type

有哪些Generic File Type呢

 {:Text}       *
 {:Image}      *
 {:Photo}      *   = All image formats that may contain Exif data.
 {:Audio}      *
 {:Video}      *
 {:Media}      *   = Audio & Video
 {:Font}       *
 {:Vector}
 {:Web}        *
 {:Office}     *
 {:Archive}
 {:Executable}

想参考关于Generic File Type，请在地址栏输入：

rtfm "idh_visualfilters.htm#idh_genericfiletypes";

如何打印某个Generic File Type呢

如何查看Generic File Type类型的所有格式呢？菜单栏"脚本(Scripting)->运行脚本(Run Script...)"，输入如下内容：(这里我们就查看下{:Photo}的所有格式)

 echo get("genericfiletype", "{:Photo}", ";");

排除某个格式会被Generic File Type引入

过度使用Generic File Type虽然节省键入代表格式的字符的书写空间以及保持自定义文件关联规则的整洁，但也带来了把一些用户不想被关联的格式引入进来。

比如我的markdown文件(.md)双击按理应该调用系统默认应用(我的是Typora)，但是实际调用的是Notepad++，于是Ctrl+Alt+Enter调用了"打开方式":

对于格式的系统默认应用，可以按如图所示辨别出来,

要使用快捷键调用"打开方式"确实没双击应用调用默认应用来得快，这也是引入Generic File Type的弊端。好消息这一弊端可以修正的。

我们可以指定某个格式不被Generic File Type引入，它的解决方法就是：使用#(The special variable #)。

语法格式：

格式名1;格式名2;...;格式名N>#

注意这条语句的优先级应该设置为最高，放在最下面就根本不会使用到。比如调用.md格式的文件，先走md>#这条规则然后就调用.md格式的系统默认应用。若md>#放在所有规则的最下面，那么它就会走{:Text}规则，那么就会调用第一个"{:Text}><xydrive>\PortableApps\Npp_Portable\notepad++.exe"规则，根本不会执行到md>#这条规则。

定制"打开方式"

下面会用一个案例进行讲解。比如广大蓝光大佬，XXX资源分享大佬，亦或者是广大热爱收藏蓝光或者各种基于蓝光的经视频处理技术后重新编码的各种rip都需要用到BT下载器。PT网站要求不一，对BT下载器的版本要求不一，所以下载某些资源都需要切换版本。

根本无法辨别qBittorrent版本，这时候就需要修改POM"打开方式"菜单中某项的标题

修改内容如下：

其中"是在输入法英文下打出来的双引号。

"qBittorrentEE-v4.3.1.10" torrent>D:\PortableApps\qBittorrentEE_Portable\qBittorrentEE-v4.3.1.10\qbittorrent_x64.exe
"qBittorrentEE-v4.1.9.15" torrent>D:\PortableApps\qBittorrentEE_Portable\qBittorrentEE-v4.1.9.15\qbittorrent_x64.exe
"qBittorrent-v4.1.9.1" torrent>D:\PortableApps\qBittorrent_Portable\qBittorrent-v4.1.9.1\qbittorrent.exe

这时就可以区分qBittorrent各个版本了：

定制图标

可以看到我的BitComet使用的是bat运行，因为我运行BitComet需要打开磁盘提速服务，因此我写了个脚本，在开启前打开词服务再启动BitComet。我想把这个bat的图标修改为BitComet的图标。

图标使用IcoFX3进行提取并命名为BitComet.ico并放置<xyicons>。接下来进行修改：

由于我的图标放在<xyicons>中，我不需要书写成绝对路径的形式：

"BitComet|D:\PortableApps\XYplorer\Data\Icons\BitComet.ico" torrent>D:\PortableApps\BitComet\BitCometStart.bat

而是：

"BitComet|BitComet.ico" torrent>D:\PortableApps\BitComet\BitCometStart.bat

注意管道符|两边的内容不要有空格，特别是管道符右边，要紧接着内容，不要加空格！！！

这样就完成了修改了，效果如下：

定制分割线

语法格式：

格式名>-

为各个BT工具加分割线，如图所示：

效果图如下：

发挥你们的想象力吧，这个功能的应用场景太多了。比如有些图片文件需要用PS打开，平时浏览图片却不用；有些音乐需要倍速播放，所有需要切换音频播放器，有时候则不用；视频同理；有些PDF需要识别OCR，需要使用ABBYY，有些时候用其他PDF软件；有些office文档需要用WPS打开，有些则用Microsoft Office打开；...

有了POM功能，你只需要用对应软件，推荐软件尽量选择便携版；绿色版有时候不是一个很好的选择，因为部分应用需要使用bat进行注册相关服务等才可使用；安装版只局限了当前宿主系统。因此要区分Portable, Green, Setup。

收藏文件夹、收藏文件 | Favorite Folder & Favorite File

我们都知道在开启树的左侧栏后，在其空白处右键可以打开收藏文件夹列表，示意图如下：

但如果我们把树左侧栏关闭后，这个快速打开收藏文件夹列表的功能就用不了了。为了快速打开收藏文件夹列表，我写了脚本专门用于设置快捷键后，从鼠标出呼出收藏文件夹列表。

以下脚本文件通过设置快捷键后可以达到“使用快捷键在鼠标所在位置呼出收藏文件夹列表”的效果：

显示无图标版收藏文件夹列表的脚本(ShowFavoriteFolders-noicons.xys)：

	$fav_folders = favs('d');
	// If $fav_folders is "", then terminate the running script, and else nothing be done.
	end $fav_folders == "";
	$fav_folders_list =;
	foreach($token, $fav_folders, "<crlf>") {
		$fav_folders_list .= '|'.$token;
	}
	$selected = popupmenu($fav_folders_list);
	end $selected == "";
	goto $selected;

显示有限图标的收藏文件夹列表的脚本(ShowFavoriteFolders-limitedicons.xys)：

	$fav_folders = favs('d');
	// If $fav_folders is "", then terminate the running script, and else nothing be done.
	end $fav_folders == "";
	$fav_folders_list =;
	foreach($token, $fav_folders, "<crlf>") {
		// sep_item: "Caption;Data;Icon;State"
		// is paper?
		if(regexmatches($token, "^paper:") == "paper:") {
			$token = $token.';;:paper';
		}// is folder but not paper folder
		elseif(exists($token) == 2) {
			//Please substitute the generic folder icon you want for "Folders\Folder Yellow.ico"
			$token = $token.";;Folders\Folder Yellow.ico";
		}
		$fav_folders_list .= '|'.$token;
	}
	$selected = popupmenu($fav_folders_list);
	end $selected == "";
	goto $selected;

脚本说明：$token = $token.";;Folders\Folder Yellow.ico";换成你想要的图标位置，不加绝对路径，默认位置为<xyicons>。比如，脚本中这部分替换为$token = $token.";;你想要的图标.ico";，那么会从XY的"Data\Icons"目录下寻找；或者这部分替换为$token = $token.";;G:\你想要的图标.ico";，那么会寻找"G:\你想要的图标.ico"。

"ShowFavoriteFolders-limitedicons.xys"效果演示：(我设置的快捷键是Shift+F，关于如何设置脚本与快捷键关联请参考用户自定义命令的使用)

在打开收藏文件夹列表是否能根据Customize File Icons(CFI)信息动态获取自定义的图标么？

如果想要根据文件名和文件的扩展名获取来自Customize File Icons(CFI)的图标，在Scripting Commands中并没有类似getIcons()这样的函数，那么想要获取CFI图标信息，需要读取XY使用的配置文件。比如XY使用的配置文件是XYplorer.ini，那么CFI图标信息在配置文件的[FileIcons]中，可以通过文本编辑器自带的搜索功能搜索此关键词组。

显示CFI图标的收藏文件夹列表的脚本(ShowFavoriteFolders-CFI_V0.1.xys)：(该脚本只适用CFI信息不为空时才可打开收藏文件夹列表)

	// 该脚本只适用CFI信息不为空时才可打开收藏文件夹列表
	// XY配置文件路径
	$ini = "<xydata>\XYplorer.ini";
	$section_count = getkey("Count", "FileIcons", $ini);
	$iterator = 1;
	$value_list = ;
	while($iterator <= $section_count) {
		$value_list .= getkey($iterator, "FileIcons", $ini)."<crlf>";
		$iterator++;
	}
	if($value_list != "") {
		// extract folder info for CFI
		//echo $value_list;
		$cfi_list = ;
		// 读取CFI信息到$cfi_list
		foreach($token, $value_list, "<crlf>") {
			if(regexmatches($token, "\\>") != "") {
				$cfi_list .= $token."<crlf>";
			}
		}
	}
	
	// 该函数支持匹配形如“[A-Z]:\Shortcuts\>Folders\User Links.ico|Term PS.ico”这样的CFI项目
	// 该函数不适合纸文件夹的图标匹配
	// @src: 收藏文件夹名(该字符串最末尾以'\'结尾)
	// @cfi_list: 从.ini扫描到的CFI项目
	// @return: src若与CFI其中一项匹配上,返回加上CFI图标路径的sep_item,否则返回Generic folder图标
	function match_cfi($src, $cfi_list) {
		// Fav folder e.g D:\Shortcuts\ 取出字符串最后面的'\'
		$src_temp = substr($src, 0, -1);
		foreach($token, $cfi_list, "<crlf>") { 
			// [可选编程]先过滤掉一些规则
			// token_pre="Selected State of Folder In Tree" **\
			// "**\"
			//echo regexmatches($token, "\*\*\\");
			
		
			// CFI项目不包括图标路径的部分进行修改：将'\'改成"\\",并且去掉开头的'+'。这是前缀用于匹配
			$token_pre = replace(substr($token, 1, strpos($token, ">")-2), "\", "\\");
			
			// Regex pattern 可能包含'*','?',需要进行转换为正确的pattern
			$token_pre = replace($token_pre, "*", "\*");
			$token_pre = replace($token_pre, "?", "[A-Z]");
			
			// CFI项目获得图标部分
			$token_post = substr($token, strpos($token, ">")+1, strlen($token));
			//echo "token_pre=".$token_pre."<crlf>"."token_post=".$token_post."<crlf>";
			//echo "src=".$src."<crlf>"."src_temp=".$src_temp."<crlf>";
			
			// Match specified folder
			if(regexmatches($src_temp, $token_pre) == $src_temp) {
				$src = $src.";;".substr($token_post, 0, strpos($token_post, "|"));
				return $src;
			}
		}
		// 没有匹配到CFI就返回一般性文件图标的sep_item
		return $src.";;Folders\Folder Yellow.ico";
	}

	// CFI信息为空
	if($cfi_list != "") {
		$fav_folders = favs('d');
		// If $fav_folders is "", then terminate the running script, and else nothing be done.
		end $fav_folders == "";
		$fav_folders_list =;
		foreach($token, $fav_folders, "<crlf>") {
			// sep_item: "Caption;Data;Icon;State"
			// is paper?
			if(regexmatches($token, "^paper:") == "paper:") {
				$token = $token.';;:paper';
			}// is folder but not paper folder
			elseif(exists($token) == 2) {
				$token = match_cfi($token, $cfi_list);
			}
			$fav_folders_list .= '|'.$token;
		}
	}
	$selected = popupmenu($fav_folders_list);
	end $selected == "";
	goto $selected;

使用演示：

这个脚本目前如图所示这样的规则：

当然你也可以设置为"[A-Z]:\A\B>xxx.ico"这样的多级目录试一试。

这个脚本比上面两个脚本执行速度要慢得多。

FilesExpand file tree

Tips.md

Latest commit

History

Tips.md

File metadata and controls

事先说明

20191011

使用过程中出现崩溃的原因和解决方法

20200311 ~ Now

[Pin]关于XYplorer Scripting的一些事

XYplorer Scripting简介

快速入门

用什么语言开发的？

完善的教程其实在帮助文档中

[Everybody]XYplorer Native Variables

标识符集 | Tags

弄清楚Label,Tag,Comment区别

开启Label,Tag,Comment列

简易版按Tag搜索

使用

参考

定制文件列表 | Customize List

自定义列 | Custom Column

基本术语

什么是Column Layout?

什么是Column, Custom Column, Extra Column?

设置列布局 | Column Layout

添加列的方法

列属性的类型

定制属性列 | Property

[案例1]添加文件属性项列

定制自定义列

[案例1]Image size in inches

[案例2]Resolution

文件数量过多时Column加载卡顿的解决方法

方法一:改变载入Custom Column的触发方式

利用Extra Column手动模拟缓存

参考

保存和加载Column Layout

自定义列布局应用到特定文件夹

定制化文件夹图标 | Customize File Icons(CFI)

CFI配置方法

CFI语法

参考

定义

注释

用例

图标资源

如何找出需要的命令?

按钮和用户自定义命令区别

工具栏的使用 | Toolbar

工具栏的摆放和使用

按钮的高级用法

[案例1]使用Windows文件管理器打开XYplorer当前路径

[案例2]CMD集成到按钮

用户自定义命令的使用 | User-Defined Commands

设置快捷键调用Notepad

设置快捷键调用Explorer

在XYplorer中使用QuickLook

导航面板目录的使用 | Navigation Panels - Catalog

打开侧边栏

添加目录

添加项目

拖动式添加项目

自定义式添加项目

添加脚本

添加纸文件夹

目录数据的保存

树的使用 | Tree

XYplorer的搜索及最佳搜索替换工具Everything | Search | Find

XYplorer的搜索

搜索功能有哪些

Find Files

什么是Find Files Tab

Find Files Tab使用帮助

Search Template

什么是Search Template

Search Template的保存

Search Template的载入

如何打印某个Generic File Type呢