# 使用快捷键

HapiGo 是一款无常驻窗口的菜单栏应用，高度依赖快捷键调用。初始的启动快捷键为：<mark style="background-color:blue;">Option+空格</mark>。你可以按照你的习惯到设置中修改此启动快捷键。

### 修改快捷键

HapiGo 支持普通快捷键及双击（shift、control、option、command）快捷键。

* 点击菜单栏 HapiGo 菜单-偏好设置...
* 在打开的设置面板-通用-启动快捷键处进行修改
* 点击快捷键输入框，边框高亮后开始输入新的快捷键
* 当应用接收到合规的快捷键时，就会设定此快捷键

![设置快捷键](/files/rEtwhikpAZGEqeH84J5R)

### 使用 Spotlight 快捷键

macOS 系统为 Spotlight 设置了 <mark style="background-color:blue;">CMD+空格</mark> 的快捷键。当部分用户发掘 HapiGo 可以完全替代 Spotlight 后，便想将 HapiGo 的启动快捷键也设置为 <mark style="background-color:blue;">CMD+空格</mark>。

此时，我们需要先在偏好设置中取消 Spotlight 快捷键。

* 在 HapiGo 中搜索「jianpan」启动系统偏好设置的键盘设置
* 切换到「快捷键」标签，并在左边列表中点击「聚焦」
* 根据个人需求，将 Spotlight 快捷键取消或修改为其他
* 进入 HapiGo 设置中，设置启动快捷键为 <mark style="background-color:blue;">CMD+空格</mark> 即可

![](/files/06DAc9773diwLFo86L1o)

同样的情况也适用于使用多语言切换快捷键作 <mark style="background-color:blue;">control+空格</mark> 为 HapiGo 的启动快捷键。

![](/files/Au57LPbmRhh1E0hRWJhj)


# 主界面与操作（必看）

如果你是一位从来没有接触过搜索启动工具的用户，请一定要看一下 HapiGo 的主界面和操作方式，这样可以让你使用更加得心应手。

### 主界面

HapiGo 的主界面由 5 个部分组成，应用、文件、扩展都是按照这 5 个部分的结构来显示。

<figure><img src="/files/8NnwFqQHFvUAJST5SiJM" alt=""><figcaption></figcaption></figure>

1. **主输入框：**&#x8F93;入关键词，支持多关键词。如果搜索文档，建议先输入文件后缀，再输入文件名「pdf baogao」。建议在设置-通用中设置默认输入法为英文，可以使用拼音搜索中文内容，更快捷。最右边分别为过滤菜单、勋章（可取消）、窗口置顶，可根据需要使用。
2. **主列表：**&#x641C;索出来的结果列表，分为 3 个部分，依次为：应用、文档、默认搜索。如果你输入比较长的内容，应用&文档没有结果时，会定位到默认搜索，直接回车就可以转到对应网站。默认搜索设置参考： [网页直达](/extention/directlink#she-zhi-mo-ren-sou-suo)。主列表的内容可通过 CMD+数字快捷键进行操作。
3. **预览区标题：**&#x663E;示标题、类别或路径，最右边的缩放按钮可以切换预览视图和信息视图
4. **预览区：**&#x5185;容的预览，某些应用或扩展没有预览，会显示为信息视图
5. **底部动作栏：**&#x52A8;作栏的动作会根据当前选择的内容动态变化。默认第一个动作高亮，也可以通过左右键切换高亮。<mark style="color:blue;">切换到哪一个动作，回车就会执行当前高亮条目的高亮动作</mark>。这些动作除了可以左右键切换，也可以通过 Option+数字进行选择，部分动作也支持 CMD 快捷键。如上图，当按下 CMD 键时，动作图标上会显示快捷键提示。比如：当我需要在访达中显示该行内容时，就可以使用 CMD+Enter。

### 全键盘操作

HapiGo 是一款效率搜索启动应用，建议通过键盘为主、鼠标为辅来进行操作。

建议熟悉以下常用键盘操作：

* 快捷键打开窗口
* 上下键切换主列表或 CMD+数字直接打开对应的内容
* 左右键切换底部动作栏动作或 Option+数字 或 CMD 快捷键
* 如上图第一行所示，某些应用支持扩展模式，在其行尾会有一个 ⇥ Tab 图标。意思是，此时按 Tab 键就可以进入二级扩展。

其他的快捷键会在光标悬浮时进行提示，如果你经常使用某个操作，就可以记住对应的快捷键。


# 搜索别名与快捷键

最新版 HapiGo 支持使用别名和快捷键快速搜索和启动应用与文档，下面我们来分别了解相关功能。

### 别名

别名是搜索对象的精准匹配的短名称，比如：我经常使用 Apple 备忘录，我可以为其设置别名「1」。那么每次我输入「1」时，Apple 备忘录就会出现在第一行。这个操作可以让搜索&启动 APP 及文档的用时降低到 2 秒内，是非常高效的功能。

<figure><img src="/files/cz3PTofbO1IeOoT02D0C" alt=""><figcaption></figcaption></figure>

别名适用于所有主列表会出现的条目，所以我们除了可以给 APP 设置别名，也可以为「文件、文件夹、扩展、网页直达」等设置别名。如果你最近经常打开某个文件夹或在这个文件夹中搜索文件，那么就可以为这个文件夹设置别名。此时，你可以从 2 个方面提升效率：

1. 打开文件夹：输入别名后回车
2. 快速在文件夹中搜索：输入别名后按 tab，即可搜索此文件夹内的文件了

<figure><img src="/files/PMuKflnVtT3LzdF9QVga" alt=""><figcaption></figcaption></figure>

### 快捷键

我们可以为任意 APP 或文档设置打开快捷键，对于扩展可以设置进入扩展的快捷键。这里的快捷键为全局快捷键，在不冲突的情况可以从任意场景下触发。

### 设置别名与快捷键

通过菜单栏或 HapiGo 扩展打开设置面板，切换到「别名与快捷键」。

在这个面板中已经列出了 HapiGo 内置的扩展和网页直达等内容，可以直接编辑。对于列表中没有的 APP 或文档，可以打开 HapiGo，搜索目标对象，然后拖拽到列表中即可添加。之后分别设置别名和快捷键即可。

<figure><img src="/files/TYgBIqDkDGBGMZc6NQV9" alt=""><figcaption></figcaption></figure>


# 文档搜索与排除

HapiGo 是一款应用/文件搜索启动工具，快捷键打开主窗口后就可以开始搜索应用和文件了。

### 文件搜索

HapiGo 文件搜索可以分为 2 种方式：1. 混合搜索；2. 单独搜索。

混合搜索是应用和文件一起搜索。因为大部分人电脑中的应用较少，所以多输入一些关键词就可以直接过滤掉应用，而开始搜索文件了。

而单独搜索则可以设置：「文档优先」和「应用优先」。设置了应用优先，那么打开主面板后需要按下 <mark style="background-color:blue;">空格</mark> 来切换至文档搜索。&#x20;

<figure><img src="/files/ArdmTyo6TBXNwKuPXni1" alt=""><figcaption></figcaption></figure>

### 全文搜索 & 搜索文件夹

除了普通的文档搜索外，HapiGo 还提供全文搜索及仅搜索文件夹。在文档搜索模式下（混合搜索不区分），输入 <mark style="background-color:blue;">单引号</mark> 可以进入全文搜索模式，输入 <mark style="background-color:blue;">逗号</mark> 可以进入仅搜索文件夹模式。

如果你不记得这些符号快捷方式，可以点击主搜索框右侧的过滤图标，从弹出菜单中进入对应的搜索模式。

<figure><img src="/files/0U8YwuOhEv3BMlR9mBD3" alt=""><figcaption></figcaption></figure>

### 文件夹内搜索

当搜索到某个文件夹时，可以按 <mark style="background-color:blue;">Tab</mark> 键进入文件夹内搜索模式。此时，输入关键词可搜索本文件夹内所有层级的文件或文件夹。按 <mark style="background-color:blue;">Shift+Tab</mark> 可以返回上级文件夹。

<figure><img src="/files/qyQDRsQSfSrTUj7UbY0Y" alt=""><figcaption></figcaption></figure>

### 添加网盘&外置磁盘搜索

HapiGo 常规文件搜索已使用完全自研的索引及搜索技术，可以设置搜索范围。同时也支持已在 Finder 中挂载的外置磁盘（NTFS、FAT32）和网络硬盘（NAS、WebDAV、SMB 等）。所以如果你经常使用外置磁盘和网盘，可以在设置中添加挂载的外置磁盘和网盘。

打开主窗口后按 <mark style="background-color:blue;">CMD+,</mark> 在打开的设置面板中切换到「搜索」-「文档搜索」。点击右上角 <mark style="background-color:blue;">+</mark>，将需要搜索的路径添加。

{% hint style="info" %}
**索引性能：**&#x6B63;常来说，索引的速度很快。在文件不多的电脑上，几乎没有影响。但是，如果文件数超过 50 万，可能会导致 CPU 持续高占用、能耗升高、电脑发热。所以，建议文件数较多的用户，排除一些不必要的文件路径。减少索引文件数，减少索引时长。

**外置磁盘索引：**&#x8FDE;接稳定的外置磁盘只比本地磁盘索引性能慢一点，且同样支持实时增量索引。

**网盘索引：**&#x7F51;盘受限于网络传输原因，索引速度相对较慢。

**查询文件数量**：打开主窗口后按 <mark style="background-color:blue;">CMD+,</mark> 在打开的设置面板中切换到「搜索」-「文档搜索」 - 点击「文件索引检查」-「检查」-「开始」。系统会进行索引检查，可以看到文件搜索路径、数量和索引用时。这个结果可以用来评估是否要减少文件路径。
{% endhint %}

