# 待办

> 用 dino todo 在终端里建待办清单、追加任务、设置优先级和截止时间、查询进度、勾选完成，也可以一句话交给 AI 助手。

- 网页：https://dinox.info/guides/cli/todo
- 本页 Markdown：https://dinox.info/guides/cli/todo.md
- 全部文档索引：https://dinox.info/llms.txt

Dinox 的待办就是笔记里的勾选框。`dino todo` 让你不打开 App 也能建清单、加任务、勾掉做完的事——写代码写到一半想起一件事，一条命令就记进今天的待办。

## 案例：一份「发布前检查清单」

### 第 1 步：把清单写在文件里，一次建好

`release-todo.txt` 里每行一个任务：

```text
更新 CLI 更新日志
在测试机上跑一遍 dino doctor
通知团队升级
```

```bash
dino todo create --title "示例：发布前检查清单" \
  --tasks @./release-todo.txt --priority high --due 2026-11-28
```

![截图：用 todo create 建清单（一条命令建好待办笔记：3 个高优先级任务，统一截止日期；upload_queue_remaining: 0 表示已上传到云端）](https://dinox.info/assets/docs/cli/todo-create.webp)

### 第 2 步：临时想起一件事，追加进去

```bash
dino todo append --note-id <清单笔记ID> --task "准备发布说明 [#A]" --due 2026-11-27 --time 18:00
```

![截图：往清单里追加任务（追加一个带具体时间的任务；[#A] 是高优先级的简写）](https://dinox.info/assets/docs/cli/todo-append.webp)

任务文字支持行内 Markdown：`#标签` 会变成真正的标签，`[#A]` / `[#B]` / `[#C]` 设置优先级。不传 `--note-id` 时，任务会加进**今天的每日待办**（没有就自动创建）；`--parent <任务ID>` 可以加成子任务。

### 第 3 步：查看进度

```bash
dino todo search 发布前检查清单 --select tasks.text,tasks.status,tasks.priority,tasks.due_time.iso
```

![截图：查询清单里的任务（每个任务的文字、完成状态、优先级和截止时间）](https://dinox.info/assets/docs/cli/todo-search.webp)

只看没做完的：加 `--status uncompleted`。`todo search` 不带关键词时会列出所有待办。

### 第 4 步：做完一项，勾掉

用 `todo search` 拿到任务 ID（`task_id`）和所在笔记 ID（`note_id`），然后：

```bash
dino todo update <任务ID> --note-id <清单笔记ID> --status done
```

![截图：勾选完成一个任务（把「在测试机上跑一遍 dino doctor」标为完成；勾选父任务时子任务会一起勾上）](https://dinox.info/assets/docs/cli/todo-update.webp)

改回未完成用 `--status undone`。`todo update` 也能改优先级（`--priority`）和截止时间（`--due` / `--time`）。

> **提示**
> 当前版本（2.20.x）的任务只有「完成 / 未完成」两种状态：`--status done` / `undone`。App 里新增的「待安排、进行中、已取消」等五种状态，会在后续版本的 CLI 中支持。

## 交给 AI 助手

装好 [Dinox Skills](https://dinox.info/guides/cli/skills.md) 后，直接说就行。下面是 Codex 用 `dino-manage-todo` 技能勾掉任务的真实过程——它先搜出任务 ID，再更新：

![截图：Codex 帮你勾掉待办（「通知团队升级已经做完了，帮我勾掉」—— Codex 搜索任务、更新状态，并确认已同步）](https://dinox.info/assets/docs/cli/chat-todo.webp)

## 常用参数一览

| 参数                                | 适用命令                 | 作用                            |
| --------------------------------- | -------------------- | ----------------------------- |
| `--task` / `--tasks`              | create、append        | 单个任务（可重复）/ 一组任务（逗号、换行或 `@文件`） |
| `--priority high\|medium\|low`    | create、append、update | 优先级                           |
| `--due YYYY-MM-DD` `--time HH:mm` | create、append、update | 截止日期和时间（不写时间就是全天）             |
| `--note-id`                       | append、update        | 目标清单笔记                        |
| `--parent`                        | append               | 作为某个任务的子任务                    |
| `--status`                        | update、search        | 完成状态                          |