Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
GitHub AE is currently under limited release.

从收件箱管理通知

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

关于收件箱

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

表示任何未读消息的通知

收件箱将显示所有尚未取消订阅或标记为“完成”的通知。 可按最适合工作流的方式自定义收件箱,方法包括使用筛选器、查看所有通知或只查看未读通知以及对通知进行分组便于快速了解。

收件箱视图

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

未读收件箱视图

分类选项

有多个选项可对收件箱中的通知进行分类。

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

已保存的通知将无限期保存,可单击边栏中的“已保存”或通过 is:saved 查询进行查看。 如果您保存的通知超过5个月并且变成未保存,通知将在一天内从收件箱消失。
完成将通知标记为已完成,并从收件箱中删除通知。 可单击边栏中的“完成”或通过 is:done 查询查看所有已完成的通知。 标记为“完成”的通知将保存 5 个月。
取消订阅自动从收件箱中删除通知并让你通过对话取消订阅,仅当 @mentioned你、@mentioned你所属团队或者请求你审查时才会收到通知。
读取将通知标记为已读。 要在收件箱中只查看已读通知,可使用 is:read 查询。 此查询不包括标记为“完成”的通知。
Unread将通知标记为未读。 要在收件箱中只查看未读通知,可使用 is:unread 查询。

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

在选择分类选项之前,您可以先预览通知的详细信息并进行调查。 有关详细信息,请参阅“对单个通知进行分类”。

同时对多种通知分类

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

带有分类选项和选定通知的下拉菜单

默认通知过滤器

默认情况下,收件箱中有针对分配给你的任务、参与的帖子、请求审查拉取请求的筛选器,或者针对直接 @mentioned你的用户名或 @mentioned你所属团队的筛选器。

默认自定义过滤器

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

您可以添加最多 15 个自定义过滤器。

  1. 在任何页面的右上角,单击 表示任何未读消息的通知

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

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

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

    自定义过滤器示例

  4. 单击“创建”。

自定义过滤器限制

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

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

支持的自定义过滤器查询

以下是您可以使用的过滤器类型:

  • 使用 repo: 按存储库筛选
  • 使用 is: 按讨论类型筛选
  • 使用 reason: 按组织筛选

支持的 repo: 查询

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

支持的 is: 查询

若要在 你的企业 上筛选特定活动的通知,可使用 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:team-discussion

有关减少 Dependabot alerts 通知干扰的信息,请参阅“配置 Dependabot alerts 的通知”。

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

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

支持的 reason: 查询

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

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

Dependabot 自定义过滤器

如果使用 Dependabot 来告知不安全的依赖项,则可以使用并保存这些自定义筛选器来显示 Dependabot alerts 的通知:

  • is:repository_vulnerability_alert
  • reason:security_alert

有关 Dependabot 的详细信息,请参阅“关于 Dependabot alerts”。