---
demo_video_url: ""
---

# 演示说明

本演示帮助用户快速看懂「待办事项管理」技能从新建待办到标记完成的完整操作流程，以及各操作返回的结果样式。

## 建议观看顺序

1. 如何用自然语言发起一次待办新增
2. 如何查看待办列表与统计
3. 如何批量标记完成 / 删除
4. 成功后的结果长什么样

## 关键操作与结果样例

### 1. 新增待办

在对话框中输入：

> “帮我加一条待办：周五前提交项目周报，优先级高。”

执行成功后返回：

```
{
  "id": 1,
  "title": "周五前提交项目周报",
  "status": "pending",
  "priority": "high",
  "due_at": 1757337600,
  "created_at": 1757251200,
  "updated_at": 1757251200
}
```

> 记下返回的 `id`，后续标记完成或删除时需要用到。

### 2. 查看待办列表

输入：

> “帮我看看现在有哪些待办。”

返回待办清单（默认按创建时间倒序，最多 100 条）：

```
{
  "count": 2,
  "items": [
    { "id": 2, "title": "整理会议纪要", "status": "pending", "priority": "normal", "due_at": null },
    { "id": 1, "title": "周五前提交项目周报", "status": "pending", "priority": "high", "due_at": 1757337600 }
  ]
}
```

也可指定只看某一状态：

> “帮我看看已完成的待办。”

### 3. 标记完成

输入单条或批量编号：

> “把第 1 条待办标记为完成。”
>
> “把第 1、2 条待办都标记为完成。”

返回逐条处理结果：

```
{
  "count": 2,
  "items": [
    { "ok": true, "id": 1, "todo": { "status": "done", ... } },
    { "ok": true, "id": 2, "todo": { "status": "done", ... } }
  ]
}
```

### 4. 删除待办

输入：

> “把第 2 条待办删掉。”

返回：

```
{
  "count": 1,
  "items": [
    { "ok": true, "id": 2 }
  ]
}
```

### 5. 查看统计

输入：

> “帮我统计一下待办情况。”

返回：

```
{ "total": 5, "pending": 3, "done": 2 }
```