### 文档搜索排除

#### 常规搜索排除

常规搜索的排除，可以在 HapiGo 中设置。打开主窗口后按 <mark style="background-color:blue;">CMD+,</mark> 在打开的设置面板中切换到「搜索」-「文档搜索排除」。

这里，可以有 3 种索引排除方式：

1. 按路径排除：添加需要排除的路径
2. 按后缀排除：这里后缀可以是文件后缀，也可以是文件夹后缀（文件夹后面添加 <mark style="background-color:green;">.后缀</mark>）。比如：排除后缀「noindex」，那么在文件夹后面添加 <mark style="background-color:green;">.noindex</mark>，此文件夹就不会被搜索到。
3. 按文件夹名称排除：设置文件夹名称，那么无论此名称的文件夹在什么路径或有多少个，都会被排除。

<figure><img src="/files/8ZgyEGmTHz7m9dHFTZmK" alt=""><figcaption></figcaption></figure>

#### 全文搜索排除

HapiGo 的全文搜索目前使用的是 Spotlight 提供的结果，所以如果要排除全文搜索的结果，可以进入系统 Spotlight 进行设置。

在 HapiGo 中搜索「Siri 与聚焦」并打开，在设置面板中滚动到最底部「聚焦隐私...」，添加需要隐藏的路径。

<figure><img src="/files/blW9leFqg7VXSnHwmaX2" alt=""><figcaption></figcaption></figure>

### 搜索问题解决

如果你发现某个文件搜索不到，请尝试如下操作：

1. 检查该文件路径是否在搜索范围内
2. 如果不在，请添加至搜索
3. 如果在，请重启 HapiGo

如果以上操作无法解决你的问题，请通过你方便的方式向我们反馈。

* 邮箱：<feedback@hapigo.com>
* 论坛：<https://forum.hapigo.com>
* QQ 群：577036563


# 添加Parallels与微信搜索

HapiGo 自带了常见的应用和文件路径，但是也有一些有争议的应用和文件并未包含。其中被问询比较多的是：Parallels Desktop 的应用搜索和微信缓存文件的搜索路径。

对于部分需要的用户，可以根据下面介绍手动添加：

### 添加 Parallels Desktop 虚拟机应用

PD 是 macOS 上一款知名的虚拟机应用，主打 Windows 与 macOS 融合使用，所以其支持在 macOS 中直接打开 Windows 的应用。但是，由于大部分 mac 用户只在特殊情况下才使用虚拟机，添加 PD 应用搜索会影响日常使用。

如果你特别需要此功能，可手动添加。打开设置-搜索-应用搜索，点击 + 按钮添加 PD 应用路径：\~/Applications (Parallels)/。如果嫌文件导航麻烦，可以在点击 + 按钮打开路径选择对话框后按快捷键 <mark style="background-color:blue;">Shift+CMD+G</mark>，然后把上面路径粘贴进去。

<figure><img src="/files/1ZDJdYJpiJrwcxCuPpur" alt=""><figcaption></figcaption></figure>

如果你的 PD 虚拟机应用路径 \~/Applications (Parallels)/ 为空，可能是虚拟机与 Mac 共享应用的设置没有开。打开虚拟系统（如果有多个虚拟系统，需要分别设置），点击顶部菜单栏-操作-配置...。在弹出的设置面板中，点击「选项」标签，切换到「应用程序」，勾选「与 Mac 共享 WIndows 应用程序」。

<figure><img src="/files/pYbzyAcWQcAsLMajx5Hf" alt=""><figcaption></figcaption></figure>

### 添加微信 & 企业微信缓存文件

微信 & 企业微信因为涉及到多个用户在此电脑登录后，新打开的聊天文件都会缓存，这就会存在隐私和安全的问题。所以，我们并没有支持微信缓存文件搜索，但如果你特别需要此功能，请自行添加。添加微信缓存文件搜索如下，企业微信也是类似操作。

1. 打开微信，随便找一个聊天文件，右键打开菜单 - 点击「在 Finder 中显示」。系统会自动打开 Finder，并定位到此文件。此时，我们需要按 <mark style="color:red;">**2**</mark> 次 CMD+↑，向前翻 2 级文件夹到文件夹「MessageTemp」。
2. 打开 HapiGo 设置 - 搜索 - 文件搜索，点击 + 按钮打开路径选择对话框。此时，将上面 MessageTemp 文件夹拖拽到此对话框即可定位到此文件夹，最后点完成。


# 文件导航模式

因为 HapiGo 的轻便性，所以有部分用户会在需要进行文件导航时使用 HapiGo 代替 Finder。

在文档搜索模式下（混合搜索不区分），输入 <mark style="background-color:blue;">/</mark> 可以进入系统根目录，输入 <mark style="background-color:blue;">\~</mark> 进入用户跟目录，粘贴路径则可以直接进入此路径。

<figure><img src="/files/0U8YwuOhEv3BMlR9mBD3" alt=""><figcaption></figcaption></figure>

进入文件导航模式后，可以使用左右键来切换上下级路径，也可以使用回车键进入下级目录。如果输入关键词，则会搜索当前目录下的文件或文件夹。

请注意：此种模式下，底部动作栏无法使用左右键切换，只能通过 Option + 数字或双击执行。

<figure><img src="/files/JUdAsitfG2D6xAwh9GYz" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
macOS 各个路径下都有「.」开头的隐藏文件，如果你想访问/搜索这些文件，则只需要输入 <mark style="background-color:green;">.</mark> 即可
{% endhint %}


# 设置与设置面板

HapiGo 的设置主要通过 2 种途径来进行：

1. 扩展设置
2. 设置面板

### 扩展设置

顾名思义，就是某个扩展需要临时变更设置，就可以在扩展自带的设置菜单中进行。

#### 剪贴板/翻译/OCR/GPT AI 设置：

对于这 4 种有独立窗口的扩展，在他们窗口的右上角都有一个齿轮菜单，里面包含了快速调整的设置项。

<figure><img src="/files/cCDdCLyFYg8jkm59nBXa" alt="" width="563"><figcaption></figcaption></figure>

#### 扩展预览区设置：

主窗口的扩展，比如书签搜索、已开链接、终端等，都在其右侧预览区的右上角有一个齿轮菜单，可以对扩展进行调整。

<figure><img src="/files/SHR6j8R2Su4lmgNOw487" alt="" width="563"><figcaption></figcaption></figure>

### 设置面板

设置面板是绝大部分设置项所在区域，打开任意窗口后按 <mark style="background-color:blue;">CMD+，</mark> 或者顶部右上角菜单栏中可以打开。设置面板目前包含 9 个标签，部分设置会在下文讲解对应功能时涉及，这里我们选择部分设置讲解。但建议你把全部设置都看一遍，这样就知道 HapiGo 的隐藏功能了。

* **通用：**&#x5F00;启权限设置需要确保都打开，macOS 有严格的权限要求，需要开启 3 大项权限才能正常运行。右上角有「导出数据」按钮，可以把一台电脑上的设置和 Snippet 导出保存。
* **软件授权：**&#x8FD9;里可以登录账号，也可以订阅 HapiGo PRO 服务。如果你有多账号登录，也可以在这里进行设备管理。

<figure><img src="/files/eWmNbfYo0LHmja8qKGtx" alt="" width="563"><figcaption></figcaption></figure>


# 剪贴板帮助

剪贴板是启动器工具必备的功能，大有用启动器送剪贴板的感觉。但我们认为剪贴板太重要了。虽然不是每个人都在用，但是日常有很多短小且需要重复使用的文本可以通过剪贴板的交互来完成。所以，我们重新设计了剪贴板，让其变得更强大、更有用、更好用。

### 列表视图与横向卡片视图

与常规的剪贴板不同，我们根据大家的反馈和自己的使用体会，设计了 2 款显示视图：列表视图和横向卡片视图。<mark style="color:blue;">视图的切换可以在窗口右上角齿轮菜单中进行。</mark>

剪贴板里面都是短内容，大家使用剪贴板时，都希望能直接预览内容。所以，目前最受欢迎的就是卡片视图。HapiGo 的横向卡片视图就是听取了大家的诉求而开发的，同时保持了 HapiGo 一贯的简洁设计风格。

<figure><img src="https://988955870-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeJ5dsxnlROZ0RcoZLc2%2Fuploads%2F49Um8AYV3e7zgUSaoHHI%2F%E6%88%AA%E5%B1%8F2023-06-16%2017.43.08.png?alt=media&#x26;token=04bda875-5008-49c8-8a94-06ccfeb6550c" alt=""><figcaption><p>横向卡片视图</p></figcaption></figure>

但卡片视图也有缺点，就是会占用大量屏幕空间，且能显示的条目有限。但是传统的列表视图缺点也不少，比如每一个条目能显示的文本有限，且能预览的内容也比较有限。于是，我们开发了可以根据内容动态调整行高的列表。比如：文本可以预览 1\~5 行，图片也可以有足够的空间显示预览。实际使用下来，我们（日常拷贝内容，文本多于图片）觉得列表视图比横向卡片视图更好用。

<figure><img src="/files/npolzmex23zQH52VFeOm" alt="" width="375"><figcaption></figcaption></figure>

### 尽量使用快捷键

HapiGo 是一款快捷键工具，大部分功能都可以使用键盘进行操作。这样的设计理念也运用到剪贴板中，你可以使用快捷键完成绝大部分操作。

一般我们只要记住其中最主要的几个快捷键：

