Wox的使用

Wox的使用

introduce

介绍

---

Wox是一款启动器。用于快速搜索本机安装的各种程序，文件。也可以通过插件快速搜索网络内容，比如今天天气如何，某某电影的评分是多少等等。

Wox是开源的，开源地址：http://www.github.com/qianlifeng/wox，欢迎Pull Request或者任何的Issue。

系统插件

---

Wox的插件体系分为两个方面，系统插件和第三方插件。系统插件一般不需要关键字触发（Web Search插件除外），而第三方插件都需要一个关键字触发。例如，我想使用有道翻译的插件，那么则需要使用yd + 空格 + 翻译内容进行触发。这个触发关键字可以配置，另外在后续的文章中我会介绍如何通过快捷键来简化这个过程。

• 程序插件(Programs)

  

  把这个系统插件放到第一个介绍，足可见他的重要性。Wox最核心也是最基本的一个功能就是快速启动程序。

  Wox程序插件集成了拼音检索的功能。用户可以直接用拼音或拼音首字母搜索程序，这对国人来说是一项很便利的优化。而且Wox搜索列表中的每一项都有自己的权重值。每次选择一项后，该项的权重会增大。这样下次再次搜索此项的时候，该项将会优先显示在列表前面。

  

  Wox程序搜索列表主要从两个地方获取。

  1. 开始菜单中的程序。

     Wox会自动收集开始菜单中的程序列表并索引之后供用户进行搜索。

  2. 用户自定义目录中的程序。

     如果用户需要索引的程序并不在开始菜单中，Wox还提供了自定义文件夹的方式让用户指定需要索引的文件夹。具体的设置在Setting=>Plugin=>Programs下面：

     

     在指定索引目录的同时，用户还可以指定需要索引的文件类型。默认Wox会索引以lnk;exe;bat为结尾的程序。用户可以通过点击Index File suffixes按钮进行设置。

• 颜色插件(Color)

  

  当用户输入符合特定条件的颜色值的时候，Wox会告诉你这个颜色是什么。

• 控制面板插件(Control Panel)

  

  Wox还支持控制面板的搜索。例如上图所示，输入防火墙的首拼音字母后，Wox会搜索出控制面板中的防火墙选项。

• 计算器插件(Calculator)

  

  Wox内置了很强大的计算插件。直接在Wox中搜索你想计算的公式，立马就能得到计算结果。

• 网址插件(URL handler)

  

  当你拷贝了一个网址想快速打开此网址的时候，打开Wox，粘贴，回车即可。

• Web搜索插件(Web Searches)

  

  Wox还提供了名为Web搜索的系统插件。所谓Web搜索，就是Wox允许用户设置一个URL，然后替换其中搜索关键字部分，从而达到快速搜索的目的。最常见的莫过于谷歌，百度搜索了。Wox内置了谷歌的Web搜索。关键字是g。另外在添加自定的Web搜索的时候记得把需要替换的地方换成{q}占位符，此占位符会在正常搜索的时候替换为你的输入。

  

  在Web搜索中，Wox还提供了搜索建议的功能。如上图所示，启动了搜索建议之后，在进行web搜索的过程中，Wox会根据你的搜索关键字给出其他相关的可能的搜索。建议来源可选择谷歌或者百度。

• 命令行插件(Shell)

  

  Wox提供了可替换系统运行命令的插件（默认还是Win + R触发）。此插件相比较于原生的运行程序，提供了一下一些额外的好处：

  1. 界面更加直观，搜索更加便利。

     拿iisreset这个例子来说，如果在传统的运行界面中搜索键入reset这个命令是得不到任何提示结果的，但是在Wox中则可以得到iisreset这个提示，前提是你以前运行过此命令。

  2. 经常使用的5个命令将会直接显示在界面上

• 文件夹插件(Folder)

  

  Wox提供了文件夹书签的功能。如果你有经常需要访问的文件夹，那么你可以将它加入文件夹列表中。以后直接搜索文件夹的名字即可快速打开此文件夹了。添加的设置位于：Settings=>Plugin=>Folder当中。

