待办事项
待办事项是 Glint 的核心内容单元。每个待办事项属于一个分组，可以拥有嵌套的子待办层级，并支持评论和多选批量操作。
创建待办事项
在待办事项列表顶部的输入框中输入内容，然后按回车或点击添加。新待办事项将附加到列表末尾，具有下一个可用的 sortOrder 值。
若要创建子待办事项，请参见下方的子待办事项章节。
子待办事项
子待办事项是附属于父待办事项的嵌套待办。支持与顶级待办事项相同的所有操作（编辑、完成、删除、评论）。
创建子待办事项的步骤：
- 将鼠标悬停在现有待办事项上，显示其
...菜单。 - 点击添加子待办（或使用右键上下文菜单）。
- 输入标题后按回车。
子待办事项在其父项下方以缩进形式显示。点击父项旁边的展开/折叠箭头可控制子待办列表的显示。
WARNING
删除父待办事项会同时永久删除其所有子待办及相关评论。此操作不可撤销。
需要：add_subtodos 权限。
完成待办事项
点击复选框切换完成状态。已完成的待办事项以删除线样式显示。
- 你始终可以切换自己的待办状态。
- 切换他人的待办事项需要
complete_any_todo权限。
若分组启用了分离已完成待办选项，已完成的待办事项将移至列表底部的可折叠"已完成"区域中。
分配
分配用于表明"这件事由这些人负责"。一个待办可以同时分配给多名团队成员， 每位被分配者的头像都会显示在待办行上。
- 使用分配…（操作栏、
...菜单或右键）打开分配选择器——一个 GitHub 风格的 弹窗，包含搜索框和可勾选的成员列表。勾选成员即分配给他，取消勾选即移除；当前 所有被分配者都显示为勾选状态。 - 使用分配给我 / 取消分配给我进行一键自我分配。（此功能取代了旧的"认领" 特性；已有的认领已迁移为分配给自己。）
分配通过 todo:assigned 事件实时同步，因此所有查看该分组的人都会即时看到变化。
需要：assign_todos 权限。
分配给我
侧边栏顶部、待办列表上方有一个置顶的分配给我分类。它汇总当前工作区中所有分配 给你的未完成待办，并按待办列表分组。每个列表分组都可以折叠 / 展开（MS To Do 风格）； 折叠 / 展开状态会在后台按用户记住。
你可以直接在此视图中完成待办。完成后会保留分配关系，但会从此列表移除（此处不显示 已完成的待办）。
衍生应用可以通过跨应用接口 GET /api/cross-app/assigned-to-me 读取你在所有工作区中被分配的待办，该接口会按工作区划分结果。
内联编辑
- 从
...菜单或右键上下文菜单中点击编辑。 - 待办事项标题变为可编辑输入框。
- 按回车保存，按 Escape 取消（不保存修改）。
需要：编辑自己的待办需要 edit_own_todos，编辑他人的需要 edit_any_todo。
排序
在桌面端，抓取待办事项左侧的拖拽手柄并拖动到新位置。排序结果会自动保存到服务器。
- 移动端不支持拖拽排序。
- 只能在同一分组内对顶级待办事项进行相互排序。子待办事项的排序同样遵循此规则，仅限其父项的子列表范围内。
需要：reorder_todos 权限。
在列表间移动
待办事项（连同它的所有子待办）可以从一个分组移动到另一个分组。移动后的待办会成为目标分组中的顶级待办。
有两种移动方式：
- 上下文菜单 —— 右键点击待办（或打开它的
...菜单）并选择移动到列表。弹出的对话框中选择目标列表，然后点击插入到顶部或插入到底部（或取消）。 - 拖放（仅电脑端） —— 将待办拖到侧栏中的某个分组上。悬停在分组上时会出现两个叠加层：在左半边松手会加到该列表顶部，在右半边松手会加到底部。
如果目标列表中已存在同名的顶级待办，则无法移动进去。
需要：在待办当前分组中编辑该待办的权限（edit_own_todos / edit_any_todo）以及目标分组的 create_todos 权限。
评论
每个待办事项都有独立的评论区：
- 点击待办事项上的评论按钮或评论数量标记。
- 评论对话框打开，显示所有评论，包含作者、时间戳和内容。
- 输入新评论后点击发送（或按 Ctrl+Enter / Cmd+Enter）。
- 点击垃圾桶图标可删除评论（自己的评论可见，若拥有
delete_any_comment权限则可删除所有评论）。
需要：发布评论需要 comment 权限；删除需要 delete_own_comments 或 delete_any_comment。
多选操作
多选模式允许对多个待办事项同时执行批量操作。
进入选择模式：
- 右键点击任意待办事项 → 选择
- 或打开
...菜单 → 选择
选择条目：
- 点击任意待办事项切换选中 / 未选中状态。
- Shift+点击可范围选中从上次点击处到当前位置之间的所有待办事项。
- 点击选择栏中的全选可选中所有可见待办事项。
批量操作（通过选择栏）：
| 操作 | 说明 |
|---|---|
| 标记完成 | 将所有选中待办事项设为已完成 |
| 标记未完成 | 清除所有选中待办事项的完成状态 |
| 删除 | 永久删除所有选中待办事项（及其子待办） |
| 清除选择 | 退出选择模式，不做任何更改 |
右键上下文菜单
右键点击任意待办事项可打开上下文菜单，包含所有可用操作：
- 添加子待办
- 评论
- 选择 / 取消选择
- 全选
- 编辑
- 标记完成 / 标记未完成
- 移动到列表
- 删除
可用操作会根据当前权限自动过滤。你没有权限执行的操作将被隐藏或禁用。
键盘快捷键
| 快捷键 | 操作 |
|---|---|
| 回车 | 提交新待办事项输入 |
| Escape | 取消内联编辑 |
| Ctrl+Enter / Cmd+Enter | 发送评论 |
| Shift+点击 | 范围选择待办事项（在多选模式下） |
API 参考
完整的端点参考（包括字段级权限检查和级联删除行为），详见待办事项 API。