Skip to content

待办分组

待办分组是将相关待办事项组织在一起的容器,归属于某个团队工作区。每个待办事项只属于一个分组。分组显示在侧边栏中,可以重新排序、重命名或删除。


默认分组

用户首次访问团队工作区时,若不存在任何分组,Glint 会自动创建一个默认分组。默认分组名称可在设置 → 品牌中配置(default_set_name,默认值为 "Not Grouped",即"未分组")。

这确保工作区无需任何手动设置即可立即使用。


创建分组

拥有 manage_sets 权限的用户可以创建分组:

  1. 滚动到侧边栏分组列表底部。
  2. 点击新建分组
  3. 输入名称后按回车或点击确认按钮。

新分组将附加在列表末尾(具有下一个可用的 sortOrder 值),并自动成为当前活动分组。


重命名分组

  1. 将鼠标悬停在侧边栏的分组上,显示 ... 菜单。
  2. 点击重命名
  3. 在对话框中输入新名称并确认。

需要:manage_sets 权限,或者你是该分组的创建者。


删除分组

  1. 打开分组的 ... 菜单。
  2. 点击删除
  3. 在对话框中确认删除。

WARNING

删除分组将永久删除该分组及其中的所有待办事项,包括子待办和所有评论。此操作不可撤销。

需要:manage_sets 权限,或者你是该分组的创建者。


分组排序

在桌面端,使用拖拽手柄拖动侧边栏中的分组以更改排列顺序。新顺序会立即通过排序 API 保存。

移动端不支持拖拽排序。在移动端,可通过设置 → 分组(需要 manage_sets 权限)进行排序。

需要:manage_sets 权限。


按分组选项

每个分组都有可配置的选项,可通过 ... 菜单 → 选项(或分组设置面板)访问。

分离已完成待办

启用后,已完成的待办事项将从活动待办事项中分离出来——它们显示在一个可折叠的"已完成"区域中,位于活动列表的下方。

此设置按分组单独配置,不影响其他分组。该设置是服务端属性,对所有查看该分组的用户生效(并非个人偏好设置)。

自动续期

自动续期可将分组变为周期性清单。启用后,分组内所有已完成的待办事项每天会在配置的时间一次性重置为未完成——非常适合每日站会、日常例行或习惯打卡列表。

选项说明
自动续期该功能的总开关。
续期时间重置运行的本地时间,格式为 HH:MM(如 06:00)。
时区用于解释续期时间的 IANA 时区。留空时使用团队的 default_timezone(设置 → 品牌)。

一个 Cloudflare cron 任务每 15 分钟运行一次,在新的一天本地时间首次越过续期时间时为每个符合条件的分组续期。分组的待办事项和标题会被保留——仅清除它们的完成状态。

需要:manage_sets 权限,或你必须是该分组的创建者。


导入与导出

分组可以以 MarkdownJSONYAML 格式导出和导入。这对于备份、在工作区之间迁移清单,或从外部来源初始化分组非常方便。

导出

  1. 打开分组的 ... 菜单并选择导出
  2. 选择格式(Markdown / JSON / YAML)以及是否包含评论。
  3. 文件以由分组名称派生的文件名下载。

需要:该分组的 view_todos 权限。

导入

你可以导入到当前分组(追加或替换其待办事项),或从导入内容创建一个全新分组

  • 追加会将导入的待办事项添加到现有列表中。
  • 替换会先清空分组当前的待办事项(需要 manage_sets)。

Markdown 使用熟悉的 - [ ] / - [x] 复选框语法,并通过缩进表示子待办。JSON 和 YAML 携带包含分组元数据在内的完整结构。

需要:导入到分组需要 create_todos;替换内容或作为新分组导入需要 manage_sets

从 Microsoft To Do 导入

导入对话框的左下角有一个 从 MS Todo 导入 按钮,点击后会打开一个专用弹窗,用于从 Microsoft To Do 迁移数据。

  1. 打开导出工具 ms-todo-export.azurewebsites.net(开源地址:alan-null/ms-todo-export),将数据导出为 JSON 备份。
  2. 点击 从 MS Todo 导入,然后上传下载好的 JSON 文件。解析完全在你的浏览器中完成——在你点击导入之前不会上传任何内容。
  3. 文件中找到的每个 To Do 列表都会被列出。对每个列表你可以:
    • 切换是否导入该列表。
    • 选择追加到现有列表(并指定追加到最前还是最后),或——默认情况下——创建一个新列表,其名称可以编辑。
  4. 每个任务的检查清单项会成为子待办,任务备注(正文)会作为评论导入。
  5. 点击 导入,列表会被逐个上传,并显示进度。

WARNING

Microsoft To Do 中的附件和图片暂不支持。如果文件中包含附件,导入前会提示有多少个任务的附件将被忽略。

需要:追加到列表需要 create_todos;创建新列表需要 manage_sets


按分组权限

每个分组都可以有独立于全局团队权限的权限覆盖,适用于以下场景:

  • 限制敏感分组 — 防止成员查看用于机密规划的分组。
  • 开放特定分组 — 允许成员在单个分组中排序或管理待办事项,而不授予全局权限。

配置按分组权限的步骤:

  1. 前往设置 → 权限
  2. 打开范围下拉菜单,选择特定分组。
  3. 根据需要为管理员 / 成员切换权限开关。
  4. 点击保存权限

按分组覆盖优先于全局权限。详见权限中的完整解析顺序说明。


分组可见性

对至少一个分组拥有 view_todos 权限的所有团队成员均可看到分组列表。若特定分组的 view_todos 权限被撤销,该角色的用户:

  • 导航到该分组时,看不到待办事项内容。
  • 收到"未授权"提示,并被重定向回主页。
  • 分组仍显示在侧边栏中(不会被隐藏),但点击时访问会被阻止。

API 参考

完整的端点参考(包括请求/响应结构和错误码),详见待办分组 API