连接 GitLab 到 Notion
GitLab 帮助团队管理代码、协作进行软件开发并跟踪发布。你可以将 GitLab 项目、问题、合并请求、流水线和发布同步到 Notion，让开发工作与你的团队计划和文档保持一致。
我们正在用由 Notion Workers 提供支持的定制同步功能来取代现有的托管 GitLab 同步。你可以自定义同步哪些数据以及它们在 Notion 中的组织方式。你现有的同步数据将保留在 Notion 中；请按照本指南设置替换方案。了解有关 Notion Workers → 的更多信息。
现有的 GitLab 同步将于 2026 年 10 月 30 日 停止工作。在此之前它们将照常工作，但不会自动迁移。我们建议在此日期之前设置你的替换同步。
Workers 在 Notion 的基础设施上运行你的同步。要设置替换，请在与 Notion AI 的聊天中 @-提及你现有的同步数据库，并包含 GitLab 同步技能。
准备好以下内容：
你在 Notion 中现有的 GitLab 同步数据库。确保 Notion AI 能够访问它。
要包含的 GitLab 项目完整列表。你可以提供项目 URL、数字 ID 或路径，例如 my-team/my-project。了解如何 在 GitLab 中查看项目 →
一个具有 read_api 权限并可访问每个选定项目的 GitLab 个人或项目访问令牌。
访问 Workers 以及 Notion AI 在你的工作空间中创建和部署 Worker 所需的工具。
此技能页面将复制到你的 Notion 帐号中：GitLab Guide: Worker Sync。此技能适用于 GitLab.com。如果你使用自托管的 GitLab 实例，请在设置前告知 Notion AI。该指南的 API 地址和凭据配置需要针对你的实例进行调整和验证。
注意：本指南会创建替换数据库。你现有的数据库在你检查它们时仍然可用。其页面链接、视图、关系和仅限 Notion 的信息不会自动传输。
在包含现有同步数据库的工作空间中打开与 Notion AI 的聊天。
复制下方的（文字）指令。通过输入 @ 并从提及菜单中选择实际的数据库来替换 @Existing GitLab sync database。如果问题和合并请求位于不同的同步数据库中，请同时提及它们。
使用 GitLab Guide: Worker Sync 将我当前的 GitLab 同步 @Existing GitLab sync database 替换为 Notion Worker。
检查现有数据库，并与我确认完整的 GitLab 项目列表。按照该技能，在私人“GitLab Sync”页面下创建每小时的同步、五个相关数据库、视图和管理面板。如果已存在替换的 Worker，请检查并在适当的情况下复用它。
保持我现有的数据库完整。识别需要单独处理的自定义属性、仅 Notion 的值、视图、关联和链接。通过安全的资格输入请求我的 GitLab 令牌，而不是在聊天中。
预览每个选定的项目和数据类型，完成首次同步，并检查记录和项目关联。在更改旧同步之前，向我展示替换后的数据库、任何差异以及切换步骤。
在（文字）指令中选择一个实际的数据库 @提及。仅输入数据库名称无法让 Notion AI 获取检查链接。
确认完整的项目列表，包括当前 Notion 视图过滤器隐藏的项目。仅限于一个项目的令牌不足以满足也需要访问其他项目的同步。
按照 Notion AI 的说明，通过安全的资格输入提供你的 GitLab 令牌。它需要 read_api 权限以及对所选项目的访问权限。
请勿将令牌粘贴到聊天、Notion 页面或数据库属性中。Worker 使用代理资格，因此其代码无需读取原始令牌。
此设置使用新的 Worker 资格。你现有的 GitLab 连接不会自动提供它。
如果 Notion AI 无法访问该技能或 Worker 工具，请先解决访问问题。该使用手册中还包含了团队中能使用 Notion CLI 的成员的设置说明。
该技能会创建一个私人 GitLab Sync 页面，其中包含五个同步数据库和一个管理面板：
数据库 | 包含内容 |
|---|---|
GitLab 项目 | 项目名称、路径、描述、归档状态、可见性、默认分支、链接和活动日期。 |
GitLab 问题 | 涵盖各种状态的问题，包含负责人、标签、里程碑、严重程度、截止日期和项目关联。 |
GitLab 合并请求 | 涵盖各种状态的合并请求，包含草稿状态、作者、负责人、分支、合并状态和项目关联。 |
GitLab 流水线 | 流水线状态、引用、信息源、日期、链接和项目关联。 |
GitLab 发布版本 | 发布名称、标签、描述、发布日期、链接和项目关联。 |
GitLab 管理面板通过图表和工作队列汇总了这些记录。它包含未解决的问题、未完成的合并请求、失败的流水线、最近的发布版本以及项目活动。
这五个同步数据库包含相关记录。管理面板展示了这些记录的视图。你旧的问题或合并请求数据库可能包含的数据类型少于此技能的默认设置。
切换前请检查以下差异：
人员和标签： 作者、负责人和标签在本使用手册中以文本形式存储，它们并非 Notion 中的人员属性或多选属性。
项目关联： 问题、合并请求、流水线和发布应链接到其选定的项目记录。
记录标识： 来自不同项目的记录必须保持独立，即使它们使用相同的项目本地问题或合并请求编号。
附加内容： 本使用手册不会同步问题评论、合并请求讨论、存储库文件或作业日志。请让 Notion AI 评估你现有工作流程所需的任何额外字段。
等待 Notion AI 确认所有五个同步均正常，且初始导入已完成。
将每个选定的项目与 GitLab 进行比较。检查已打开和已关闭的问题、合并请求、流水线和发布的样本。
确认项目关联和管理面板视图显示了预期的记录。
检查最近的 GitLab 更改在成功刷新后是否已同步到替换项。
使用 Notion AI 查看旧数据库的自定义属性和仅 Notion 值。使用稳定的 GitLab 记录 ID 迁移你需要的内容。
更新应使用替换项的链接、关联数据库视图、关系和自动化。检查新页面的共享权限。
一旦你的团队开始使用替换项，请让 Notion AI 协助停用旧同步，同时保留旧数据库以供参考。
你无需删除旧数据库即可使用 Worker。请保留它，直到你确认团队的信息和工作流程已全部处理完毕。
该技能设置了五个每小时一次的同步，每种数据类型一个。项目在设置期间首先同步，以便其他数据库能将其记录关联到正确的项目。
每次成功的刷新都会读取已配置项目的所有结果页面，并更新匹配的 Notion 数据库。即使关闭 Notion，Worker 也会继续运行。
更新从 GitLab 流向 Notion。请在 GitLab 中更改已同步的值；Notion 中的更改不会回写。
每小时一次是计划安排，并不保证每次刷新都能在固定时间内完成。大型项目历史记录和 GitLab 请求限制可能会延迟完成。
提示：请保留完整的项目列表。这些同步使用替换模式：在完成刷新后缺失的记录将从已同步的数据库中移除。从配置中移除项目可能会删除其已同步的记录，包括这些页面上仅存在于 Notion 中的信息。在应用更改之前，请让 Notion AI 预览每个选定的项目和数据类型。
该技能从一个私有的 GitLab Sync 页面开始。请仅将其与应该查看导入记录的人员共享。
Notion 的权限控制访问已同步的数据。但 GitLab 项目上的 Visibility 属性或问题上的 Confidential 属性，并不会在 Notion 中自动赋予相应的信息源权限。在共享页面前，请先审核令牌包含的数据。
项目缺失
确认完整的项目列表和令牌访问权限。如果项目路径已更改，请向 Notion AI 提供项目的 URL 或数字 ID。不要为了绕过访问错误而使用缩减后的列表运行刷新。
问题或合并请求缺失
让 Notion AI 检查项目选择，确认它是否正在检查每种状态下的问题和合并请求，以及结果的每一页。同时检查 Notion 视图的筛选器。
管理面板为空
在重建管理面板之前，让 Notion AI 检查源数据库、其最新的同步结果以及项目关系。初始导入仍在运行时，管理面板可能会显示为空。
我看到了重复的数据库
在创建任何其他内容之前，请让 Notion AI 检查现有的 Worker、数据库 URL 和页面结构。该技能要求在 GitLab Sync 下存在五个实际同步的数据库和一个管理面板。在删除重复项之前，请让 Notion AI 识别出它们。
更新已停止
让 Notion AI 检查 Worker 的最新运行情况、令牌过期时间、令牌权限以及对每个所选项目的访问权限。对于自托管实例，还要检查配置的 GitLab 主机。请求限制可能会延迟更新。