* 启动快捷键：Shift+CMD+C（copy）
* 编辑快捷键：CMD+E（edit），编辑后 CMD+Enter 保存
* 粘贴/粘贴为纯文本：Enter/CMD+Enter（如果勾选默认粘贴为纯文本，那么粘贴就是 CMD+Enter）

更多的快捷键，就看个人是否有需求了。

<div align="center"><figure><img src="/files/g2U1ZjmfD97FxG96rj0a" alt="" width="257"><figcaption></figcaption></figure></div>

### 常用实用功能

除了基本的拷贝/粘贴，HapiGo 剪贴板也具备独立剪贴板应用的常见功能。

* **多选合并粘贴：**&#x5BF9;于多行文本，如果需要合并，可以多选然后回车粘贴。多选后按 CMD+C，会将这几行文本合并成新的剪贴板条目。
* **类别过滤：**&#x901A;过输入框右边过滤图标，可以分别过滤：文本、图片、文件、颜色等等类别，方便更快的筛选。
* **保存至桌面：**&#x4F60;可以通过右键菜单，将各种类型的剪贴板内容保存至桌面。比如：文字会保存为 txt，图片会保存为图片文件，文件会保存为同格式文件。
* **Handoff 剪贴板：**&#x48;andoff 剪贴板会被记录，并使用特别的图标来标识<img src="/files/wqXokGhHmSe3tpCAsoj4" alt="" data-size="line">。但是，如果你不需要记录，也可以在设置中关闭。&#x20;
* **应用忽略：**&#x5728;应用设置-剪贴板设置中，可以添加不记录历史剪贴板的应用。比如：钥匙串或密码类应用，就不会有敏感信息曝光的风险。
* **保存至分组：**&#x5728;下一章中讲解 [Snippet 帮助](/clipboard/snippet)
* **顺序粘贴板：**&#x6253;开剪贴板后按 CMD+T 会打开顺序粘贴板。此时，你可以连续按 CMD+C 拷贝内容，然后到目标应用连续按 CMD+V 粘贴。先拷贝的，先粘贴；点击左下角排序按钮后，先拷贝的，最后粘贴。这个功能特别适合需要填写表格、个人联系信息等场景。

<figure><img src="/files/mN2GPI12giIE4KdqqR76" alt="" width="375"><figcaption></figcaption></figure>


# Snippet 帮助

{% hint style="info" %}
更多功能还在开发中，敬请关注后续更新。
{% endhint %}

### Snippet 是什么？

Snippet 对大部分用户可能是一个陌生词，但是可能一部分人其实无形中已经使用过类似的功能。比如，你输入 (r)，会自动弹出商标符号 ®，这就是一个 Snippet：当我输入一个预定义的短关键词时，会自动替换成一段长文本/文件/图片等内容。

使用 HapiGo Snippet 的过程就是将一段长文本/文件/图片（文件/图片将在后续版本支持）保存起来，然后为其分配一个短关键词。下次输入这个短关键词来调用这个长文本。当然，也不一定要分配关键词，也可以直接通过剪贴板面板搜索，然后回车粘贴。

<figure><img src="/files/YH3OuZpobJkpz499t6le" alt=""><figcaption></figcaption></figure>

### 新建分组

HapiGo 支持将 Snippet 保存至不同分组。在剪贴板面板的顶部就是分组条，默认只有全部和剪贴板 2 个分组。大家可以通过分组条最右侧的加号 + 按钮来新建分组。

这些分组可以通过 tab 或 <mark style="background-color:blue;">Option+数字</mark>来切换，也可以通过拖拽的方式进行排序。如果需要修改分组，直接在分组上点击右键，选择编辑即可。

<figure><img src="/files/CZucCXYAwajUIi8GAgts" alt=""><figcaption><p>Option+数字切换分组</p></figcaption></figure>

### 新建 Snippet

新建好了分组，我们接下来就可以新建 Snippet 了。你可以从空白、任意应用的选择文本或文本型剪贴板进行新建，按下快捷键 <mark style="background-color:blue;">Option+N</mark> 即可打开 Snippet 编辑面板。这个面板上有多个编辑项，下面分别介绍其含义：

* **标题：**&#x6807;题可以任意填写，方便寻找
* **分类：**&#x76EE;前支持 4 种分类：文本、源代码、脚本和 AI 提示。文本比较好理解，源代码其实也是文本的一种，只是选择了代码类别，可以语法高亮。脚本支持：AppleScript、Bash、Ruby、Python3 和 Swift。这跟上面的源代码是不一样的，脚本会返回执行之后的结果，而不是代码本身。AI 提示又称 AI Prompt，后续会进一步优化。
* **内容：**&#x5185;容的右上角有个 + 号按钮，点击后可以添加多种交互。这样在扩展文本时，就可以让用户直接填写动态内容了。
* **分组：**&#x4E0A;面新建的分组都会显示在这里，如果没有也可以直接在这里新建。
* **触发关键词：**&#x53EF;选项，建议尽量使用「:abc123」「;abc123」这类特殊格式，避免跟正常的输入发生冲突。
* **输出模式：**&#x5F53;分类选择脚本时，会出现「输出模式」，这也就是设置将脚本的执行结果以何种方式返回。目前支持 4 种：粘贴：直接粘贴到前置应用；拷贝：拷贝到剪贴板；静默：无任何提示或操作；顶部通知：会将返回的结果以顶部通知的方式提示。

### 导入/导出 Snippet

当需要进行备份或分享 Snippets 时，可以将他们进行手动导出。选择需要导出的 snippets，点击鼠标右键打开菜单，点击导出即可。

收到 snippets 文件的用户只要双击 hasnp 文件即可进行导入。

### 使用示例

#### 快速填写电话

我们经常需要填写类似电话这类信息，之前很多用户都会选择手输，现在我们使用 Snippet 来完成。按下 Option+N，输入电话、标题和分组，在触发关键词处输入「;myph」。之后在需要输入电话时，只要输入「;myph」即可。如果不喜欢触发关键词，也可以打开剪贴板面板搜索电话并回车。

<figure><img src="/files/lfowfOIgRM9eqxJKmuIg" alt=""><figcaption></figcaption></figure>

#### 发送模板邮件

在 HapiGo 的日常运营中，我经常需要给用户回复邮件。有些邮件主要内容相同，只是用户名字等少数地方需要临时修改。这种情况，我们可以使用 Snippet 的交互组件功能来完成。

Option+N 新建 Snippet 后，将事先准备好的模板邮件填入内容区。在内容区的右上角有一个 + 按钮，点开后一共 8 项。上面是可以让用户输入的交互组件，下面是可以直接生成内容的交互组件。

<div align="left"><figure><img src="/files/jDW7hLQrVkKWkcgnWlD5" alt="" width="264"><figcaption></figcaption></figure></div>

以下面的邮件模板为例：用户姓名 & 最后的签名都是不需要分行的文本，我们可以添加「单行输入」，然后输入字段名称和默认内容。默认内容在展开时会自动填充，也可以根据需要再修改。有时候邮件的回复内容会是多个模版里选择，这时候可以添加「弹出菜单」或「复选框」。

<figure><img src="/files/JpHZKXM0ECGgc2HkFyCT" alt=""><figcaption></figcaption></figure>

邮件模板设置好后就可以使用了。新建邮件后可以直接输入触发关键词或通过剪贴板面板搜索并回车。这时因为这个 Snippet 是有交互的，所以会弹出一个填写面板。我们根据设定填写内容并回车，一封邮件就写好了。

<figure><img src="/files/C4h3M0dYKk5TN4d2Te3O" alt=""><figcaption></figcaption></figure>

#### 直接填入当前 IP

对于开发者而言，他们技术水平较好，此时可以编写一些可执行脚本类型的 Snippet。这里以使用 bash 获取当前 IP 为例：Option+N 新建 Snippet，分类选择「脚本-Bash」。填入脚本 & 触发关键词并保存。请注意最后的输出模式，如果你需要直接在编辑器里打印出来，需要选择粘贴。

```bash
# Get IP address and paste
curl 'https://api.ipify.org/?format=text'
```

<figure><img src="/files/GQDBIOWLTCL680AStaiQ" alt=""><figcaption></figcaption></figure>


# 了解 HapiGo 扩展

HapiGo 为大家提供搜索并启动各种本地应用、在线系统及网站的功能。在此基础之上，我们希望扩展 HapiGo 启动之外的操作。比如：在 HapiGo 中搜索启动 Bear 中的笔记、​快速查看日历中的日程、搜索 Notion 中的任务、向 Flomo 快速添加 memo 等等。

**扩展主要分为 3 类：**

1. **基于本地应用的扩展**：与本地应用的数据和命令进行交互。进入方式为先搜索本地应用，然后按「Tab 或空格」进入
2. **单独新增的独立扩展**：与在线系统或网站的数据和命令进行交互。进入方式为输入快搜关键词，然后按「Tab 或空格」进入
3. **基于某项能力衍生的扩展**：比如：基于截图能力衍生的OCR和截图翻译，基于选词能力衍生的选词翻译。衍生扩展进入方式为快捷键，剪贴板的快捷键 <mark style="background-color:blue;">CMD+Shift+C</mark>、截图翻译 <mark style="background-color:blue;">Option+S</mark>、选词翻译 <mark style="background-color:blue;">Option+D</mark>、OCR <mark style="background-color:blue;">Option+A</mark>。

### 应用扩展