• 系统命令插件(System Commands)

  

  Wox集成了一些系统级别的命令。例如，注销，关机，锁定等等。具体的支持列表可以从Settings=>Plugin=>System Command中查看。

• 第三方插件提示插件(Third-party Indicator)

  

  如上图所示，此插件用于提示其他插件的触发关键字。

第三方插件

---

除了系统插件和内置的插件外，Wox还提供了插件平台用于插件制作者分享自己制作的插件。http://www.getwox.com/plugin

目前，Wox支持的插件语言包括但不仅限于C#和Python，用户甚至可以使用C,Ruby,Nodejs,Go等等各种语言来编写Wox插件。目前对使用C#编写的插件支持度最好，Python其次。关于如何编写Wox插件，大家可以去看这里中的指南。

主题

Wox支持丰富的主题。用户可以在设置窗口中选择自己喜欢的主题。

此外，我们还提供了一个在线主题制作工具ThemeBuilder方便用户进行主题制作。在网站上配置好喜欢的主题之后，点击下载，将主题文件下载到本地之后将文件重新命名为主题的名字+xaml后缀，例如：炫酷吊炸天.xaml。然后将此主题文件放在Wox目录下面的Themes文件夹当中并重启Wox即可。重启后，用户即可在主题列表里面看到新增的主题了。

热键

作为键盘流，强大的热键支持必不可少。在Wox中，热键分为两类。一类是系统已经定义好了，用户不能更改的，比如上面提到的Ctrl + R，另外一类就是用户可以自定义的热键，这也是我下面介绍的重点。用好这个功能再配合插件，往往能起到事半功倍的效果。

如上图所示，自定义热键基本分类两种。

1. 第一种是设置Wox的主热键，即通过此热键可以**与隐藏Wox。Wox默认的主热键是Alt + 空格，用户如果需要更改此设置，可以将光标放到热键框内然后直接键盘键入所需的快捷键即可。

2. 第二种是设置自定义的插件热键。举个我经常使用的翻译热键的例子，我写了一个有道翻译的插件默认通过yd关键字进行翻译，如下图所示：

   但是我又嫌每次都去输入这么一个yd比较麻烦，在我急需翻译某个单词的时候会显得十分的不便捷。这时用户便可以在这里设置一个针对yd查询的热键。

   如上图所示，添加好对应的设置之后点击Add即可。添加完了以后，用户通过Alt + t热键**的时候，Wox会自动打开并输入yd，用户所需要的只是立刻输入需要进行翻译的单词。注意，在设置热键关键字的时候，往往需要多加一个空格在后面，例如上面的yd + 空格，因为Wox默认关键字+空格才会触发插件。

   另外一个非常合适自定义热键的插件是剪贴板插件，我默认使用的是Ctrl + Shift + v**，是我必不可少的插件之一。

代理

在设置窗口中，用户可以选择为Wox设置HTTP代理。这个功能对对于一些企业用户来说可能很有必要，因为他们的网络环境都是通过代理连接的。

如果用户在这边设置了代理，那么wpm命令和插件都会通过此代理进行连接。注：如果插件作者在代码中没有考虑到Wox提供的代理信息，那么该插件还是不支持当前设置代理的。

上下文菜单

从v1.1.0开始，Wox实现了搜索项的上下文菜单功能。如上图所示，在选中搜索项的时候，如果在右边能看到一个小菜单图标的话就说明这个项是有菜单的。此时，你只需使用Shift + 回车即可进入菜单选项。如果想从菜单界面返回到搜索项界面只需要按Esc即可。

菜单项提供了一些你可能要对此文件/命令进行的操作，比如使用管理员权限打开此文件或者打开文件所在目录等等。目前，菜单项只能由插件制作者添加，因为对于一个搜索项，它需要有哪些菜单，插件制作者应该最清楚。

