配置通知

通知递送选项

您可以在以下位置的 GitHub AE 上接收活动的通知。

• GitHub AE Web 界面
• 使用经验证电子邮件地址的电子邮件客户端，也可以与 GitHub AE 上的通知收件箱同步

通知收件箱的优点

GitHub AE 上的通知收件箱包含专为您的 GitHub AE 通知流程设计的分类选项，包括：

• 一次对多种通知进行分类。
• 将已完成的通知标记为完成并从收件箱中删除它们。 要查看标记为完成的所有通知，请使用 is:done 查询。
• 保存通知以供以后查看。 保存的通知将在收件箱中标记并无限期保留。 要查看所有已保存的通知，请使用 is:saved 查询。
• 取消订阅并从收件箱中删除通知。
• 从通知收件箱预览 GitHub AE 上产生通知的议题、拉取请求或团队讨论。
• 使用 reasons 标签查看收件箱中收到通知的最新原因之一。
• 创建自定义过滤器，以便按需要关注不同的通知。
• 按仓库或日期对收件箱中的通知进行分组，以快速概览通知，减少上下文切换

对通知使用电子邮件客户端的优点

使用电子邮件客户端的一个好处是，可以无限期地保留所有通知，具体取决于电子邮件客户端的存储容量。 收件箱通知在 GitHub 上仅保留 5 个月，除非您将它们标记为 Saved（已保存）。 Saved（已保存）通知将无限期保留。 有关收件箱保留政策的更多信息，请参阅“关于通知”。

向电子邮件客户端发送通知还允许您根据电子邮件客户端的设置（可以包括自定义或颜色编码的标签）自定义收件箱。

电子邮件通知还允许您灵活地设置收到的通知类型，并允许您选择不同的电子邮件地址进行更新。 例如，您可以向经验证的个人电子邮件地址发送仓库的某些通知。 有关电子邮件自定义选项的更多信息，请参阅“自定义电子邮件通知”。

关于参与和查看通知

关注仓库，意味着订阅该仓库中的活动更新。 同样，关注特定团队的讨论，意味着订阅该团队页面上的所有对话更新。 更多信息请参阅“关于团队讨论”。

要查看您关注的仓库，请参阅关注页面。 更多信息请参阅“在 GitHub 上管理订阅和通知”。

配置通知

You can configure notifications for a repository on the repository page, or on your watching page.

更多信息请参阅下面的“配置单个仓库的关注设置”。

参与对话

每当您在对话中发表评论或有人 @提及您的用户名时，您都在参与对话。 默认情况下，当您参与对话时，会自动订阅该对话。 您可以通过单击议题或拉取请求上的 Unsubscribe（取消订阅）或通过通知收件箱中的 Unsubscribe（取消订阅）选项，手动取消订阅已参与的对话。

对于您关注或参与的对话，您可以选择是通过电子邮件还是 GitHub AE 上的收件箱接收通知。

例如：

• 如果您不希望将通知发送到您的电子邮件地址，请取消选中 email（电子邮件）以便参与和查看通知。
• 如果您希望在参与对话时通过电子邮件接收通知，则可以选中“Participating（参与）”下的 email（电子邮件）。

如果您未对 Web启用关注或参与通知，则您的通知收件箱不会收到任何更新。

自定义电子邮件通知

在启用电子邮件通知后，GitHub AE 将以多部分电子邮件向您发送通知，其中包含内容的 HTML 和明文副本。 电子邮件通知内容包含出现在 GitHub AE 上的原始内容中的任何 Markdown、@提及、表情符号、哈希链接等。 如果您只想查看电子邮件中的文本，可以配置电子邮件客户端只显示明文副本。

选择一个默认电子邮件地址，用于发送您参与或关注的对话的更新。 您还可以指定希望使用默认电子邮件地址接收 GitHub AE 上哪些活动的更新。 例如，选择您的默认电子邮件地址是否要接收以下更新：

• 对问题和拉取请求的评论。
• 拉取请求审查.
• 拉取请求推送。
• 您自己的更新，例如当您打开、评论或关闭议题或拉取请求时。

您还可以向不同电子邮件地址发送通知，具体取决于拥有仓库的组织。 您的组织可能要求验证特定域的电子邮件地址。 更多信息请参阅“选择接收组织的电子邮件通知的位置”。

您也可以将特定仓库的通知发送到电子邮件地址。 更多信息请参阅“关于推送到仓库的电子邮件通知。”

