使用收件箱快速分类并在电子邮件与手机之间同步您的通知。

关于收件箱

要在 GitHub 和 GitHub for mobile 上使用通知收件箱，必须在通知设置中启用 Web 和移动通知。 有关更多信息，请参见 "配置通知."

要访问您的通知收件箱，请在任意页面的右上角，单击 。

收件箱显示您尚未取消订阅或标记为完成的所有通知。您可以使用过滤器自定义收件箱，使之最适合您的工作流程，查看所有通知或只查看未读通知，对通知分组通知以获取快速概览。

默认情况下，您的收件箱将显示已读和未读通知。 要仅查看未读的通知，请单击 Unread 或使用 is:unread 查询.

分类选项

您可以使用多个选项对收件箱中的通知进行分类。

分类选项	描述
保存	保存通知供以后查看。 要保存通知，在通知右侧单击 。  保存的通知无限期保存，可单击侧边栏中的 Saved（已保存） 或通过 is:saved 查询查看。 如果您保存的通知超过5个月并且变成未保存，通知将在一天内从收件箱消失。
已完成	将通知标记为已完成，并从收件箱中删除通知。 您可以单击侧边栏中的 Done（完成）或通过 is:done 查询来看到所有已完成的通知。 标记为 Done（完成）的通知将保存 5 个月。
取消订阅	自动从收件箱中删除通知并退订对话，仅当您被@提及、您所在的团队被@提及或者请求您进行审查时才会收到通知。
读取	将通知标记为已读。 要在收件箱中只查看已读通知，可使用 is:read 查询。 此查询不包含标记为 Done（完成）的通知。
未读	将通知标记为未读。 要在收件箱中只查看未读通知，可使用 is:unread 查询。

要查看可用的键盘快捷键，请参阅“键盘快捷键”。 在选择分类选项之前，您可以先预览通知的详细信息并进行调查。 有关更多信息，请参见 "对单个通知进行分类."

同时对多种通知分类

要一次对多种通知分类，请选择相关通知并使用 下拉列表以选择分类选项。

默认通知过滤器

默认情况下，您的收件箱中有过滤器，用于指定您何时被分配，参与线程，请求审阅拉取请求，或者直接提及您的用户名或提及您所隶属的团队。

使用自定义过滤器自定义收件箱

You can add up to 15 of your own custom filters.

1. 在任何页面的右上角，单击 。

1. 若要打开过滤器设置，在左侧边栏的“Filters（过滤器）”旁边，单击 。

提示：您可以通过在收件箱视图中创建查询并单击Save（保存）快速预览过滤器收件箱结果， 这将打开自定义过滤器设置。

1. 为过滤器和过滤器查询添加名称。 例如，如果只想看特定仓库的通知，可以使用查询 repo:octocat/open-source-project-name reason:participating 创建一个过滤器。 您也可以用原生表情键盘添加表情符号。 有关受支持的搜索查询的列表，请参阅“支持的自定义过滤器查询”。

1. 单击 Create（创建）。

自定义过滤器限制

自定义过滤器当前不支持：

• 收件箱中的全文搜索，包括搜索拉取请求或议题标题。
• 区分 is:issue、is:pr 及 is:pull-request 查询过滤器。 这些查询将返回议题和拉取请求。
• 创建超过 15 个自定义过滤器。
• 更改默认过滤器或其顺序。

支持的自定义过滤器查询

您可以使用三种类型的过滤器：

• 使用 repo: 按仓库过滤
• 使用 is: 按讨论类型过滤
• 使用 reason: 按通知原因过滤

要添加 repo: 过滤器，必须在查询中包括存储库的所有者。例如，repo:atom/atom 表示Atom组织拥有的Atom存储库。

支持的 reason: 查询

要根据收到更新的原因过滤通知，可以使用 reason: 查询。例如，要查看当您（或您所在的团队）被要求审查拉动请求时的通知，请使用 reason:review-requested 。更多信息请参阅“关于通知”。

查询	描述
reason:assign	分配给您的议题或拉取请求有更新时。
reason:author	当您打开拉取请求或议题并且有更新或新评论时。
reason:comment	当您评论了议题、拉取请求或团队讨论时。
reason:participating	当您评论了议题、拉取请求或团队讨论或者被@提及时。
reason:invitation	当您被邀请加入团队、组织或仓库时。
reason:manual	当您在尚未订阅的议题或拉取请求上单击 Subscribe（订阅）时。
reason:mention	您被直接@提及。
reason:review-requested	有人请求您或您所在的团队审查拉取请求。
reason:security-alert	为仓库发出安全警报时。
reason:state-change	当拉取请求或议题的状态改变时。 例如，议题已关闭或拉取请求合并时。
reason:team-mention	您所在的团队被@提及时。
reason:ci-activity	当仓库有 CI 更新时，例如新的工作流程运行状态。

支持的 is: 查询

要在 GitHub 上过滤特定活动的通知，您可以使用 is 查询。例如，要仅查看存储库邀请更新，请使用 is:repository-invitation.

• is:check-suite
• is:commit
• is:gist
• is:issue-or-pull-request
• is:release
• is:repository-invitation
• is:repository-vulnerability-alert
• is:repository-advisory
• is:team-discussion

您还可以使用 is： 查询来描述如何对通知进行分类。

• is:saved
• is:done
• is:unread
• is:read