* **备忘录**：搜索备忘录内容，支持预览及新建、拷贝、删除等操作
* **Bear**：搜索 Bear 笔记，支持预览及新建、拷贝、删除等操作
* **1Password**：搜索密码书签
* **Craft**：搜索 Craft 笔记，支持预览及新建和拷贝链接操作
* **Dash**：搜索技术手册，支持直接预览
* **FileMaker**：直接打开收藏和最近打开数据库
* **DevonThink**：搜索 DT 中的文档，支持预览
* **Zotero**：搜索 Zotero 中的文档，支持预览
* **快捷指令**：搜索快捷指令，支持直接执行和在快捷指令中编辑
* **柠檬清理**：支持一键清理动作

### 独立扩展

当某个系统在本地没有实体应用时，我们就会单独创建一个扩展。

现阶段，当需要进入独立扩展时，需要通过内置的关键词。部分比较特殊的扩展，会在输入对应数据类型时自动触发（计算、链接、Unix 时间戳等）或数据可以直接搜索（书签搜索）。

近期我们会将扩展进入方式调整为名称搜索+关键词的方式，这样应用和扩展就可以保持一样的搜索启动方式。

* **书签搜索**：关键词：sq 或 bmk，同时也可以在主搜索框直接搜索书签内容。支持的浏览器：Chrome、Safari、Edge、Firefox
* **打开链接**：当输入链接时，会自动触发。「Chrome、Safari、Edge」浏览器打开的标签也会参与自动搜索。
* **查询 IP**：关键词：IP
* **退出应用或进程**：关键词：kill。之后使用 Tab 键可以进入扩展。
* **转换 Unix 时间戳**：关键词：ut。同时，当输入时间戳或 Unix 时间戳时，会自动识别。
* **flomo**：关键词 flomo
* **简悦**：关键词：jy

### 衍生扩展

衍生扩展的进入方式为快捷键，如果不习惯初始快捷键，可进入设置自行修改。

![](/files/A8IbB9m0zsEQqioVwFle)

* **剪贴板**：使用快捷键 <mark style="background-color:blue;">CMD+Shift+C</mark> 进入
* **聚合翻译**：截图翻译 <mark style="background-color:blue;">Option+S</mark>、选词翻译 <mark style="background-color:blue;">Option+D</mark>、OCR <mark style="background-color:blue;">Option+A</mark>
* **OCR**：快捷键 <mark style="background-color:blue;">Option+A</mark>


# GPT AI (beta)

{% hint style="info" %}
注意事项：

1. 目前提供开箱即用的 AI 服务，但是考虑到政策问题，后续可能需要特殊网络环境才能访问。
2. GPT AI 目前处于 beta 阶段，部分功能仍然在完善中。
   {% endhint %}

{% content-ref url="/pages/x0IlD8ihaYrDgkcmfw5k" %}
[自定义 DeepSeek](/extention/deepseek)
{% endcontent-ref %}

### 设置 API Key 及自定义域名

{% hint style="warning" %}
不建议使用出处不明的转发服务器，有对话信息泄漏的风险。
{% endhint %}

HapiGo 提供开箱即用的 AI 服务，但也支持使用自己的 ChatGPT API Key 及转发服务器。如果你不了解或不需要这部分设置，可跳过此部分。&#x20;

* **使用 OpenAI 的 API Key：**&#x53EA;在 GPT AI 设置中填写你的 API Key 即可
* **使用转发服务器（需要 Key）：**&#x5728; GPT AI 设置中填写你的 API Key 和自定义域名
* **使用转发服务器（无需 Key）：**&#x53EA;在 GPT AI 设置中填写你的自定义域名即可

### 打开与界面介绍

HapiGo 在最新版中支持了 ChatGPT 对话，使用默认快捷键 <mark style="background-color:blue;">Option+i</mark> 即可打开 ChatGPT 对话。如果你对此快捷键感到不适，可以在设置中调整。

AI 目前还处于早期阶段，已经成形的使用场景是：1. 连续对话；2. 针对文本进行快速操作。所以，HapiGo 针对这两种情况设计了伸缩窗口：1. 当需要对话时，可以将窗口拉长，以显示更多内容；2. 当需要对文本进行操作时，可以把窗口缩小，这样可以减少 AI 窗口遮盖底下的内容。

同时为了更方便的操作文本，我们设计了动态回车按钮：当输入文本时，回车会提交问题；当 AI 在返回回复时，回车会中断生成；如果回复已经全部生成，回车就是粘贴回复至前置窗口。这样，配合小窗口模式，就可以获得较好的操作体验。

<figure><img src="/files/on3s9CbB0ySPEP45GfXT" alt="" width="563"><figcaption></figcaption></figure>

### 基于角色的对话

大模型 AI 由于受到海量数量的训练，使得其可以提供比较智能的回复。但是也由于宽泛的覆盖度，使得有时候回复并不太满足我们的需求。这时候，就需要给 AI 指定一个任务角色，圈定一个知识领域，让 AI 的回复更加聚焦。

打开 GPT AI 窗口，左侧边栏就是角色栏。如果没有，可能是隐藏了。点击顶部标题就会弹出角色菜单。点击+按钮，就可以新建角色了。角色设定的 AI 术语为「System Prompt」，即可以指定整个对话的默认设定。有了这个设定，后续的对话就会省去很多输入。如果没有 System Prompt 设定，那么在通用对话中要达成同样的效果，就需要每次对话时都输入完整的 Prompt 指令。下面通过 3 个案例来说明，设定系统角色的应用。

<figure><img src="/files/xAGaStYkZzWDCmkrq3hu" alt=""><figcaption></figcaption></figure>

#### 中英文互译

这个例子只是示范，实际使用环境下，HapiGo 翻译更加高效快捷。

> 请担任中英文翻译官，请检查信息是否准确，请翻译得自然、流畅和地道，使用优美和高雅的表达方式。无论对方回复什么，你只需将内容翻译为中文或英文。您应该只回复您翻译后的内容，而不应回复其他任何内容，不要写解释。

在这个角色下，你发送的文本如果是中文，则会翻译成英文；输入英文则会翻译成中文。但是如果输入了带有指令性质的文本时，可能导致回答紊乱。

#### 小红书文案

> 请担任文案高手。无论接下来输入什么，你都需要使用小红书的风格生成一篇种草文。注意：你的写作风格必须严格参考小红书平台上的写作风格；并且在排版方面要多分段，多使用emoji

在这个角色下，你发送跟产品或事件相关的文本，将会得到一段小红书风格的长段回复。

#### 编写正则公式

> 我希望你充当正则表达式生成器。您的角色是生成匹配文本中特定模式的正则表达式。您应该以一种可以轻松复制并粘贴到支持正则表达式的文本编辑器或编程语言中的格式提供正则表达式。不要写正则表达式如何工作的解释或例子；只需提供正则表达式本身。

在这个角色下，你发送正则需求，将得到直接可用的正则公式。比如：查找邮件、查找中国的手机号。如果你在普通对话中这么问，将可能会得到错误的回答。

但是，系统角色也不是必须。比如如果需要编写「查找邮件」的正则，你也可以在通用问答中直接写需求：请编写查找邮件的正则公式，也可以得到满意的结果。大家可根据自己的需要进行灵活使用。


# 自定义 DeepSeek

HapiGo GPT AI 对话支持使用主流 AI  的自定义 API。以下为 DeepSeek 官网和硅基流量版 AI 自定义设置教程。

### 阿里版 DeepSeek <a href="#ali-bailian" id="ali-bailian"></a>

{% hint style="info" %}
阿里百炼为一站式 AI 云服务平台，即阿里百炼提供市面上包括 DeepSeek 在内的大部分 AI 模型。只要添加对应的模型名称，即可调用。
{% endhint %}

1. 访问阿里百炼官网：<https://bailian.console.aliyun.com/>
2. 使用账号登录
3. 登录后，点击右上角的头像图标，在菜单中点击：API-KEY（见下图） &#x20;

   <figure><img src="/files/WS2wPBKKnlHD7Ev9bQTV" alt=""><figcaption></figcaption></figure>
4. 在新界面中创建 API key，并拷贝
5. &#x20;打开 HapiGo 设置，切换到 「扩展」 - 「GPT AI」
6. 在 AI 服务处选择 「自定义」，然后输入 API key
7. 代理选择 「自定义域名」，并输入：<https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions>
8. 在 AI 模型菜单中，分别添加 V3：<mark style="background-color:blue;">deepseek-v3</mark> 和 R1：<mark style="background-color:blue;">deepseek-r1</mark> 模型。

如上面所述，阿里百炼提供全面的 AI 模型服务，只需要添加对应的模型名称即可。模型列表可以在模型广场页面获取：<https://bailian.console.aliyun.com/#/model-market>

模型名称需要点开模型才能看到，具体参考下图。

<figure><img src="/files/j5GwwaXOR0pOKfapznyy" alt=""><figcaption></figcaption></figure>

### 官方版 DeepSeek <a href="#deepseek" id="deepseek"></a>

1. 访问 DeepSeek 官方开放平台网址：<https://platform.deepseek.com/>
2. 使用合适的方式进行登录
3. 登录后，在左边栏切换到 「API keys」，然后创建并拷贝 API key。&#x20;

   <figure><img src="/files/qqryH0HXosUXNw1cLLuV" alt=""><figcaption></figcaption></figure>
4. 打开 HapiGo 设置，切换到 「扩展」 - 「GPT AI」
5. 在 AI 服务处选择 「自定义」，然后输入 API key
6. 代理选择 「自定义域名」，并输入：<https://api.deepseek.com/>
7. 在 AI 模型菜单中，分别添加 V3：<mark style="background-color:blue;">deepseek-chat</mark> 和 R1：<mark style="background-color:blue;">deepseek-reasoner</mark> 模型。
8. 后续选择对应的模型即可。

### 硅基流动版 DeepSeek <a href="#siliconflow" id="siliconflow"></a>

