待办事项列表
- Tier: 免费版、高级版、旗舰版
- Offering: GitLab.com、GitLab 自托管、GitLab 专用版
你的待办事项列表是一个按时间顺序排列的、等待你处理的条目列表。 这些条目被称为待办事项。
你可以使用待办事项列表来跟踪你在 GitLab 中工作相关的操作。 当有人联系你或需要你关注时，一个待办事项会出现在你的待办事项列表中。
访问待办事项列表
要访问你的待办事项列表：
在左侧边栏顶部，选择待办事项列表（ ）。
筛选待办事项列表
要筛选你的待办事项列表：
- 在列表上方，将光标放在文本框中。
- 从预定义的筛选器中选择一个。
- 按 Enter。
排序待办事项列表
要排序待办事项列表：
-
在待办标签页，右上角，从以下选项中选择：
- 推荐按创建日期和之前延期的日期组合排序，之前延期的项目排在顶部。
- 更新时间按项目最近更新的日期排序。
- 标签优先级按你设置的优先级排序。
-
可选。选择排序方向。
在延期和已完成标签页，推荐仅按创建日期对项目进行排序。
创建待办事项的操作
此功能的可用性由功能开关控制。 有关更多信息，请查看历史记录。
许多待办事项是自动创建的。 以下是一些将待办事项添加到你的待办事项列表的操作：
- 问题或合并请求被分配给你。
- 请求了合并请求审查。
- 你在问题、合并请求或史诗的描述或评论中被提及。
- 你在提交或设计的评论中被提及。
- 你的合并请求的 CI/CD 管道失败。
- 由于冲突，开放的合并请求无法合并，并且以下条件之一为真：
- 你是作者。
- 你是设置合并请求在管道成功后自动合并的用户。
- 合并请求从合并队列中移除，并且你是添加它的用户。
- 为你拥有所有权的组或项目提出了成员访问请求。
在 GitLab 17.8 及更高版本中，每次有人提及你时，你都会收到一个新的待办事项通知，即使在同一个问题或合并请求中也是如此。
对于创建待办事项的其他操作，如分配或审查请求，即使同一操作在同一问题或合并请求中多次发生，你也只会收到每个操作类型的一个通知。
待办事项不受GitLab 通知邮件设置的影响。 唯一的例外：如果你的通知设置设置为自定义，并且选择了你有资格批准的合并请求已创建，那么当你有资格批准合并请求时，你会得到一个待办事项。
创建待办事项
你可以手动将项目添加到你的待办事项列表。
通过提及某人创建待办事项
你可以通过在任何地方（代码块除外）提及某人来创建待办事项。在一个消息中多次提及用户只会创建一个待办事项。
例如，从以下评论中，除了 frank 之外，每个人都会为他们创建一个待办事项：
@alice 你觉得怎么样？抄送：@bob
- @carol 能请你看看吗？
> @dan 你觉得怎么样？
嘿 @erin，这是他们说的：
```
你好，请给 @frank 发消息 :incoming_envelope:
```重新添加已完成的待办事项
如果你错误地将待办事项标记为已完成，你可以从已完成标签页重新添加它：
- 在左侧边栏顶部，选择待办事项列表（ ）。
- 在顶部，选择已完成。
- 找到你要重新添加的待办事项。
- 在此待办事项旁边，选择重新添加此待办事项 。
该待办事项现在在待办事项列表的待办标签页中可见。
将待办事项标记为已完成的操作
对待办事项对象（如问题、合并请求或史诗）的各种操作会将其对应的待办事项标记为已完成。
如果你执行以下操作，待办事项会被标记为已完成：
- 为描述或评论添加表情反应。
- 添加或删除标签。
- 更改指派人。
- 更改里程碑。
- 关闭待办事项的对象。
- 创建评论。
- 编辑描述。
- 解决设计讨论线程。
- 接受或拒绝项目或组成员资格请求。
如果你执行以下操作，待办事项不会被标记为已完成：
如果其他人关闭、合并或对问题、合并请求或史诗采取行动，你的待办事项将保持待处理状态。
将待办事项标记为已完成
你可以手动将待办事项标记为已完成。
有两种方法可以做到这一点：
- 在待办事项列表中，在待办事项右侧，选择标记为已完成（ ）。
- 在资源的右上角（例如问题或合并请求），选择标记为已完成（ ）。
批量编辑待办事项
你可以批量编辑你的待办事项：
- 在待办标签页：将待办事项标记为已完成或延期。
- 在延期标签页：将待办事项标记为已完成或移除它们。
- 在已完成标签页：恢复待办事项。
要批量编辑待办事项：
- 在你的待办事项列表中：
- 要选择单个项目，在要编辑的每个项目左侧，选择复选框。
- 要选择页面上的所有项目，在左上角，选择全选复选框。
- 在右上角，选择所需的操作。
延期待办事项
你可以延期待办事项，以暂时将它们从主待办事项列表中隐藏。这使你可以专注于更紧急的任务，稍后再处理延期的项目。
要延期待办事项：
- 在你的待办事项列表中，在要延期的待办事项旁边，选择延期（ ）。
- 如果你想将待办事项延期到特定时间，选择
直到特定时间选项。否则，选择预设的延期时长之一：- 延期一小时
- 延期到今天晚些时候（4小时后）
- 延期到明天（明天早上8点本地时间）
延期的待办事项会从主待办事项列表中移除，并显示在单独的延期标签页中。
当延期结束时，待办事项会自动返回到你的主待办事项列表。它会显示一个指示器，显示其原始创建时间。
查看延期的待办事项
要查看或管理你延期的待办事项：
- 转到你的待办事项列表。
- 在列表顶部，选择延期标签页。
从延期标签页，你可以：
- 查看延期的待办事项计划何时返回到主列表。
- 移除延期，立即将项目返回到主待办事项列表。
- 将延期的待办事项标记为已完成。
用户访问权限变更时如何影响其待办事项列表
出于安全原因，当用户不再有权访问相关资源时，GitLab 会删除待办事项。 例如，如果用户不再有权访问问题、合并请求、史诗、项目或组， GitLab 会删除相关的待办事项。
此过程在用户访问权限变更后的一小时内发生。删除被延迟以 防止数据丢失，以防用户的访问权限被意外撤销。