待办事项列表

你的待办事项列表是一个按时间顺序排列的等待你处理的事项列表。这些事项被称为待办事项。

你可以使用待办事项列表来跟踪与你在极狐GitLab 中所做工作相关的操作。当有人联系你或需要你的注意时，待办事项会出现在你的待办事项列表中。

访问待办事项列表#

要访问你的待办事项列表：

在左侧边栏顶部，选择待办事项列表 (

)。

筛选待办事项列表#

要筛选待办事项列表：

1. 在列表上方，将光标放在文本框中。
2. 从预定义的筛选器中选择。
3. 按 Enter。

排序待办事项列表#

要排序待办事项列表：

1. 在待办标签页右上角，从选项中选择：

   • 推荐按创建日期和之前的暂停日期组合排序，之前暂停的事项排在顶部。
   • 更新按事项最近更新的日期排序。
   • 标签优先级按你设置的优先级排序。

2. 可选。选择排序方向。

创建待办事项的操作#

许多待办事项是自动创建的。添加待办事项到你的待办事项列表的一些操作：

• 一个议题或合并请求被分配给你。
• 请求合并请求评审。
• 在议题、合并请求或史诗的描述或评论中提到你。
• 在提交或设计的评论中提到你。
• 合并请求的 CI/CD 流水线失败。
• 一个开放的合并请求由于冲突而无法合并，并且以下情况之一为真：
  • 你是作者。
  • 你是设置合并请求在流水线成功后自动合并的用户。
• 合并请求从合并列车中移除，并且你是添加它的用户。
• 为你拥有的群组或项目提出成员访问请求。

在极狐GitLab 17.8 及之后，每次有人提到你时，即使是在同一个议题或合并请求中，你都会收到新的待办通知。

对于其他创建待办事项的操作，如分配或评审请求，你每种操作类型只会收到一个通知，即使在同一个议题或合并请求中发生多次。

待办事项不受极狐GitLab 通知电子邮件设置影响。唯一的例外是：如果你的通知设置为自定义并选择了添加为审批者，当你有资格批准合并请求时，你会收到待办事项。

创建待办事项#

你可以手动添加事项到你的待办事项列表。

1. 前往你的：

   • 议题
   • 合并请求
   • 史诗
   • 设计
   • 事件
   • 目标或关键结果
   • 任务

2. 在右上角，选择添加待办事项 (

   )。

通过提到某人创建待办事项#

你可以通过在代码块之外的任何地方提到某人来创建待办事项。在一条消息中多次提到用户只会创建一个待办事项。

例如，从以下评论中，除了 frank 外，其他人都会为他们创建待办事项：

markdown
1@alice 你怎么看？cc: @bob
2
3- @carol 请看一下？
4
5> @dan 你怎么看？
6
7嘿 @erin，这是他们说的：
8
9```
10嗨，请给 @frank 发消息 :incoming_envelope:
11```

重新添加已完成的待办事项#

如果你错误地将待办事项标记为完成，你可以从完成标签页重新添加它：

1. 在左侧边栏顶部，选择待办事项列表 (
   )。
2. 在顶部，选择完成。
3. 找到你想要重新添加的待办事项。
4. 在此待办事项旁边，选择重新添加此待办事项
   。

待办事项现在在待办事项列表的待办标签页中可见。

标记待办事项为完成的操作#

对待办事项对象（如议题、合并请求或史诗）执行的各种操作会将其对应的待办事项标记为完成。

如果你执行以下操作，待办事项会被标记为完成：

• 对描述或评论添加表情反应。
• 添加或移除标签。
• 更改分配者。
• 更改里程碑。
• 关闭待办事项的对象。
• 创建评论。
• 编辑描述。
• 解决设计讨论线程。
• 接受或拒绝项目或群组的成员请求。

待办事项不会标记为完成，如果你：

• 添加链接的事项（如链接议题）。
• 添加子事项（如子史诗或任务）。
• 添加时间条目。
• 自己分配。
• 更改健康状态。

如果其他人关闭、合并或对议题、合并请求或史诗采取行动，你的待办事项仍保持待处理状态。

标记待办事项为完成#

你可以手动标记待办事项为完成。

有两种方法可以做到这一点：

• 在待办事项列表中，在待办事项的右侧选择标记为完成 (
  )。
• 在资源的右上角（例如议题或合并请求），选择标记为完成 (
  )。

批量编辑待办事项#

你可以批量编辑待办事项：

• 在待办标签页：标记待办事项为完成或暂停它们。
• 在暂停标签页：标记待办事项为完成或移除它们。
• 在完成标签页：恢复待办事项。

要批量编辑待办事项：

1. 在你的待办事项列表中：
   • 要选择单个事项，请在每个待编辑事项的左侧选择复选框。
   • 要选择页面上的所有事项，请在左上角选择全选复选框。
2. 在右上角，选择所需的操作。

暂停待办事项#

你可以暂停待办事项以暂时隐藏它们，使你能够专注于更紧急的任务，并稍后返回暂停的事项。

要暂停待办事项：

1. 在待办事项列表中，选择你想暂停的待办事项旁边的暂停 (
   )。
2. 如果你希望暂停待办事项直到特定的时间和日期，请选择直到特定的时间和日期选项。否则，选择一个预设的暂停时间段：
   • 一个小时
   • 今天晚些时候（4 小时后）
   • 明天（明天上午 8 点本地时间）

暂停的待办事项会从你的主待办事项列表中移除，并出现在单独的暂停标签页中。

当暂停期结束时，待办事项会自动返回到你的主待办事项列表。它会显示一个指示器，指示其最初创建的时间。

查看暂停的待办事项#

要查看或管理你的暂停待办事项：

1. 前往你的待办事项列表。
2. 在列表顶部，选择暂停标签页。

在暂停标签页中，你可以：

• 查看暂停的待办事项何时计划返回到你的主列表。
• 移除暂停以立即返回待办事项到你的主待办事项列表。
• 将暂停的待办事项标记为完成。

当用户的访问权限发生变化时待办事项列表的影响#

出于安全原因，当用户不再有相关资源的访问权限时，极狐GitLab 会删除待办事项。例如，如果用户不再有议题、合并请求、史诗、项目或群组的访问权限，极狐GitLab 会删除相关的待办事项。

此过程会在他们的访问权限变化后的一小时内发生。删除操作会延迟，以防止数据丢失，以防用户的访问权限被意外撤销。