# GitHub Oneboxes 上的实时 Pull Request 状态 ✨

**URL:** https://meta.discourse.org/t/live-pull-request-status-on-github-oneboxes/390900
**Category:** Announcements
**Created:** [2025年十二月11日 09:46 UTC](https://meta.discourse.org/t/live-pull-request-status-on-github-oneboxes/390900 "2025-12-11T09:46:22Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![zogstrip](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/zogstrip/32/512781_2.png) [@zogstrip](https://meta.discourse.org/u/zogstrip)
#### Post date: [2025年十二月11日 09:46 UTC](https://meta.discourse.org/t/live-pull-request-status-on-github-oneboxes/390900/1 "2025-12-11T09:46:22Z")

</div>

我们很高兴地宣布 **[discourse-github](https://github.com/discourse/discourse/tree/main/plugins/discourse-github)** 插件的新功能：GitHub PR onebox 上的 **实时拉取请求状态指示器** ！🎉

当您在帖子或聊天消息中粘贴 GitHub 拉取请求 (PR) URL 时，Discourse 现在会显示一个视觉状态图标，显示 PR 的当前状态——并通过 Webhook 自动保持最新状态。🔄

## 它的作用

GitHub PR onebox 现在会显示一个状态图标，反映拉取请求的当前状态：

| 状态 | 颜色 | 描述 |
| --- | --- | --- |
| 📝 **草稿** | 灰色 | PR 被标记为草稿 |
| 🔓 **开放** | 灰色 | PR 已打开并等待审查 |
| ✅ **已批准** | 绿色 | PR 已被审阅者批准 |
| 🔶 **请求更改** | 橙色 | 审阅者已请求更改 |
| 🟣 **已合并** | 紫色 | PR 已被合并 |
| 🔴 **已关闭** | 红色 | PR 在未合并的情况下被关闭 |

这些图标使用了 GitHub 的原生图标和配色方案，因此经常使用 GitHub 的人会感到很熟悉。👀

### 示例

以下是不同状态的实际效果：

**草稿 PR：**

![DRAFT PR](https://global.discourse-cdn.com/meta/original/4X/d/0/c/d0c52ab727b81841f3a2656627abb413f6cc4a89.png)

**开放 PR：**

![OPEN PR](https://global.discourse-cdn.com/meta/original/4X/a/9/7/a9771fc13c6ebfd52dcf8d2e58c6d41c61976c22.png)

**已批准 PR：**

![APPROVED PR](https://global.discourse-cdn.com/meta/original/4X/4/5/6/4563d6aeb0975e097b738ae99396353b536b0d4d.png)

**请求更改：**

![CHANGE REQUESTED](https://global.discourse-cdn.com/meta/original/4X/4/5/6/45605dfd6e16c1cd4ed378384bd9675056f970e9.png)

**已合并 PR：**

![MERGED PR](https://global.discourse-cdn.com/meta/original/4X/3/2/2/322fa8c1e6ebf507cd9075087a1f595c7c1406d3.png)

**已关闭 PR：**

![CLOSED PR](https://global.discourse-cdn.com/meta/original/4X/6/2/a/62a8743a1891e3f7602ccc7508c37bbb9bd4a460.png)

## 它的工作范围 📍

实时状态显示在：

- **论坛帖子** — 任何包含 GitHub PR onebox 的帖子
- **聊天消息** — 如果您启用了聊天插件，聊天中的 PR onebox 也会显示实时状态 💬

**聊天示例：**

![CleanShot 2025-12-10 at 13.50.37](https://global.discourse-cdn.com/meta/original/4X/1/7/f/17fd1c25607263541daf48fe377d93aadd17dcf5.png)

注意：内联 onebox（链接以非完整预览形式出现在文本中时）不显示状态图标。

## 通过 Webhook 实现实时更新 ⚡

此功能最强大的方面是，当 GitHub 上发生更改时，PR 状态会 **自动更新** 。当 PR 被打开、关闭、合并、转换为草稿或从草稿转换，或收到审阅时，Discourse 会自动更新包含该 PR onebox 的任何帖子或聊天消息。

## 智能审阅状态 🔍

此功能不仅显示基本的打开/关闭状态——它还会获取审阅信息，以确定 PR 是否已获批准或请求了更改。它通过以下方式智能处理多个审阅者：

- 获取每个审阅者的最新审阅
- 如果任何审阅者请求了更改，则显示“请求更改”
- 仅当存在审阅且没有请求更改时，才显示“已批准”

## 从 GitHub 状态主题组件迁移 ⚠

此功能 **取代** 了 [GitHub 状态指示器](https://meta.discourse.org/t/github-status-indicators/130471) 主题组件。两者 **不兼容** ，不应一起使用。

如果您当前正在使用该主题组件，您应该：

1. **禁用并删除** `github-status-theme` 主题组件
2. 通过站点设置 **启用** 此新的内置功能

新的实现比主题组件具有几个优势：

- 🔒 可与私有仓库配合使用（通过 API 身份验证）
- ✅ 包含来自审阅的批准/请求更改状态
- ⚡ 通过 Webhook 实时更新
- 💬 在聊天消息中可用
- 🛠 无需主题组件维护

## 开始使用 🚀

有关设置说明、配置选项和技术详细信息，请参阅 [discourse-github 插件文档](https://meta.discourse.org/t/discourse-github/99895)。

## 反馈 💬

我们很想听听您对这项功能的反馈！如果您遇到任何问题或有改进建议，请在下面的回复中告知我们。🙏

---

_[View the full topic](https://meta.discourse.org/t/live-pull-request-status-on-github-oneboxes/390900)._