只有在通知设置中选择了接收电子邮件通知时，才会收到通知电子邮件。

过滤电子邮件通知

GitHub AE 发送的每封电子邮件通知都包含标头信息。 每封电子邮件的标头信息都是一致的，因此可用于电子邮件客户端中过滤或转发所有 GitHub AE 通知，或特定类型的 GitHub AE 通知。

如果您认为收到的通知不属于您，请检查 X-GitHub-recepient 和 X-GitHub-recipient-Address 标头。 这些标头显示预期的收件人。 根据您的电子邮件设置，您可能会收到预期发给其他用户的通知。

来自 GitHub AE 的电子邮件通知包含以下标头信息：

标头	信息
From 地址	此地址始终是 '网站管理员配置的无需回复电子邮件地址'。
To 字段	此字段直接连接到线程。
Cc 地址	如果您订阅了对话，GitHub AE 将会 Cc 给您。 第二个 Cc 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 基于站点管理员配置的无需回复电子邮件地址。 可能的通知原因包括： assign：您被分配到议题或拉取请求。 author：您创建了议题或拉取请求。 ci_activity：当 GitHub Actions 工作流程运行被请求或完成时。 comment：您评论了议题或拉取请求。 manual：您手动订阅的议题或拉取请求有更新。 mention：您提及了议题或拉取请求。 push：有人提交了您订阅的拉取请求。 review_requested：您或您所在的团队已请求审查拉取请求。 state_change：您订阅的议题或拉取请求已关闭或打开。 subscribed：您查看的仓库有更新。 team_mention：您所属的团队在议题或拉取请求中被提及。 your_activity：您打开、评论或关闭了议题或拉取请求。
mailing list 字段	此字段识别仓库名称及其所有者。 此地址的格式始终是 <仓库名称>.<仓库所有者>.[hostname]。

选择通知设置

1. 在任何页面的右上角，单击 。
2. 在左侧边栏中的仓库列表下，使用“Manage notifications（管理通知）”下拉按钮单击 Notification settings（通知设置）。
3. 在通知设置页面上，选择在以下情况下如何接收通知：
   • 在您关注的仓库或团队讨论或参与的对话中发生了更新。 更多信息请参阅“关于参与和关注通知”。
   • 您获得了新仓库的访问权限或加入了新团队。 更多信息请参阅“自动关注”。

自动关注

默认情况下，每当您获得新仓库的访问权限时，您将会自动开始关注该仓库。 每当您加入新团队时，您都会自动订阅更新，并在该团队被 @提及时收到通知。 如果不想自动订阅，您可以取消选择自动关注选项。

如果禁用了“Automatically watch repositories（自动关注仓库）”，您将不会自动关注自己拥有的仓库。 您必须导航到仓库页面，然后选择关注选项。

配置单个仓库的关注设置

您可以选择关注还是取消关注单个仓库。 您也可以选择接收新版本的通知，或者完全忽略单个仓库。

1. 在 GitHub AE 上，导航到仓库的主页面。

2. 在右上角，单击“Watch（关注）”下拉菜单选择关注选项。

   

选择接收组织的电子邮件通知的位置

如果您属于某个组织，您可以选择要接收组织活动通知的电子邮件帐户。 例如，如果您属于某个工作组织，您可能希望通知发送到您的工作电子邮件地址，而不是您的个人地址。

只有在通知设置中选择了接收电子邮件通知时，才会收到通知电子邮件。

1. 在任何页面的右上角，单击 。
2. 在左侧边栏中的仓库列表下，使用“Manage notifications（管理通知）”下拉按钮单击 Notification settings（通知设置）。
3. 在“Default notification email（默认通知电子邮件）”下，选择要接收通知的电子邮件地址。
   
4. 单击 Save（保存）。

自定义每个组织的电子邮件路由

如果您是多个组织的成员，您可以配置每个组织发送通知任何您已添加到 GitHub AE 帐户的电子邮件地址。

1. 在任何页面的右上角，单击 。
2. 在左侧边栏中的仓库列表下，使用“Manage notifications（管理通知）”下拉按钮单击 Notification settings（通知设置）。
3. 在“Custom routing（自定义路由）”下，在列表中找到您组织的名称。
   
4. 在要更改的电子邮件地址旁边单击 Edit（编辑）。
5. 选择一个经验证电子邮件地址，然后单击 Save（保存）。