add-todo-all/DEMO.md

demo_video_url

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 }

没有视频时

以上图文覆盖了核心操作与返回结果样例；有视频后把 demo_video_url 填上真实可访问的地址即可，正文可保留为补充说明。