{% hint style="info" %}
硅基流动为一站式 AI 云服务平台，即硅基流动提供市面上包括 DeepSeek 在内的大部分 AI 模型。只要添加对应的模型名称，即可调用。
{% endhint %}

1. 访问硅基流动网址：<https://www.siliconflow.com/zh/home>
2. 使用合适的方式进行登录
3. 登录后，在左边栏切换到 「API 密钥」，然后新建并拷贝 API 密钥。&#x20;

   <figure><img src="/files/OP4MxRWi9hk6M9jRMBP0" alt=""><figcaption></figcaption></figure>
4. 打开 HapiGo 设置，切换到 「扩展」 - 「GPT AI」
5. 在 AI 服务处选择 「自定义」，然后输入 API key
6. 代理选择 「自定义域名」，并输入：<https://api.siliconflow.cn/>
7. 在 AI 模型菜单中，分别添加 V3：<mark style="background-color:blue;">deepseek-ai/DeepSeek-V3</mark> 和 R1：<mark style="background-color:blue;">deepseek-ai/DeepSeek-R1</mark> 模型。
8. 后续选择对应的模型即可。

如上面所述，硅基流动提供全面的 AI 模型服务，只需要添加对应的模型名称即可。模型名称列表可以在价格页面获取：<https://www.siliconflow.com/zh/pricing>

<figure><img src="/files/9kHuJ8v5IAANBc8apYUT" alt=""><figcaption></figcaption></figure>


# 全能截图

### 开始截图

HapiGo 截图功能通过默认快捷键 <mark style="background-color:blue;">Option+E</mark> 进入，如果不习惯，可以在 HapiGo 「设置 - 扩展 - 截图」 中修改此快捷键。

* **选区**：使用鼠标拖拽即可选取截图区域，此时可重新调整选区。点击会截取前置窗口，此时不可再调整选区。
* **取色**：进入截图后，光标提示会显示当前光标处的颜色。按下 C 可复制色值，按下 Option 可切换色值类别。
* **截取全屏**：进入截图后，按下 F 或点击桌面空白处即可截取全屏。
* **关闭提示**：截图左下角默认出现截图提示，使用熟练后可关闭。截取任意区域，出现工具条后，点击三点菜单图标，最后一项即为关闭菜单项。&#x20;

  <div align="left"><figure><img src="/files/sU9hRI43VkTvSJJLvDIK" alt="" width="350"><figcaption></figcaption></figure></div>
* **关闭十字辅助线**：十字辅助线有助于定位选区，如果不习惯，可在 HapiGo 「设置 - 扩展 - 截图」 中取消。
* **拷贝与保存**：拷贝与保存分别可以从 3 处操作：1. 双击鼠标左键（未选择任意工具）、2. 回车或点击<img src="/files/2uCjvAzMQZlnsDB10h8a" alt="" data-size="line">完成、3. 保存截图菜单 <img src="/files/En7WaF1WXEdNzUXdQtFI" alt="" data-size="line">（可设置快捷键，比如空格）。

### 快捷操作

HapiGo 截图考虑到高效用户的各项使用习惯，设计了多项快捷操作，用于提高操作效率。

* **快捷键**： 截图的每一个工具都可以设置单字母/数字的快捷键，部分工具也提供了默认快捷键。比如：矩形工具快捷键 R、文字工具快捷键 T
* **滚轮 & 触控板手势**：截图后调整圆角、每一个工具的滑动条、钉图后缩放尺寸和透明度等操作都可以通过鼠标滚轮滚动调整。支持滚轮操作的工具提示中都会包含图标<img src="/files/WsNlCFAf1kywuWVwFUdG" alt="" data-size="line">。而钉图缩放尺寸则同时支持触控板缩放手势。
* **双击鼠标左键**：截图保存（未选择截图工具状态）及钉图的关闭操作都支持双击鼠标左键。
* **拖拽操作**：截图或钉图工具栏会有拖拽柄<img src="/files/dKRdbNX02kWzXmNjdmZK" alt="" data-size="line">，拖动就可以直接将截图变成图片文件。拖拽到 Finder，会直接保存成文件；拖拽至聊天工具，可以直接发送文件；拖拽至 Finder 选择文件对话框，可以定位至该图片文件。

### 制作专业的截图标注

HapiGo 截图具备多项可以帮助专业用户高效的截图并标注的工具，下面选取部分讲解。

* **备注**：这是我们团队沟通产品必备功能。点击一次确定圆点，然后移动光标到文本气泡文本，点击确定。
* **美化**：美化功能可以让你几次点击就可以大幅提升截图质感。美化的提升主要是3个方面：1. 背景、2. 边框、3. 圆角。背景可以设置单色、渐变色及墙纸，如果不够也可以设置自定义墙纸。在美化面板的右半部分可以设置内圆角、外圆角即边框。&#x20;

  <figure><img src="/files/zWnSqosUIwtmTHcDy57C" alt=""><figcaption></figcaption></figure>
* **钉图至桌面**：截图之后，按下 P （预设快捷键，可修改）即可将截图钉至桌面。此时，滚动鼠标滚轮，可调节大小；按下 CMD 并滚动鼠标滚轮，可调节图片透明度。如果图片遮住了部分屏幕内容，可以按下 <mark style="background-color:blue;">S</mark> 切换至缩略图，等查看完被遮住的内容再按 <mark style="background-color:blue;">S</mark> 切换回来。

### 定制截图工具栏

HapiGo 截图是首个可以定制工具条的应用。你可以调整截图工具的顺序，对于不常用的工具，也可以隐藏至菜单。对于常用工具，除了往前移动位置，也可以分类 1\~9、A\~Z 这样的快捷键。

* **调整工具顺序**：打开设置 - 扩展 - 截图，在右侧工具列表中拖拽即可调整顺序。注意，一共3种分组，每种工具只能在自己分组中调整顺序。
* **隐藏不常用工具**：最右侧一列，可以设置工具显示隐藏。选择 「工具栏」 即为显示在工具栏，选择菜单，则不显示在工具栏，需要通过工具栏的三点菜单图标访问。 <img src="/files/CqoB1QePI2FUdJRwK3wm" alt="" data-size="original">
* **设置快捷键**：右侧第二列可以设置工具的快捷键，支持 0\~9、A\~Z 快捷键。比如：设置文本工具为 <mark style="background-color:blue;">T</mark> ，那么截图后按下 <mark style="background-color:blue;">T</mark> 就可以添加文本了。


# 聚合翻译

HapiGo 的翻译扩展为用户提供翻译、截图翻译及语音朗读 3 项核心功能。

此 3 项功能均包含互联网服务，需要订阅方能使用。HapiGo 为方便用户使用，提供内置服务。对于使用量较大、动手能力较强的用户，也提供设置自定义 API 功能。

为了方便 HapiGo 用户进行日常轻量级翻译，HapiGo 内置了聚合翻译功能。聚合翻译的结果目前已达到 8 项。

<figure><img src="/files/YzUGqIPKptF3uDE2Z6SM" alt=""><figcaption></figcaption></figure>

### 操作方法

**选词/输入翻译**：使用快捷键 <mark style="background-color:blue;">Option+D</mark> 可以自动翻译鼠标选中的词语或段落。如果没有选中的词，则会打开空白翻译窗口，让你输入词语进行翻译。

**截图翻译**：使用快捷键 <mark style="background-color:blue;">Option+S</mark> 可以打开截图。此时截取需要翻译的屏幕内容，即可自动识别并翻译。

如果对于以上快捷键或者窗口出现位置不习惯，也可以从顶部菜单栏 HapiGo 菜单中进入「设置」-「翻译和 OCR」进行修改。

### 服务付费

HapiGo 为方便用户直接就使用所有翻译服务，提供了内置接口。但所使用的这些服务都是根据使用量而付费的，因此此项服务纳入为付费功能。

**内置服务的字符用量查询：**&#x6253;开翻译窗口，在窗口右上角齿轮菜单的最下面就是翻译使用字符和总字符数。

<figure><img src="/files/Dfcx6TUDY3Ied36tIYaT" alt=""><figcaption></figcaption></figure>

当然，对于部分使用量特别大且动手能力很强的用户，也可以尝试自己注册这些服务的账号。这些服务默认都提供比较大的免费额度，使用自己的 API 密钥相当于免费使用翻译功能。

注册翻译服务的所有操作步骤，我们均已经写成详细文档，大家可自行参考操作。


# 使用 Apple 翻译服务

{% hint style="warning" %}
快捷指令有时候不稳定，操作频率过快或某些特殊情况，可能导致翻译失效。

如果遇到一直提示操作不允许或卡住的情况，请转至文末查看问题解决办法。
{% endhint %}

在最新版本中，HapiGo 支持了 Apple 翻译服务。此服务由 macOS 本地机器学习模型（因此仅支持 macOS 11 以上）提供翻译结果，可以免费无限量使用。

### 安装快捷指令

