114 lines
2.1 KiB
Markdown
114 lines
2.1 KiB
Markdown
---
|
|
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` 填上真实可访问的地址即可，正文可保留为补充说明。
|