跳至主要内容

管理收件箱中的通知

使用收件箱快速分类并同步电子邮件和手机中的通知。

关于您的收件箱

要在 GitHub 和 GitHub Mobile 上使用通知收件箱,您必须在通知设置中启用 Web 和移动通知。有关更多信息,请参阅“配置通知”。

要访问您的通知收件箱,请在任何页面右上角单击 .

您的收件箱显示您尚未取消订阅或标记为已完成的所有通知。您可以使用筛选器、查看所有通知或仅查看未读通知以及对通知进行分组以快速概览的方式自定义收件箱以最适合您的工作流。

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

分类选项

您有几种选项可用于对收件箱中的通知进行分类。

分类选项说明
保存保存您的通知以供以后查看。要保存通知,请在通知右侧单击 .

保存的通知将无限期保留,可以通过单击侧边栏中的已保存或使用is:saved查询来查看。如果您的已保存通知超过 5 个月且变得未保存,则该通知将在一天内从您的收件箱中消失。
已完成将通知标记为已完成,并从您的收件箱中删除该通知。您可以通过单击侧边栏中的已完成或使用is:done查询来查看所有已完成的通知。标记为已完成的通知将保存 5 个月。
取消订阅自动从您的收件箱中删除通知,并在您被 @ 提及、您所在的团队被 @ 提及或您被请求审阅之前取消您对对话的订阅。
已读将通知标记为已读。要在收件箱中仅查看已读通知,请使用is:read查询。此查询不包括标记为已完成的通知。
未读将通知标记为未读。若要仅在收件箱中查看未读通知,请使用 is:unread 查询。

若要查看可用的键盘快捷键,请参见“键盘快捷键”。

在选择分类选项之前,你可以先预览通知详情并进行调查。有关更多信息,请参见“对单个通知进行分类”。

同时对多个通知进行分类

若要一次对多个通知进行分类,请选择相关通知并使用 下拉菜单选择分类选项。

Screenshot of the "Notifications" page. A drop-down menu is highlighted with an orange outline.

默认通知筛选器

默认情况下,你的收件箱具有以下筛选器:当你被分配、参与讨论、被要求审阅拉取请求,或你的用户名被直接 @ 提及或你所在的团队被 @ 提及时。

使用自定义筛选器自定义你的收件箱

你可以最多添加 15 个你自己的自定义筛选器。

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

    Screenshot of the right corner of the header of GitHub. An inbox icon has a blue dot, indicating that there are unread notifications.

  2. 若要打开筛选器设置,请在左侧边栏中单击“筛选器”旁边的 .

    提示:你可以通过在收件箱视图中创建查询并单击保存来快速预览筛选器的收件箱结果,这将打开自定义筛选器设置。

  3. 为你的筛选器添加一个名称和一个筛选器查询。例如,若要仅查看特定存储库的通知,你可以使用查询 repo:octocat/open-source-project-name reason:participating 创建筛选器。你还可以使用原生表情符号键盘添加表情符号。有关受支持的搜索查询的列表,请参见“自定义筛选器的受支持查询”。

    Screenshot showing notification filters. Two input fields, with an example name and filter query filled in, are highlighted with an orange outline.

  4. 单击创建

自定义筛选器限制

自定义筛选器目前不支持

  • 收件箱中的全文搜索,包括搜索拉取请求或问题标题。
  • 区分 is:issueis:pris:pull-request 查询筛选器。这些查询将返回问题和拉取请求。
  • 创建超过 15 个自定义筛选器。
  • 更改默认筛选器或其顺序。
  • 使用 NOT-QUALIFIER 搜索 排除

自定义筛选器的支持查询

以下是你可使用的筛选器类型

  • 使用 repo: 按存储库筛选
  • 使用 is: 按讨论类型筛选
  • 使用 reason: 按通知原因筛选
  • 使用 author: 按通知作者筛选
  • 使用 org: 按组织筛选

支持的 repo: 查询

要添加 repo: 筛选器,你必须在查询中包含存储库的所有者:repo:owner/repository。所有者是触发通知的 GitHub 资产的所有者,可以是组织或用户。例如,repo:octo-org/octo-repo 将显示在 octo-org 组织内的 octo-repo 存储库中触发的通知。

支持的 is: 查询

要筛选 GitHub 上特定活动的通知,你可以使用 is 查询。例如,要仅查看存储库邀请更新,请使用 is:repository-invitation,要仅查看 Dependabot 提醒,请使用 is:repository-vulnerability-alert

  • 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:discussion

有关减少 Dependabot 提醒通知噪音的信息,请参阅“配置 Dependabot 提醒通知”。

你还可以使用 is: 查询来描述通知的分拣方式。

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

支持的 reason: 查询

要按收到更新的原因筛选通知,你可以使用 reason: 查询。例如,要在你(或你所在的团队)被请求审阅拉取请求时查看通知,请使用 reason:review-requested。有关更多信息,请参阅“关于通知”。

查询说明
reason:assign当你被分配的问题或拉取请求有更新时。
reason:author当你打开拉取请求或问题,并且有更新或新评论时。
原因:评论当您对问题或请求进行评论时。
原因:参与当您对问题或请求进行评论或被 @ 提及时。
原因:邀请当您被邀请加入团队、组织或存储库时。
原因:手动当您点击您尚未订阅的问题或请求上的订阅时。
原因:提及您被直接 @ 提及。
原因:请求审查您或您所在的团队被要求审查请求。
原因:安全警报当针对存储库发出安全警报时。
原因:状态更改当请求或问题状态发生更改时。例如,问题已关闭或请求已合并。
原因:团队提及当您所在的团队被 @ 提及时。
原因:CI 活动当存储库有 CI 更新时,例如新的工作流运行状态。

支持的 author: 查询

要按用户筛选通知,您可以使用 author: 查询。作者是您收到通知的主题(问题、请求、gist、讨论等)的原始作者。例如,要查看 Octocat 用户创建的主题的通知,请使用 author:octocat

支持的 org: 查询

要按组织筛选通知,您可以使用 org 查询。您需要在查询中指定的组织是在 GitHub 上收到通知的存储库的组织。如果您属于多个组织,并且想要查看特定组织的通知,此查询非常有用。

例如,要查看来自 octo-org 组织的通知,请使用 org:octo-org

Dependabot 自定义筛选器

如果您使用 Dependabot 来保持依赖项的最新状态,您可以使用并保存这些自定义筛选器

  • is:repository_vulnerability_alert 以显示 Dependabot 警报的通知。
  • reason:security_alert 以显示 Dependabot 警报和安全更新请求的通知。
  • author:app/dependabot 以显示由 Dependabot 生成的通知。这包括 Dependabot 警报、安全更新请求和版本更新请求。

有关 Dependabot 的更多信息,请参阅“关于 Dependabot 警报”。