amemo-find-task — 查询任务
接口信息
| 属性 |
值 |
| 路由 |
POST https://skill.amemo.cn/find-task |
| Bean |
TaskBean |
| Content-Type |
application/json |
请求参数
⚠️ 服务端要求所有字段必须存在。userToken 必填且有值,其他字段可选但字段必须存在。
| 参数 |
类型 |
必填 |
说明 |
userToken |
str |
✅ |
用户登录凭证 |
taskId |
str |
— |
按 ID 精确查询,不传则传 null |
taskTitle |
str |
— |
按标题模糊查询,不传则传 null |
taskTime |
str |
— |
按时间筛选,不传则传 null |
taskEmail |
list[str] |
— |
按邮箱筛选,不传则传 null |
请求示例
# 查询所有任务(所有可选字段传 null)
curl -X POST https://skill.amemo.cn/find-task \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"taskId": null,
"taskTitle": null,
"taskTime": null,
"taskEmail": null
}'
# 按标题查询
curl -X POST https://skill.amemo.cn/find-task \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"taskId": null,
"taskTitle": "报告",
"taskTime": null,
"taskEmail": null
}'
响应数据结构
{
"code": 200,
"desc": "success",
"data": {
"recommend": [],
"myFollow": [],
"todayList": [],
"tomorrowList": [],
"recentList": [],
"finishList": [],
"futureList": []
}
}
TaskInfo 任务信息
| 字段 |
类型 |
说明 |
taskId |
str |
任务唯一标识 |
taskTitle |
str |
任务标题 |
recentRemindTime |
int |
最近的提醒时间 |
执行流程
1. 识别触发词(查看/查询/列出 + 清单/任务/待办)
↓
2. 检查 userToken 是否存在 → 无 token 则引导登录
↓
3. 调用 POST /find-task 接口
↓
4. 解析返回的 7 个分类列表
↓
5. 按优先级分组格式化输出
分组展示规则
| 优先级 |
分类 |
说明 |
| 1 |
今日待办 |
今日必须完成的任务,优先展示 |
| 2 |
明日待办 |
明日计划的任务 |
| 3 |
近期待办 |
未来15天内的任务 |
| 4 |
未来待办 |
15天之后的任务 |
| 5 |
我的收藏 |
用户收藏的重要任务 |
| 6 |
已完成 |
已完成的任务 |
空分类处理
| 分类 |
空状态提示 |
| 今日/明日/近期 |
暂无15天内待办 |
| 未来 |
暂无未来待办 |
| 收藏 |
暂无收藏任务 |
| 已完成 |
暂无已完成任务 |
输出模板
无数据时
**📋 暂无待办清单**
> 创建新任务 →
> • 「今天 3 点开会」
> • 「提醒我明天交报告」
有数据时
**✅ 待办清单** · 共 {total} 项
---
### 📅 今日待办
- ⏳ {task1}
- ⏳ {task2}
---
### 📆 明日待办 ({count})
- ⏳ {task1}
---
### 📋 近期待办 ({count})
- ⏳ {task1}
---
### 🔮 未来待办 ({count})
- ⏳ {task1}
---
### ⭐ 收藏 ({count})
- ★ {task1}
---
### ✔ 已完成 ({count})
- ✓ {task1}
任务项格式
| 类型 |
格式 |
| 待做 |
{taskTitle} |
| 收藏 |
⭐ {taskTitle} |
| 已完成 |
✓ {taskTitle} |
| 已过期 |
❌ {taskTitle} |