API & PopClip 插件

URL Scheme、AppleScript 及 PopClip 插件

最新版本的 HapiGo 已支持通过 URL Scheme 及 AppleScript 2 种方式来调用 HapiGo。通过这些 API，你可以将其他应用的文本发送到 HapiGo 进行搜索或翻译。如果你是 PopClip 用户，我们也开发了 PopClip 插件，方便你更便捷的操作文本。

URL Scheme

hapigo://open?extensionID={id}&query={query}

其中 query 为关键词变量，extensionID 为扩展的 id。extensionID 部分目前仅开放 4 个内置扩展，后续计划支持全部扩展。4 个内置扩展 id 如下：

• APP：发送文本至 HapiGo 应用搜索

• FILE：发送文本至 HapiGo 文件搜索

• CLIPBOARD：发送文本至 HapiGo 剪贴板搜索

• TRANSLATE：发送文本至 HapiGo 翻译

当 HapiGo 搜索模式为「混合搜索」时，APP 和 FILE 的效果相同，均为发送文本至主搜索。

URL Scheme 示例

#在应用模式中搜索「hapigo」：
hapigo://open?extensionID=APP&query=hapigo

#在文件模式中搜索「pdf」：
hapigo://open?extensionID=FILE&query=pdf

#在剪贴板中搜索「request」：
hapigo://open?extensionID=CLIPBOARD&query=request

#在 HapiGo 中翻译「app」：
hapigo://open?extensionID=TRANSLATE&query=app

AppleScript

作为原生应用，HapiGo 也支持使用 AppleScript 调用 HapiGo。打开 AppleScript 脚本编辑器，点击菜单栏「文件」-「打开词典」可以找到 HapiGo 的 AppleScript 语法词典。

与 URL Scheme 所提供的功能一样，AppleScript 可以在 HapiGo 中搜索应用、文件、剪贴板及进行翻译。

AppleScript 示例

#在应用模式中搜索「hapigo」：
tell application "HapiGo"
    search app "hapigo"
end tell

#在文件模式中搜索「pdf」：
tell application "HapiGo"
    search file "pdf"
end tell

#在剪贴板中搜索「request」：
tell application "HapiGo"
    search clipboard "request"
end tell

#在 HapiGo 中翻译「app」：
tell application "HapiGo"
    translate "app"
end tell

Popclip 插件

除了提供 URL Scheme 及 AppleScript 接口，我们也开发了现成的 PopClip 插件供大家使用。下载插件后双击安装。此时会在菜单栏 PopClip 图标处弹出 4 个功能选择，分别为：HapiGo 应用搜索、HapiGo 文件搜索、HapiGo 翻译、HapiGo 剪贴板搜索，大家可以根据需要进行选择。后续如需调整，也可以在 PopClip 的插件列表中找到 HapiGo，然后点击后面的齿轮进行设置。

插件的标签描述提供 3 种语言：简体中文、繁体中文、英文。

下载链接：https://dl.hapigo.com/HapiGoPopClipPlugin.zip