管理收件箱中的通知

关于您的收件箱

要在 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 个自定义筛选器。

在任何页面的右上角，点击.
要打开筛选器设置，在左侧边栏中，“筛选器”旁边，点击.

提示

您可以在收件箱视图中创建查询并点击**保存**来快速预览筛选器的收件箱结果，这将打开自定义筛选器设置。
添加筛选器的名称和筛选器查询。例如，要仅查看特定存储库的通知，您可以使用查询repo:octocat/open-source-project-name reason:participating创建筛选器。您还可以使用原生表情符号键盘添加表情符号。有关支持的搜索查询列表，请参阅“自定义筛选器的支持查询”。
点击**创建**。

自定义筛选器限制

自定义筛选器目前不支持

收件箱中的全文搜索，包括搜索拉取请求或问题标题
区分is:issue、is:pr和is: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`	当您打开拉取请求或问题并且有更新或新评论时。
`reason:comment`	当您在问题或拉取请求中发表评论时。
`reason:participating`	当您在问题或拉取请求中发表评论或您被@提及时。
`reason:invitation`	当您被邀请加入团队、组织或存储库时。
`reason:manual`	当您点击订阅某个您尚未订阅的问题或拉取请求时。
`reason:mention`	您被直接@提及。
`reason:review-requested`	您或您所属的团队被请求审查拉取请求。
`reason:security-alert`	当为存储库发布安全警报时。
`reason:state-change`	当拉取请求或问题的状态发生更改时。例如，问题已关闭或拉取请求已合并。
`reason:team-mention`	当您所属的团队被@提及时。
`reason:ci-activity`	当存储库有 CI 更新时，例如新的工作流运行状态。

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

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

本文内容