集成 GitHub

连接 Notion 和 GitHub，保持工作流同步 🧮

目录

• 连接 GitHub
• 将 GitHub PRs 链接到 Notion
• 自动化任务状态更新

---

GitHub 是开发团队构建、发布和维护软件的核心工具。
通过 Notion 数据库的 筛选器、视图、关系 等功能，将 GitHub 无缝接入您的工作流。

连接 GitHub

连接前需满足以下条件：

• 您是 Notion 工作区所有者
• 您是 GitHub 组织管理员

操作步骤：

1. 在侧边栏顶部，点击 设置与成员。
2. 选择 我的连接，找到 GitHub (工作区)。
3. 点击 连接，完成身份验证。

将 GitHub PR 链接到 Notion

要将 GitHub PR 关联到 Notion，需在数据库中添加 GitHub Pull Requests 属性。
该属性依赖一个带前缀的 唯一 ID 属性。

了解唯一 ID 的更多信息

添加 GitHub Pull Requests 属性：

1. 在数据库右上角，点击 + 添加新属性。
2. 选择 GitHub Pull Requests。
3. 若尚未创建唯一 ID 属性，系统将提示您创建。

链接 PR 的两种方式：

使用 GitHub URL

1. 打开目标任务页面。
2. 点击 GitHub Pull Requests 属性中的空白区域。
3. 粘贴 GitHub PR 的 URL，点击 + Add Page。

使用 Notion 唯一 ID

1. 复制目标 Notion 任务的 唯一 ID。
2. 将该 ID 粘贴到 GitHub PR 标题的任意位置。
3. PR 将自动出现在 GitHub Pull Requests 属性中。

自动化任务状态更新

利用 GitHub Pull Requests 属性，可自动同步任务状态。

设置步骤：

1. 点击 GitHub Pull Requests 属性标题，选择 Edit property。
2. 找到 Auto-update 部分。
3. 从下拉菜单中选择要同步的 状态属性。
4. 为以下事件配置对应状态：
   • PR 打开
   • 请求审核
   • 通过审核
   • 合并

完成设置后，GitHub 上的进展将自动更新 Notion 中任务的状态。