设置

刚刚使用Wox的用户，常常会找不到Wox的设置页面。目前，用户有两种方式打开设置界面：

• 通过setting命令（推荐）。如下图所示，直接输入setting然后选择第一项

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xuNn26Vc-1582265312666)(http://doc.wox.one/zh/basic/images/how_to_open_setting1.png)]

• 通过右键托盘图标。

命令行参数

Wox支持下面的命令行参数：

• Wox.exe reloadplugin

这个参数会重新加载所有的插件。在你拷贝新的插件到插件目录的时候，如果你不想重新启动Wox来使插件生效的话可以使用此参数。

• Wox.exe query <查询内容>

使用这个参数会自动打开Wox，并输入你想查询的内容进行查询。

• Wox.exe hidestart

使用这个参数会打开Wox，但是不显示查询窗体。一般开机启动的时候用到。

• Wox.exe installplugin

使用这个参数进行插件的安装。

插件

Wox的插件分为两种，系统插件和第三方插件。

• 系统插件

  系统插件是指Wox内置的功能插件，例如计算器，颜色，程序搜索等。这些插件不可以卸载，但是可以禁用。此外，系统插件一般不需要关键字触发（Web Search插件除外）

• 第三方插件

  第三方插件是指其他用户编写的插件，这些插件都需要一个关键字触发。例如，我想使用有道翻译的插件，那么则需要使用yd + 空格 + 翻译内容进行触发。这个触发关键字可以配置。

安装插件

Wox目前支持两种安装插件的方式。

• 使用wpm命令安装（推荐）

  Wox内置了wpm插件，专门用于管理插件。

  1. 安装插件：wpm install <插件名字>
  2. 删除插件: wpm uninstall <插件名字>
  3. 已安装插件： wpm list

• 下载Wox插件包，手动安装
  如果由于某种原因，用户不能使用wpm来安装插件。 那么用户可以将插件安装包下载到本地（以.wox结尾），然后将插件安装包拖拽到Wox搜索框上即可开始安装。

编写插件

在编写Wox插件之前，需要明白Wox使用的插件机制。

简单来说，Wox与插件之间通过标准输入输出的方式通信，使用JSONRPC来完成通信。使用这种方式，将极大的提高Wox支持的插件种类， 几乎任何语言都可以用来编写Wox插件。

plugin.json

在创建Wox的时候，用户必须在插件的根目录方式一个名为plugin.json的文件。该文件中包含了该插件的一些基本信息。在用户上传插件到getwox.com的时候， 我们会读取这个文件中的信息。

plugin.json的格式如下： 请在粘贴下面代码的时候移除其中的注释

{
  "ID":"D2D2C23B084D411DB66FE0C79D6C2A6H",   //插件ID，32位的UUID
  "ActionKeyword":"wpm",                     //插件默认的触发关键字
  "Name":"WPM",                              //插件名字
  "Description":"Wox Package Management",    //插件介绍
  "Author":"qianlifeng",                     //作者
  "Version":"1.0.0",                         //插件版本，必须是x.x.x的格式
  "Language":"csharp",                       //插件语言，目前支持csharp,python
  "Website":"http://www.getwox.com",         //插件网站或者个人网站
  "IcoPath": "Images\\pic.png",              //插件图标，路径是相对插件根目录的路径
  "ExecuteFileName":"PluginManagement.dll"   //执行文件入口，如果是C#插件则填写DLL路径，如果是pyhton则填写python文件路径
}

禁用插件

如果用户想禁用某个插件，那么可以按如下步骤操作：

1. 打开Wox设置界面，并切换到插件页。
2. 选择你想禁用的插件，勾选disable勾选框即可。注意，这一操作是即时生效的。

主题

如果用户想禁用某个插件，那么可以按如下步骤操作：

1. 打开Wox设置界面，并切换到插件页。
2. 选择你想禁用的插件，勾选disable勾选框即可。注意，这一操作是即时生效的。

安装主题