之前寫過一篇使用Wox+Python打造命令行工具庫，除了我們自定義命令行工具之外，Wox的強大之處，在于它的插件功能，可以安裝第三方插件以及自行設計編寫插件。我們常用的程序搜索，網頁搜索，其實都是插件。

所以我們這一篇來聊聊如何編寫Wox的插件

在進入正題之前，先簡單說說插件的安裝方式和運行原理

安裝方式

Wox目前支持以下幾種安裝插件的方式。

使用wpm命令安裝官方倉庫的插件

Wox內置了wpm插件，專門用于管理插件。

安裝插件：wpm install <插件名字>

刪除插件: wpm uninstall <插件名字>

查看已安裝插件： wpm list

通過wox文件安裝

下載Wox插件包，以將插件安裝包下載到本地（以.wox結尾），然后將插件安裝包拖拽到Wox搜索框上即可開始安裝。

通過源碼安裝

下載插件源碼，放到Wox的Plugins目錄下
C:\Users\Administrator\AppData\Local\Wox\app-1.3.524\Plugins

運行原理

Wox與插件之間通過標準輸入輸出的方式通信，使用JSONRPC來完成通信。使用這種方式，將極大的提高Wox支持的插件種類， 幾乎任何語言都可以用來編寫Wox插件。

編寫插件

先來看看一個Hello World 插件，插件目錄

ico.ico 插件圖標
plugin.json 文件包含了該插件的一些基本信息

{
    "ID":"2f4e384e-76ce-45c3-aea2-b16f5e5c328f",
    "ActionKeyword":"h",
    "Name":"Hello World",
    "Description":"Hello World",
    "Author":"jianbing",
    "Version":"1.0.0",
    "Language":"python",
    "Website":"https://github.com/jianbing",
    "IcoPath":"Images\\ico.ico",
    "ExecuteFileName":"main.py"
}

main.py 核心文件

# -*- coding: utf-8 -*-
from wox import Wox, WoxAPI
import pyperclip

class Main(Wox):

    def query(self, keyword):
        results = list()
        results.append({
            "Title": "input",
            "SubTitle": keyword,
            "IcoPath": "Images/ico.ico",
            "JsonRPCAction": {
                "method": "test_func",
                "parameters": [keyword],
                "dontHideAfterAction": False      # 運行后是否隱藏Wox窗口
            }
        })
        return results

    def test_func(self, keyword):
        pyperclip.copy(keyword)

if __name__ == "__main__":
    Main()

運行效果：

回車后，“hello”這個字符串就被復制到剪貼板中，可以到另外的文本區域進行粘貼，看似非常完美

問題來了，如果出現報錯，比如導入的模塊名錯了

import pyperclip1

Wox就默默呆住了

這樣沒有任何報錯信息記錄，對于代碼編寫和調試都是非常麻煩的

經過一番嘗試，折騰出了Hello World Ex

看看新的目錄結構，增加了一個util.py文件

util.py 封裝了捕獲報錯所需的相關類庫和函數，以及簡易的日志功能

# -*- coding: utf-8 -*-
from wox import Wox, WoxAPI
import types
import traceback
import logging
import functools
import os
from contextlib import contextmanager

logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',
                    datefmt='%a, %d %b %Y %H:%M:%S',
                    filename="error.log",
                    filemode='a')

class Log:
    @classmethod
    def debug(cls, msg):
        logging.debug(msg)

    @classmethod
    def info(cls, msg):
        logging.info(msg)

    @classmethod
    def error(cls, msg):
        logging.error(msg)

@contextmanager
def load_module():
    try:
        yield
    except:
        Log.error(traceback.format_exc())
        os.system(r'explorer "{}"'.format(os.getcwd()))

def _debug(func):
    @functools.wraps(func)
    def wrap(*args, **kwargs):
        try:
            return func(*args, **kwargs)
        except:
            error = traceback.format_exc()
            WoxAPI.show_msg("error", error)
            Log.error(error)
            os.system(r'explorer "{}"'.format(os.getcwd()))

    return wrap

class _DebugMeta(type):
    def __new__(cls, clsname, bases, attrs):
        for func_name, func in attrs.items():
            if isinstance(func, types.FunctionType):
                attrs[func_name] = _debug(func)
        return super(_DebugMeta, cls).__new__(cls, clsname, bases, attrs)

class WoxEx(Wox, metaclass=_DebugMeta):
    pass

main.py 做相應的修改，其實修改并不多

# -*- coding: utf-8 -*-
# 固定寫法，導入相關類庫和函數
from util import WoxEx, WoxAPI, load_module, Log

# 統一加載模塊
with load_module():
    import pyperclip

class Main(WoxEx):  # 繼承WoxEx
    def query(self, keyword):
        results = list()
        results.append({
            "Title": "input",
            "SubTitle": keyword,
            "IcoPath": "Images/ico.ico",
            "JsonRPCAction": {
                "method": "test_func",
                "parameters": [keyword],
                "dontHideAfterAction": False
            }
        })
        return results

    def test_func(self, keyword):
        pyperclip.copy(keyword)

if __name__ == "__main__":
    Main()

再來試試報錯，還是剛剛的導入模塊名字錯誤

with load_module():
    import pyperclip1

運行的時候，會自動彈出報錯文件

打開文件，可以看到完整的報錯信息

Tue, 19 Feb 2019 17:33:16 util.py[line:29] ERROR Traceback (most recent call last):
  File "C:\Users\Administrator\AppData\Roaming\Wox\Plugins\Hello World Ex-991dfc7a-7c37-41f7-8e63-273f83c9680f\util.py", line 35, in load_module
    yield
  File "C:\Users\Administrator\AppData\Roaming\Wox\Plugins\Hello World Ex-991dfc7a-7c37-41f7-8e63-273f83c9680f\main.py", line 7, in <module>
    import pyperclip1
ModuleNotFoundError: No module named 'pyperclip1'

再來試試方法里邊的報錯看看

def test_func(self, keyword):
    raise Exception("error!!!")
    pyperclip.copy(keyword)

回車后，彈出了報錯文件所在目錄后，右下角也會彈窗顯示報錯信息

大功告成~

插件的應用

通過自定義插件，我們可以將一些操作集成上去，舉個栗子，物品道具的查找，不在需要打開道具配置表進行搜索了~

源碼下載

HelloWord和HelloWordEx的源碼已經上傳到了GitHub，歡迎圍觀