# 浏览器扩展

Pocket Alert 扩展把你的通知收件箱放进浏览器工具栏：未读角标、桌面通知，还有一个撰写框，让你不离开当前标签页就能发送推送通知。

[从 Chrome 应用商店安装](https://chromewebstore.google.com/detail/pocket-alert/hnknmapadalodjkmikfhjnmbbhpbhbdk) — 支持 Chrome 和 Edge。

## 功能说明

**收件箱。** 以卡片形式显示最近的消息，未读消息会有标记。点击卡片可展开正文并标为已读。使用顶部的标签按应用筛选，滚动时加载更早的消息。

**发送。** 填写标题、消息内容、目标设备（或广播给所有设备），并选择一个应用来标注消息来源。

**未读角标与桌面提醒。** 后台进程会按你设定的间隔轮询，并为每条新消息弹出原生桌面通知。

**全部标为已读。** 仅在确实有未读消息时显示。

**主题。** 可选浅色、深色，或跟随系统，使用与网页版相同的设计令牌。

**保存草稿。** 写到一半的消息在关闭弹窗后会被保留。

## 设置

1. 安装扩展。
2. 在 [API 密钥](https://pocketalert.app/account/apikeys) 页面创建一个 API 密钥。
3. 打开扩展选项，粘贴密钥，然后点击 **测试连接**。
4. 顺便设置轮询间隔和每页条数。

密钥保存在浏览器存储中，仅用于与 `api.pocketalert.app` 通信，不会发送到其他任何地方。

> **Tip: 使用单独的密钥**
>
> 为扩展单独创建一个 API 密钥，不要和服务器使用的密钥共用。如果你把笔记本借给别人，或在多台机器之间同步配置文件，只需撤销这一个密钥即可。

## 权限及其用途

| 权限 | 用途 |
|------|------|
| `storage` | 在本地保存你的 API 密钥、设置和未发送的草稿 |
| `alarms` | 安排后台轮询以获取新消息 |
| `notifications` | 显示桌面通知 |
| `host_permissions`（针对 `api.pocketalert.app`） | 仅用于调用 Pocket Alert API，别无其他用途 |

扩展不具备广泛的主机访问权限，无法读取你浏览的页面内容。

## 相关链接

- [CLI](https://info.pocketalert.app/cli.md) — 在终端中执行同样的操作
- [创建消息](https://info.pocketalert.app/api/messages/create.md) — 扩展所调用的 API