系统翻译服务仅提供快捷指令一种接口，所以在开始使用 Apple 翻译前，我们需要安装[翻译快捷指令](https://www.icloud.com/shortcuts/05e2e750f57f46e48b6a7f7f3fe9bbec)。

{% embed url="<https://www.icloud.com/shortcuts/05e2e750f57f46e48b6a7f7f3fe9bbec>" %}

打开快捷指令链接后，点击「获取捷径」，然后安装。如果加载缓慢，可以试一下开启🪜。

### 添加&授权

安装好后，我们就可以按下翻译快捷键 Option+D 进行划词或输入翻译了。如果翻译窗口中没有 Apple 翻译服务，可以点击右上角齿轮菜单进行勾选。

第一次使用时，快捷指令会需要你授权。在弹出的授权窗口右下角，点击「始终允许」即可。如果点错了，可以删除重新安装一遍。

<figure><img src="/files/0GUU7pcZy17lvGM1QAi0" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
HapiGo 通过快捷指令的名称进行调用，因此编辑 HapiGo Translation 快捷指令的名称会导致 HapiGo 翻译失效。如需研究学习，可复制一份进行编辑。
{% endhint %}

### 问题解决

#### 问题一：操作不允许

如果按照上文操作已经给到了快捷指令「始终允许」的权限，但是在进行翻译时仍然提示「操作不允许」，此可能是因为 Apple 翻译所用到的 2 个链接被代理🪜了。解决办法是将这 2 个链接添加到代理应用的直连规则中。具体操作，大家自行参考自己所用代理应用的帮助手册。

链接：<mark style="color:blue;">sequoia.apple.com</mark> & <mark style="color:blue;">seed-sequoia.siri.apple.com</mark>

#### 问题二：顶部菜单栏快捷指令卡住

如文首所述，系统翻译有时候可能不稳定。常见的情况就是在顶部菜单栏显示实心快捷指令图标，点开可以看到翻译任务卡住了，等很久也不会有任何进展。

此时，我们需要手动退出翻译进程。打开 HapiGo 主面板，输入关键词「kill」，按 tab 键进入「退出应用与进程」扩展。搜索「translationd」进程，回车关闭该进程即可。

<figure><img src="/files/aFteyo5PQRaCjFwBEKRV" alt=""><figcaption></figcaption></figure>


# 自定义 GPT 翻译 Prompt

HapiGo 翻译的 GPT 翻译服务支持自定义 Prompt，大家可以根据自己的需要打造自己的 AI 工具。

打开设置，进入扩展设置-翻译。在翻译服务设置里双击编辑已有 GPT 服务，或点击右边 + 按钮添加。对于有多种场景需求的，可以添加多个服务。

<figure><img src="/files/NAyjIlXwbiKts0RBwqnb" alt=""><figcaption></figcaption></figure>

自定义 GPT 服务一共有 3 项编辑框（如果是自带 API key 的用户，还需要填入 API key）：

1. 名称：翻译面板中服务的显示名称
2. 角色描述：AI 的角色描述可以有效的聚焦专业领域，会让 AI 的回复更加精准
3. Prompt 提示词：Prompt 是直接的命令语句，可以控制 AI 的返回结果。在此处，一共支持 3 个变量：{text}、{fromLang}、{toLang}。分别为：获取的原文本、原文的语言、翻译目标语言。对于非翻译的使用场景，可以只使用 {text}。

我们提供了几种基础模版，大家可以根据自己的需求进行修改。


# 添加翻译服务

添加自定义翻译服务 API

本章节为大家介绍如何添加百度翻译、有道翻译、腾讯翻译、彩云小译、Google 翻译、DeepL 翻译 7 项 HapiGo 已经支持的翻译服务。

这 6 项服务均提供一定额度的免费字符，基本能满足大部分用户的使用需求。如果不够，大家也可以酌情订阅。

| 服务名称                                                    | 免费额度     | 超额费用                                            |
| ------------------------------------------------------- | -------- | ----------------------------------------------- |
| [百度翻译](/extention/translate/addtranslate/baidu)         | 100万字符/月 | ￥49/百万字符                                        |
| [有道翻译](/extention/translate/addtranslate/youdao)        | 无        | 英译中：￥48/百万字符；中译其他：￥100/百万字符                     |
| [腾讯翻译](/extention/translate/addtranslate/tencent)       | 500万字符/月 | ￥58/百万字符                                        |
| [彩云小译](/extention/translate/addtranslate/caiyun)        | 100万字符/月 | ￥20/百万字符                                        |
| [Google 翻译](/extention/translate/addtranslate/google)   | 50万字符/月  | $20/百万字符                                        |
| [DeepL 翻译](/extention/translate/addtranslate/deepl)     | 50万字符/月  | $5.49/月+$25/百万字符                                |
| [ChatGPT 翻译](/extention/translate/addtranslate/deepl-1) | 18美元     | [不同模型不同价格，访问官网了解更多](https://openai.com/pricing) |


# 百度翻译

注册并添加百度翻译服务

{% hint style="success" %}
百度翻译开放平台：<https://fanyi-api.baidu.com>
{% endhint %}

### 登录 & 注册开发者

* 打开百度翻译开放平台的网站
* 点击右上角登录，使用个人的百度账号登录（若无，则自行注册）
* 首次登录后，需要注册开发者。这里我们选择个人，并按要求填写内容

![](/files/x83tEGScgEd0igizsbTP)

### 开通翻译服务

* 登录后在顶部导航栏点击「管理控制台」
* 在控制台首页中部点击「立即开通
* 在「在线服务」选择页面，选择「通用翻译」
* 然后选择「高级版」（需要个人认证）
* 之后按照需求填写应用内容（除了应用名，其他为选填）

![](/files/e49gOd3OSpkKPaHuLuCS)

### 获取并设置 API

完成翻译服务开通后，在左边导航栏点击「开发者信息」，就可以看到百度翻译的 API 信息了。

![](/files/hvSbdrPd4nTSOhq4Hs8f)

在 HapiGo 的翻译设置中，选择「自定义」，然后点击 + 添加百度翻译。在弹出的对话框中填入上图「APP ID」及「密钥」，点击完成后即可。

![设置 API 密钥](/files/MiQiGzehxWNHBRlrZFTK)


# 有道翻译

注册并添加有道翻译服务

{% hint style="success" %}
有道翻译：<https://ai.youdao.com/product-fanyi-text.s>
{% endhint %}

### 登录 & 注册开发者

* 打开有道智云-文本翻译
* 点击右上角登录，使用个人的有道账号登录（若无，则自行注册）
* 登录后，有道云会赠送 50 元代金券（不定期活动）

### 开通翻译服务

* 登录后在「业务总览」中部点击「创建应用」
* 在应用信息页面按照后面填写模板填写。
* 此处信息有 3 项内容必填：文本翻译、语音合成、API 接入方式（建议也一起勾选文本识别）
* 填写完成后，点击确认即可。

![](/files/lKTSpO0cvbHt905dw96D)

### 获取并设置 API

完成翻译服务开通后，在左边导航栏点击「应用总览」，就可以看到有道翻译的 API 信息了。

![](/files/xe1gzdD6U08kqv7XslA0)

在 HapiGo 的翻译设置中，选择「自定义」，然后点击 + 添加有道翻译。在弹出的对话框中填入上图「APP ID」及「密钥」，点击完成后即可。

![设置 API 密钥](/files/MiQiGzehxWNHBRlrZFTK)

### 增加朗读语言

倘若你在上面的设置中忘记勾选「语音合成」权限，那么有道翻译提供的单词朗读功能将不能使用。此时，你需要登录到有道智云管理后台重新勾选。

左侧导航定位到「应用总览」，右边区域找到你的应用并点击修改。在此修改界面上勾选智能语音服务-语音合成，然后确定保存。

<figure><img src="/files/s69lFawnVYm8thQR0ez1" alt=""><figcaption></figcaption></figure>


# 腾讯翻译

注册并添加腾讯翻译服务

{% hint style="success" %}
腾讯翻译：<https://cloud.tencent.com/product/tmt>
{% endhint %}

### 登录 & 注册开发者

* 打开腾讯云-机器翻译网站
* 点击右上角注册，可以使用微信注册
* 注册后需要进行「个人认证」。认证可以使用网页，也可以使用微信认证。

![](/files/R67cbzgIeWr2t7ZM0qn6)

### 开通翻译服务

* 登录后在「云产品」菜单中找到「机器翻译」并打开
* 点击开通「免费试用」，如果不介意也可以开通「付费版」

![打开「机翻译」](/files/m69FvhRmgVf6vozOmewv)

### 新建用户

开通服务后需要新建子用户，并开启翻译权限。

* 点击窗口右上角头像菜单，再打开「访问管理」
* 在「访问管理」左边列表中选择「用户」-「用户列表」
* 点击「新建用户」-「快速创建」

![打开「访问管理」](/files/3CFXebjGDRwg7LAe1BNv) ![新建子用户](/files/bPkTslBuaY2kwZL79VJT)

* 在快速创建用户页面按照如下图示填写，请记得更改「访问方式」和「用户权限」

![新建用户](/files/Pe5w78YEZyrv9d27kMY6) ![勾选「机器翻译」权限](/files/eQ5F2yA60CW2y6WjRUJr)

* 用户创建成功后就可以直接获得 API 密钥信息了

![](/files/AgZRjcks1wOzbTvpaqOE)

### 设置 API 密钥

在 HapiGo 的翻译设置中，选择「自定义」，然后点击 + 添加腾讯翻译。在弹出的对话框中填入上图「Secret ID」及「Secret Key」，点击完成后即可。

![设置 API 密钥](/files/MiQiGzehxWNHBRlrZFTK)


# 彩云小译

注册并添加彩云小译翻译服务

{% hint style="success" %}
彩云科技：<https://caiyunapp.com/>
{% endhint %}

### 登录 & 注册开发者

* 打开彩云科技的官网，点击导航栏「开放平台」
* 安装登录页的提示进行账号注册
* 登录后，需要先完善账号信息

![完善账户信息](/files/P4sXoprjDpvExORZAm3o)

![完善令牌申请信息](/files/gA3xdRKwS71IUqIJfXpb)

### 获取并设置 API

提交申请后，需经过彩云小译工作人员人工审核。审核完成后，在左边导航栏点击「应用总览」，就可以看到彩云小译的令牌（Token）信息了。

![](/files/F4RsbdgZSRrRg0k7ZSed)

在 HapiGo 的翻译设置中，选择「自定义」，然后点击 + 添加彩云小译。在弹出的对话框中填入上图「Token」，点击完成后即可。

![设置 API 密钥](/files/MiQiGzehxWNHBRlrZFTK)


# Google 翻译

注册并添加 Google 翻译服务

{% hint style="warning" %}
注册 Google 翻译需要具备 2 个条件：

1. 具备访问 Google 网站的网络条件
2. 持有 VISA、MasterCard、AmericanExpress 信用卡
   {% endhint %}

{% hint style="success" %}
Google 翻译：<https://cloud.google.com/translate?hl=zh-cn>
{% endhint %}

### 登录 & 开通翻译服务

* 打开 Google 翻译网站
* 点击右上角登录（如无账号，可自行注册）
* 登录后点击「免费试用 Translation」

![](/files/xhi8bav3o9JgBEo2xIWg)

* 后续需要完善账号信息和付款信息，请按图填写

![完善账号信息](/files/jtI2q2MEsKWvR71ThU5m) ![完善付款信息](/files/IcSDTbhz2MZg0VTLnIhF)

* 对于新账号，Google Cloud 提供使用期限 90 天的 $300 元赠金。请注意网页提示，进行激活。

![](/files/wBlG7SZ6HvdfSmnfPVfO)

* 以上完善账号信息后，接着开始启用翻译服务 API。在顶部搜索栏输入「translation」，并点击第一个结果「Translation」

![](/files/rKbJBEKvi4kt6CDaFIIw)

* 打开翻译后，点击「启用 API」

![](/files/xdY9W3hpgAQg05no4fKf)

### 创建凭证

* 在顶部搜索栏输入「api」，在结果中点击「API 和服务」

![](/files/ZjppdIx7dat1Cv6uJLpD)

* 在左侧导航切换到「凭证」，并点击「创建凭证」-「API 密钥」

![创建密钥](/files/lO50j9XYHgSl9I5FFF4O)

![API Key](/files/0aEoRz5trJMRbuNKvKpz)

### 设置 API 密钥

在 HapiGo 的翻译设置中，选择「自定义」，然后点击 + 添加 Google 翻译。在弹出的对话框中填入上图「API Key」，点击完成后即可。

![](/files/MiQiGzehxWNHBRlrZFTK)


# DeepL 翻译

注册并添加 DeepL 翻译服务

{% hint style="warning" %}
DeepL 仅在美国、加拿大、日本及欧洲大部分国家提供 Pro 服务。这意味着，你只有使用以上国家办理的信用卡及地址才能成功订阅免费或付费的 Pro 服务。​
{% endhint %}

{% hint style="success" %}
DeepL 翻译：<https://www.deepl.com/zh/pro#developer>
{% endhint %}

### 注册 & 登录

如果你具备开头所说的海外信用卡及地址，那么就可以打开上面链接注册 DeepL 账户了。

点击「DeepL API Free」计划栏的免费注册，后续按照引导填写相关信息。

![](/files/h1hTjIHALZc2M8sGeYHg)

### 获取并设置 API

注册并订阅免费计划成功后，就可以点击右上角登录邮箱处，进入我的账户。在「账户」标签的最下方就可以看到 DeepL 的 API Key 了。**请注意，这个 Key 只要注册了账户就会有，但是只有订阅了免费或付费计划后才能使用。​**

![打开我的账户，滚动到最下方](/files/C72CkciOVnBKagBxvmv6)

![](/files/mioieNvSJ0dVrISJNrae)

在 HapiGo 的翻译设置中，选择「自定义」，然后点击 + 添加 DeepL 翻译。在弹出的对话框中填入上图「API Key」，点击完成后即可。

需要注意的是：DeepL 的 API 分为免费版和付费版，两者不能互通。所以，在填写 API Key 时，请根据自己的账号，选择对应的 API。

![设置 API 密钥](/files/MiQiGzehxWNHBRlrZFTK)


# ChatGPT 翻译

添加 ChatGPT 翻译服务

{% hint style="warning" %}
ChatGPT 未在中国大陆开通服务。这意味着：你必须要具备访问海外服务的网络环境、能接收短信的海外电话或虚拟服务才能注册 ChatGPT​，具备海外开办的信用卡（虚拟海外信用卡可能导致 Plus 封禁）或相关支付方式才能开通 Plus 服务。

基于此项原因，请大家自行搜索注册方法，本文不提供相关指导。
{% endhint %}

{% hint style="success" %}
ChatGPT 翻译：<https://platform.openai.com/overview>
{% endhint %}

### 获取并设置 API Key

假设你已经成功注册 ChatGPT，打开上面链接，点击右上角的 Login 按钮登录。

登录成功后，点击右上角头像，在下拉菜单中点击「View API Keys」。在这里，你可以查看或创建 API key。如果创建新 Key，请自行复制保存，后续无法再次复制。

获取 API key 后，进入 HapiGo 设置 - 翻译与 OCR。在下方设置中选择自定义翻译服务，然后通过右下方的 + 号按钮添加 ChatGPT 翻译服务。在对话框中输入 API Key 即可。

<figure><img src="/files/iGXmjKlGTIT3isSRcUFa" alt=""><figcaption></figcaption></figure>


# 文本及二维码识别 OCR

HapiGo 内置了截图识别文本和二维码识别，方便有需求的用户使用。使用默认快捷键 <mark style="background-color:blue;">Option+A</mark>（可在设置中修改）打开截图，截取需要识别的文本即可。

### 识别服务

HapiGo 内置了本地**快速识别**、**本地精准识别**及**在线多语言识别**。前两者由 macOS 本地的机器学习提供结果，因此免费提供给所有用户。第三项为在线服务，支持多种语言自动识别。精度更高，识别语音更多，更智能。但是，此服务需要订阅 PRO 服务后方可使用，目前不限额度。

<figure><img src="/files/kemSSEO3UVEDx0bAS1U1" alt=""><figcaption><p>选择识别服务</p></figcaption></figure>

二维码识别亦为本地识别，可以免费离线使用。

### 识别模式

HapiGo 的识别分为**常规识别**和**静默识别**。

常规识别会在截图后打开窗口显示图片和识别后的文本，这样方便查看或修改识别结果。但是目前识别结果都还比较精准，所以一直弹出窗口也很麻烦。这时候，我们可以在窗口右上角齿轮菜单中开启「静默识别」。

静默识别不会打开窗口，而是将识别结果拷贝至剪贴板，并通过顶部通知提示你已拷贝结果。为方便你预览识别结果，顶部通知会包含部分识别文本。如果结果有误，可以点击识别通知打开文本识别窗口进行修改；也可以通过快捷键 <mark style="background-color:blue;">Shift+CMD+C</mark> 打开剪贴板后按 <mark style="background-color:blue;">CMD+E</mark> 进行修改。

<figure><img src="/files/QjYu4t3h3M26uv73LjRO" alt=""><figcaption><p>点击顶部通知，可以打开 OCR 窗口</p></figcaption></figure>


# 网页直达

网页直达是一个非常好用的功能，其主要目的是：

1. 通过几个字符就可以快速打开常用网页
2. 对于搜索引擎这类需要输入关键词的网站，可以直接传递关键词

比如，对于我们经常使用的百度，我们打开 HapiGo 主窗口后输入 bd，即可匹配百度搜索。按下 tab 后即可输入需要搜索的关键词，回车后我们就可以在浏览器里得到最后的搜索结果了。

### 创建网页直达

一般有 3 种方式可以创建网页直达：

1. 在「设置-网页直达」中创建
2. 将网页粘贴到主搜索框后，通过底部「保存至网页直达」动作创建
3. 搜索 [已开浏览器标签搜索](/extention/tabsearch#sou-suo-yi-kai-biao-qian) 或 [浏览器书签搜索](/extention/bmsearch) 时，也可以通过底部「保存至网页直达」动作创建

快速打开链接并非网页直达的全部功能，所以我们还需要了解网页直达创建面板上的各项设置的含义：

<figure><img src="/files/wXB0pI7Ve0dZYPFAZI4T" alt=""><figcaption></figcaption></figure>

* **显示名称：**&#x8FD9;里填写的内容会在 HapiGo 主列表中显示，可以理解为标题
* **关键词：**&#x8BBE;置简短好记的几个字符，用来快速匹配此网页直达
* **默认浏览器：**&#x8FD9;里可以设置按系统默认浏览器，也可以指定专门的浏览器
* **直达网址 1\~3：**&#x31;\~3 的内容都是一样的，为的是一次性打开 1\~3 个网页。链接里可以包含多个参数，每一对花括号会识别为 1 个参数，花括号里的 {内容} 会识别成参数的名称。
* **无搜索转到：**&#x6709;些网址虽然可以输入关键词，但是并不是所有时候都需要输入关键词，有时我们可能想直接打开网站的主页或其他页面。如果直接使用设置了参数的链接，可能就会打开一个无搜索页面，而不是主页。那么这个输入框就可以设置用户不搜索时，跳转的链接。
* **添加图标：**&#x5982;果没有设置，HapiGo 会自动获取网站 ico 图标

{% hint style="info" %}
如何找到某个搜索网站的直达网址：

1. 打开这个网页，输入英文关键词（比如：HapiGo）并搜索
2. 复制执行搜索后的 URL 链接，把其中 HapiGo 替换成：{query}，query 可以按你自己的意愿和场景需要任意命名。
   {% endhint %}

{% hint style="info" %}
直达网址除了日常的 http\:// 和 https\:// 协议，其他 URL Scheme 协议也支持。比如 HapiGo 的协议 [API & PopClip 插件](/adv/urlscheme#url-scheme)
{% endhint %}

### 设置默认搜索

为了达到更无缝的使用体验，很多用户会直接在主输入框输入需要搜索的关键词，并希望直接就可以回车搜索。这时，我们就要将搜索的网页直达设置成默认搜索。

打开设置-网页直达，找到对应的网页直达，勾选「默认搜索」即可。

<figure><img src="/files/Wf4O6WzIgyP2ic48nPCA" alt=""><figcaption></figcaption></figure>


# 浏览器书签搜索

书签书签HapiGo 书签搜索扩展可以让你搜索多个浏览器中的书签。

输入关键词「sq」或「bmk」可以匹配「书签搜索」扩展，按下 tab 或空格进入「书签搜索」扩展。此时，我们输入关键词（支持拼音）即可搜索来自多个浏览器的书签。

### 书签搜索设置

在书签右上角有一个齿轮菜单，这里可以进行 3 项快速设置。

1. **书签直搜：**&#x5F00;启后，可以直接在主搜索框搜索书签。如果目标结果在第一个，直接回车即可打开。
2. **书签来源：**&#x48;apiGo 支持 Safari、Chrome、Edge、Firefox 等常见浏览器书签搜索。但是如果某些浏览器书签你不需要搜索，可以取消勾选。
3. **指定浏览器打开书签：**&#x4F60;可以使用书签所在浏览器打开，也可以指定默认浏览器或其他任意浏览器。

<figure><img src="/files/TkKbhI54fXVhHn9lCwbw" alt=""><figcaption><p>书签直接搜索</p></figcaption></figure>


# 已开浏览器标签搜索

经常上网的用户可能会遇到的一个困扰，开了特别多浏览器窗口和标签，每次要转到某个标签就特别费劲。又或者拷贝了一个链接，需要快速跳转。针对这样的情况，HapiGo 增加了搜索浏览器已打开标签和打开网页链接的功能。已经支持的浏览器：Safari、Chrome、Edge。

### 打开链接

打开 HapiGo 主窗口，我们输入或粘贴链接，就可以匹配到「打开链接」这个扩展了。此时，回车就可以在默认浏览器中打开此链接。当然，底部动作栏也提供了多个动作可以做其他用途，比如：使用非默认浏览器打开或保存链接至网页直达。

### 搜索已开标签

搜索已开标签也是通过「打开链接」这个扩展完成，默认已经开启标签搜索功能。

打开 HapiGo 主窗口，直接输入标签的名称或链接关键词，就可以搜索浏览器的标签了。如果标签名称包含中文，你还可以使用拼音搜索，更加方便快捷。此时，主列表会自动填充第一个结果，如果目标结果就是这一个，那么直接回车就可以转到了。如果结果较多，你可以输入多个关键词来让目标结果定位至第一个。

如果你输入关键词，并没有效果，就需要手动打开标签搜索。在主窗口中任意输入一个链接，就会匹配到「打开链接」扩展。在扩展右边区域的右上角有一个齿轮菜单，点开并勾选「标签直搜」即可。

<figure><img src="/files/HTa1qQ21Sl1Iqbm13c78" alt=""><figcaption></figcaption></figure>


# 计算与汇率换算

### 四则计算

* 打开主窗口，直接输入四则运算公式即可计算
* 回车可以复制结果
* 输入 =  可以将结果带入主搜索框

### 汇率换算

HapiGo 支持实时汇率换算，但此结果仅供参考，无法作为投资依据。

打开主窗口，输入金额（如：$100），HapiGo 会自动给出人民币结果。同样的，如果输入 ￥100，HapiGo 也会计算出美元结果。应用默认设定人民币和美元的互换。

如果你希望得到其他货币的兑换结果，可以在金额后面输入 >，此时可以搜索任意货币进行换算。

<figure><img src="/files/7cBleHDeZ0RT8tygZUwE" alt=""><figcaption></figcaption></figure>

#### 货币格式

在上面的介绍中，我们讲到输入货币以及搜索货币，所以有必要介绍一下 HapiGo 支持的货币格式。以下是 6 种我们支持的格式：

1. 货币符号+数字：￥100/100￥
2. 货币代码+数字：CNY100/100CNY
3. 国家中文名+数字（支持拼音）：中国100/100中国
4. 国家英文名+数字：China100/100China
5. 货币名称+数字（支持拼音）：人民币100/100人民币
6. 货币俗称+数字（支持拼音）：100元/元100/100块/块100/RMB100/100RMB

所以，上文当需要将人民币转成日元时：输入 cny100> ，然后可以用日元、日本、riben、japan、jpy 等方式来搜索目标货币。


# Bear 熊掌记搜索

HapiGo 提供 Bear 熊掌记内容搜索，但是需要设置一下 API 令牌。请参考下面文档设置：

### 获取 Mac 端熊掌记 API 令牌

打开熊掌记 → 菜单栏 → 帮助 → 高级 → API 令牌 → 复制令牌

<figure><img src="/files/nt8n8NlIDFzJOnhfzDdd" alt=""><figcaption></figcaption></figure>

### 在 HapiGo 中设置令牌

呼出 HapiGo 搜索框，输入 Bear，将上一步中获取的 API 令牌填入即可。

<figure><img src="/files/ZDIpNEFDpeSjaLRhJGhl" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
感谢 Mr. 麦贡献本文内容
{% endhint %}


# 开发者工具


# 系统命令与终端

### 系统命令

系统命令是一系列可以快速执行某些操作的命令。每一个命令都有一个关键词，在主输入框输入关键词就可以快速匹配这些命令，回车即可执行。

目前一共提供了 17 个命令：

1. 开关蓝牙
2. 开关 Wi-Fi
3. 推出所有磁盘：Tab 进入扩展后，可以对单个磁盘进行推出
4. 显示/隐藏隐藏文件
5. 隐藏/显示桌面文档
6. 切换深色模式
7. 重置触控板缩放：仅支持 macOS 11 之前的系统
8. 显示废纸篓
9. 清空废纸篓
10. 启动屏幕保护程序
11. 进入睡眠
12. 显示器睡眠
13. 关机
14. 重启电脑
15. 切换滚动方向：仅支持 macOS 11 之前的系统
16. 重置 Spotlight 索引
17. 索引屏幕

对于类似关机或重启等系统命令，一旦开始执行，无法停止。所以，为了防止误操作，可以开启二次确认。这样回车后，会先弹出确认对话框。这个设置可以在设置-系统命令下进行调整。

### 执行终端命令

在 HapiGo 中，可以直接向系统终端、iTerm2、Warp、Alacritty 等终端应用发送命令。如果你的电脑中安装有这些终端应用，那么直接搜索后按 tab 即可直接输入终端并回车执行。这里也会记录你之前使用过的终端命令，随着你输入命令，也会搜索历史。如果正好有你需要执行的，回车即可粘贴到输入框，再回车就可以执行了。

<figure><img src="/files/Be7eiE98tTA2TpURB7ik" alt=""><figcaption></figcaption></figure>

你也可以在应用搜索模式（混合搜索无此要求）下输入「>」即可直接进入终端扩展模式。默认情况下，回车后会在系统终端中执行。如果你日常使用 iTerm2、Warp 或 Alacritty，那么可以在设置-系统命令-底部「默认终端应用」处修改默认终端。

<figure><img src="/files/BwnR0HU1mwBFz1mWdU6U" alt=""><figcaption></figcaption></figure>


# Kill 进程

输入关键词「kill」就可以直接定位到「退出应用与进程」扩展。

此时，右侧预览区会显示当前前台打开的应用，底部动作栏定位在关闭全部应用。意思是，此时回车会关闭右侧显示的已打开的前台应用。如果你不需要这个操作，可以按 Tab 键进入扩展模式。

在扩展模式下，会分区显示应用与进程，你可以输入关键词搜索。然后，通过底部动作栏进行需要的操作。


# JSON 格式化

直接在主输入框粘贴 JSON 数据，就会自动匹配「JSON 格式化」扩展，并在右侧预览区显示格式化后的 JSON 数据。输入关键词 json，也可以定位到「JSON 格式化」扩展，只是此时没有预览。

如果你需要编辑这些数据，可以按 tab 进入扩展，这里可以进行更多操作。


# 查询 IP

输入关键词「IP」会自定定位「IP 查询」插件，此时会查找本机的 IP 信息。

粘贴 IP，会查询这个 IP 的信息。

底部动作支持：拷贝 IP、拷贝本地 IP、拷贝全部，可根据需要使用。


# Unix 时间戳转换

输入 time，会自动定位到扩展「Unix 时间戳」，并显示当前时间。

直接粘贴时间或时间戳时，也会优先匹配此扩展。

回车即可拷贝对应的结果。


# API & PopClip 插件

URL Scheme、AppleScript 及 PopClip 插件

![](/files/VI6fODZ9wWzLOqe5a1GA)

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

### URL Scheme

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

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

* **APP**：发送文本至 HapiGo 应用搜索
* **FILE**：发送文本至 HapiGo 文件搜索
* **CLIPBOARD**：发送文本至 HapiGo 剪贴板搜索
* **TRANSLATE**：发送文本至 HapiGo 翻译

{% hint style="info" %}
当 HapiGo 搜索模式为「混合搜索」时，APP 和 FILE 的效果相同，均为发送文本至主搜索。
{% endhint %}

**URL Scheme 示例**

```css
#在应用模式中搜索「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 语法词典。

![](/files/qkX1THpceo6fYnqwk2zw)

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

**AppleScript 示例**

```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>

![](/files/KQiWZIqASaLWvwxUDBF5)