👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

从收件箱管理通知

Use your inbox to quickly triage and sync your notifications across email and mobile.

本文内容

关于收件箱

要在 GitHub 和 GitHub for mobile 上使用通知收件箱,必须在通知设置中启用 Web 和移动通知。 For more information, see "Configuring notifications."

To access your notifications inbox, in the upper-right corner of any page, click .

表示任何未读消息的通知

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

inbox view

By default, your inbox will show read and unread notifications. To only see unread notifications, click Unread or use the is:unread query.

unread inbox view

分类选项

You have several options for triaging notifications from your inbox.

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

保存的通知无限期保存,可单击侧边栏中的 Saved(已保存) 或通过 is:saved 查询查看。 如果您保存的通知超过5个月并且变成未保存,通知将在一天内从收件箱消失。

已完成将通知标记为已完成,并从收件箱中删除通知。 您可以单击侧边栏中的 Done(完成)或通过 is:done 查询来看到所有已完成的通知。 标记为 Done(完成)的通知将保存 5 个月。
取消订阅自动从收件箱中删除通知并退订对话,仅当您被@提及、您所在的团队被@提及或者请求您进行审查时才会收到通知。
读取将通知标记为已读。 要在收件箱中只查看已读通知,可使用 is:read 查询。 此查询不包含标记为 Done(完成)的通知。
未读将通知标记为未读。 要在收件箱中只查看未读通知,可使用 is:unread 查询。

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

Before choosing a triage option, you can preview your notification's details first and investigate. For more information, see "Triaging a single notification."

同时对多种通知分类

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

Drop-down menu with triage options and selected notifications

默认通知过滤器

By default, your inbox has filters for when you are assigned, participating in a thread, requested to review a pull request, or when your username is @mentioned directly or a team you're a member of is @mentioned.

Default custom filters

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

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

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

    表示任何未读消息的通知

  2. 若要打开过滤器设置,在左侧边栏的“Filters(过滤器)”旁边,单击

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

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

    自定义过滤器示例

  4. 单击 Create(创建)

自定义过滤器限制

Custom filters do not currently support:

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

支持的自定义过滤器查询

There are three types of filters that you can use:

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

To add a repo: filter, you must include the owner of the repository in the query. For example, repo:atom/atom represents the Atom repository owned by the Atom organization.

支持的 reason: 查询

To filter notifications by why you've received an update, you can use the reason: query. For example, to see notifications when you (or a team you're on) is requested to review a pull request, use reason:review-requested. 更多信息请参阅“关于通知”。

查询Description
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: 查询

To filter notifications for specific activity on GitHub, you can use the is query. For example, to only see repository invitation updates, use 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

You can also use the is: query to describe how the notification was triaged.

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

问问别人

找不到要找的内容?

联系我们