amemo-find-task

# 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` | --- ## 请求示例 ```bash # 查询所有任务（所有可选字段传 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 }' ``` --- ## 响应数据结构 ```json { "code": 200, "desc": "success", "data": { "recommend": [], "myFollow": [], "todayList": [], "tomorrowList": [], "recentList": [], "finishList": [], "futureList": [] } } ``` ### TaskInfo 任务信息 | 字段 | 类型 | 说明 | |:-----|:----:|:-----| | `taskId` | str | 任务唯一标识 | | `taskTitle` | str | 任务标题 | | `recentRemindTime` | int | 最近的提醒时间 | --- ## 待办清单展示模板 ### 无数据时回复 ```markdown **📋 暂无待办清单** > 创建新任务 → > • 「今天 3 点开会」 > • 「提醒我明天交报告」 ``` --- ### 任务清单展示模板 ```markdown **✅ 待办清单** · 共 {total} 项 --- ### 📅 今日待办 - ⏳ {task1} - ⏳ {task2} - ⏳ {task3} --- ### 📆 明日待办 ({count}) - ⏳ {task1} --- ### 📋 近期待办 ({count}) - ⏳ {task1} --- ### 🔮 未来待办 ({count}) - ⏳ {task1} --- ### ⭐ 收藏 ({count}) - ★ {task1} --- ### ✔ 已完成 ({count}) - ✓ {task1} ``` --- ### 单个任务项格式化 | 任务类型 | 格式 | |:---------|:-----| | 待做任务 | `{index}. {taskTitle}` | | 收藏任务 | `{index}. ⭐ {taskTitle}` | | 已完成任务 | `{index}. ✔ {taskTitle}` | --- ### 任务状态图标 | 状态 | 图标 | 说明 | |:-----|:----:|:-----| | pending | ⏳ | 待完成 | | completed | ✔ | 已完成 | | expired | ❌ | 已过期 | | follow | ⭐ | 已收藏 | --- ### 分组展示优先级 | 优先级 | 分类 | 说明 | |:------:|:-----|:-----| | 1 | 今日待办 | 今日必须完成的任务，优先展示 | | 2 | 明日待办 | 明日计划的任务 | | 3 | 近期待办 | 未来15天内的任务 | | 4 | 未来待办 | 15天之后的任务 | | 5 | 我的收藏 | 用户收藏的重要任务 | | 6 | 已完成 | 已完成的任务 | --- ### 分类计数统计 ```markdown | 分类 | 数量 | |:-----|:----:| | 今日待办 | {count} | | 明日待办 | {count} | | 近期待办 | {count} | | 未来待办 | {count} | | 我的收藏 | {count} | | 已完成 | {count} | | **总计** | **{count}** | ``` --- ### 任务为空时处理 如果某分类为空： | 分类 | 空状态提示 | |:-----|:----------| | 今日/明日/近期 | `暂无15天内待办` | | 未来 | `暂无未来待办` | | 收藏 | `暂无收藏任务` | | 已完成 | `暂无已完成任务` | --- ## 输出示例 ```markdown **✅ 待办清单** · 共 17 项 --- ### 📅 今日待办 - ⏳ 完成项目报告 - ⏳ 提交代码审查 - ⏳ 准备会议材料 --- ### 📆 明日待办 (2) - ⏳ 产品需求评审 - ⏳ 团队周会 --- ### 📋 近期待办 (4) - ⏳ 客户方案调整 - ⏳ 技术文档更新 - ⏳ 测试报告评审 - ⏳ 版本发布准备 --- ### 🔮 未来待办 (2) - ⏳ 季度 OKR 制定 - ⏳ 年度总结规划 --- ### ⭐ 收藏 (1) - ★ 年度总结 --- ### ✔ 已完成 (5) - ✓ 登录功能开发 - ✓ 数据库优化 - ✓ API 接口调试 - ✓ 前端页面联调 - ✓ 部署文档编写 ``` --- ## 调用示例 ### 示例一：查看待办清单 **用户输入：** ``` 查看我的待办清单 ``` **系统处理：** 1. 检查 `userToken` 2. 调用 `POST /find-task` 3. 解析返回数据，按分类组织展示 ### 示例二：查找清单 **用户输入：** ``` 查找我的清单 ``` **系统处理：** 1. 检查 `userToken` 2. 调用 `POST /find-task` 3. 格式化输出给用户 --- ## 执行流程（由主模块调度） ### 执行步骤 ``` 1. 识别触发词（查看/查询/列出 + 清单/任务/待办） ↓ 2. 检查 userToken 是否存在 ├── 无 token → 引导登录流程 ↓ 3. 调用 POST /find-task 接口 ↓ 4. 解析返回数据 ├── todayList: 今日列表 ├── tomorrowList: 明日列表 ├── recentList: 近期列表（15天内） ├── futureList: 未来列表 ├── finishList: 已完成列表 └── myFollow: 我的收藏 ↓ 5. 按分类组织并格式化输出 ``` --- ## 回复模板 ### 无数据时 ```markdown **📋 暂无待办清单** > 创建新任务 → > • 「今天 3 点开会」 > • 「提醒我明天交报告」 ```