| name | amemo-save-task |
| description | 当用户说含时间词(今天/明天/后天/具体日期)的祈使句,或说「提醒我」「记得要」时调用,保存任务并创建麦小记邮件 + AI 定时双重提醒。 |
amemo-save-task — 保存任务
接口信息
| 属性 | 值 |
|---|
| 路由 | POST https://skill.amemo.cn/save-task |
| Bean | TaskBean |
| Content-Type | application/json |
请求参数
⚠️ 服务端要求所有字段必须存在。userToken、taskTitle、taskTime 必填且有值,其他字段可选但字段必须存在。
| 参数 | 类型 | 必填 | 说明 |
|---|
userToken | str | ✅ | 用户登录凭证 |
taskId | str | — | 任务 ID(新建传 null,更新时传入已有 ID) |
taskTitle | str | ✅ | 任务标题(不能为空) |
taskExplain | str | — | 任务说明,不传则传 null |
taskTime | str | ✅ | 任务时间(如 "2025-12-31",不能为空) |
taskEmail | list[str] | — | 通知邮箱列表,不传则传 null |
请求示例
curl -X POST https://skill.amemo.cn/save-task \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"taskId": null,
"taskTitle": "完成报告",
"taskExplain": null,
"taskTime": "2025-12-31",
"taskEmail": ["a@example.com"]
}'
curl -X POST https://skill.amemo.cn/save-task \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"taskId": "123456",
"taskTitle": "完成报告",
"taskExplain": null,
"taskTime": "2025-12-31",
"taskEmail": null
}'
响应示例
{
"code": 200,
"desc": "success",
"data": {
"taskId": "xyz456"
}
}
响应解析
| 字段 | 类型 | 说明 |
|---|
code | int | 状态码,200 表示成功 |
desc | str | 状态描述 |
data.taskId | str | 保存成功后返回的任务 ID,必须提取并保存到当前对话上下文 lastTaskId,用于后续邮件发送和更新操作 |
注意事项
📌 字段要求:所有字段必须存在,即使不传值也要传 null
🔄 新建 vs 更新:新建时 taskId 传 null,更新时传入已有 taskId
👥 多人通知:taskEmail 为字符串数组,可同时通知多人
执行流程(由主模块调度)
时间词语识别
| 时间词语 | 转换规则 | 示例(基准:当前系统日期) |
|---|
| 今天 / 今日 | 当天 00:00:00 | System Date → 当天 00:00:00 |
| 明天 / 明日 | 明天 00:00:00 | System Date + 1天 00:00:00 |
| 昨天 / 昨日 | 昨天 00:00:00 | System Date - 1天 00:00:00 |
| 后天 | 后天 00:00:00 | System Date + 2天 00:00:00 |
| 大后天 | 大后天 00:00:00 | System Date + 3天 00:00:00 |
| 将来 / 未来 | 当前时间 + 365天 | System Date + 365天 00:00:00 |
| 最近 / 最新 / 近期 | 当天时间 + 15天 | System Date + 15天 00:00:00 |
| 下周X | 下一个周X 00:00:00 | 当前周三 → 下周三 00:00:00 |
| 本周末 / 这周末 | 本周六 00:00:00 | 当周周六 00:00:00 |
| 下周末 | 下周六 00:00:00 | 下周周六 00:00:00 |
| 具体日期 | 原样转换 | 用户说"12月25日" → 当年12月25日 00:00:00 |
⚠️ 所有日期计算必须以 System Current Date 为基准,禁止使用文档中的任何固定日期作为参考。
时段词识别
当用户消息中包含时段描述时,在日期基础上叠加具体时间:
| 时段词 | 转换规则 | 示例 |
|---|
| 早上 / 早晨 / 清早 | 07:00:00 | "明天早上开会" → 明天 07:00:00 |
| 上午 | 09:00:00 | "明天上午开会" → 明天 09:00:00 |
| 中午 | 12:00:00 | "明天中午吃饭" → 明天 12:00:00 |
| 下午 | 14:00:00 | "明天下午开会" → 明天 14:00:00 |
| 晚上 / 傍晚 | 19:00:00 | "明天晚上看电影" → 明天 19:00:00 |
| 深夜 / 半夜 | 23:00:00 | "明天深夜加班" → 明天 23:00:00 |
| 具体时间 | 原样转换 | "下午3点" → 15:00:00,"上午10点半" → 10:30:00 |
时段词解析规则
- 时段词可与日期词组合:"明天下午3点" = 明天日期 + 15:00:00
- 仅有时段词无日期词时,默认视为"今天":用户说"下午3点开会" → 今天 15:00:00
- 同时出现时段词和具体时间时,具体时间优先:"下午3点半"取 15:30:00,而非 14:00:00
- 无法解析时段时,默认 00:00:00
时间转换汇总
| 时间词 | 转换 |
|---|
| 今天/明日 | 当天 00:00:00 |
| 明天/明日 | 明天 00:00:00 |
| 后天 | 后天 00:00:00 |
| 将来/未来 | 当前+365天 |
| 最近/最新/近期 | 当前+15天 |
时段叠加: 早上→07:00、上午→09:00、中午→12:00、下午→14:00、晚上→19:00
时间转换优先级
- 精确日期匹配优先(如"12月25日")
- 时间词语次之(如"明天"、"下周")
- 无法识别时使用当前时间
多时间词批量处理
当用户单条消息中包含多个时间词时,拆分为多个独立任务:
拆分规则:
- 识别所有时间词,按出现顺序排列
- 每个时间词对应一个待办事项
- 如果多个时间词共享同一个待办内容,则为每个时间词各创建一条任务
| 用户输入 | 拆分结果 |
|---|
| "今天和明天都要开会" | 任务1: 今天开会 / 任务2: 明天开会 |
| "后天和大后天去医院复查和拿报告" | 任务1: 后天去医院复查 / 任务2: 大后天拿报告 |
| "3月1号和3月5号交房租" | 任务1: 3月1日交房租 / 任务2: 3月5日交房租 |
无法拆分时:
- 时间词指向同一事项且无法分离时,按最晚时间创建一条任务,并在 taskTitle 中标注范围
- 示例:"这周每天都要跑步" → 创建一条任务,taskTitle: "每天跑步",taskTime: 本周末 00:00:00
任务内容提取
- 从对话中提取任务标题(taskTitle)
- 去除语气词、感叹词
- 保留核心任务内容
执行步骤
1. 检测用户对话中的时间词语
↓
2. 提取并转换时间
↓
3. 提取待办事项
↓
4. 检查 userToken
├── 无 token → 引导登录流程
↓
5. 【第一优先级】保存到麦小记
├── 调用 POST /save-task 接口
├── 从返回的 data 字段中提取 taskId,记录到当前对话上下文(lastTaskId)
└── 失败时记录日志但不阻断流程
↓
6. 【第二优先级】调用当前 AI 工具的定时任务能力创建提醒
├── 使用当前 AI 工具提供的定时任务接口创建提醒
├── 检查用户是否已设置邮件提醒邮箱
│ ├── 已设置 → 跳过邮件配置
│ └── 未设置 → 询问用户邮箱 → 调用 amemo-send-task 发送邮件
└── 确保提醒必达
↓
7. 返回保存结果
AI 工具定时任务参数
| 参数 | 类型 | 必填 | 说明 |
|---|
name | str | ✅ | 任务名称(与 taskTitle 一致) |
schedule.at | str | ✅ | ISO 8601 格式时间 |
payload.text | str | ✅ | 提醒消息内容 |
sessionTarget | str | ✅ | "main" |
⚠️ AI 工具定时任务由当前调用此 SKILL 的 AI 工具提供,使用其自身的定时任务接口创建,而非操作系统级别的 cron。
邮件提醒检查流程
检查方式
读取主 SKILL.md 顶部 <amemo-user-config> 块中的 userEmail 字段:
userEmail 不为空 → 已配置,直接使用
userEmail 为空字符串 → 未配置,进入询问流程
存储规范:用户首次确认邮箱后,使用文件编辑工具将邮箱写入主 SKILL.md 的 <amemo-user-config> 块 userEmail 字段,与 userToken 同处管理,无需依赖外部配置文件或环境变量。
分支处理
情况零:用户消息中已包含邮箱
用户消息中直接检测到邮箱地址(正则:\S+@\S+\.\S+)
→ 跳过邮箱询问
→ 直接使用检测到的邮箱
→ 调用 amemo-send-task 发送邮件提醒
示例:"明天开会,发邮件到 test@example.com" → 直接使用 test@example.com
情况一:已设置邮件
检测到用户已配置邮件:xxx@example.com
→ 跳过邮箱询问
→ 当前 AI 工具定时任务将在提醒时间自动触发
情况二:未设置邮件
未检测到邮件配置(userEmail 为空)
→ 提示用户:"📧 是否开启邮件提醒?请输入邮箱地址(或直接回复'跳过')"
→ 等待用户输入
├── 用户输入有效邮箱
│ → 写入主 SKILL.md <amemo-user-config> 的 userEmail 字段
│ → 调用 amemo-send-task 发送测试邮件
├── 用户回复"跳过" → 仅保留当前 AI 工具定时任务
└── 用户输入无效 → 提示重新输入或跳过
📖 具体请求参数和调用示例,请查阅 modules/amemo-send-task/SKILL.md
响应处理
都成功时
✅ 已为您设置提醒:「{taskTitle}」
📅 时间:{taskTime}
📧 麦小记邮件提醒:已保存
⏰ AI 工具定时提醒:已设置
双重保障,确保您不会错过!
麦小记成功,AI 工具失败时
✅ 已为您保存待办:「{taskTitle}」
📅 时间:{taskTime}
📧 麦小记邮件提醒:已启用
⚠️ AI 工具定时提醒设置失败,但麦小记邮件提醒仍可用。
麦小记失败,AI 工具成功时
⚠️ 麦小记保存失败,已启用 AI 工具定时提醒
⏰ 提醒时间:{taskTime}
📋 任务:{taskTitle}
当前 AI 工具将在指定时间提醒您。
都失败时
❌ 提醒设置失败
可能原因:
• 麦小记服务异常
• 当前 AI 工具暂不支持定时任务
请检查服务状态后重试。
调用示例
示例一:首次使用(未设置邮件)
用户输入:
明天早上提醒我早起买胡辣汤
系统处理:
- 检测到时间词语:
明天早上
- 转换时间:
2026-03-23 07:00:00(早上默认7点)
- 提取待办:
早起买胡辣汤
- 【第一优先级】调用
POST /save-task 保存到麦小记
- 【第二优先级】调用当前 AI 工具的定时任务能力创建备份提醒
- 检查邮件配置 → 未设置
- 询问用户:
✅ 已为您设置提醒:「早起买胡辣汤」
📅 时间:2026-03-23 07:00:00
📧 麦小记邮件提醒:已保存
⏰ AI 工具定时提醒:已设置
💡 是否开启邮件提醒?请输入邮箱地址(或回复"跳过"):
用户回复: lockfeel@example.com
系统处理:
8. 验证邮箱格式
9. 保存邮箱配置到本地
10. 调用 POST /send-task 发送测试邮件
11. 返回:
✅ 邮件提醒已设置!
📧 接收邮箱:lockfeel@example.com
⏰ 提醒时间:2026-03-23 07:00:00
测试邮件已发送,请查收。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 提醒配置总览
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📧 麦小记清单:已保存
⏰ AI 工具定时任务:已设置
📧 邮件提醒:已启用
三重保障,确保您不会错过!
示例二:已设置邮件(自动跳过询问)
用户输入:
12月25日要送礼物
系统处理:
- 检测到时间词语:
12月25日
- 转换时间:
2024-12-25 00:00:00
- 提取待办:
送礼物
- 【第一优先级】调用
POST /save-task 保存到麦小记
- 【第二优先级】调用当前 AI 工具的定时任务能力创建备份提醒
- 检查邮件配置 → 已设置:lockfeel@example.com
- 自动调用
POST /send-task 发送邮件提醒
- 返回:
✅ 已为您设置提醒:「送礼物」
📅 时间:2024-12-25 00:00:00
📧 麦小记清单:已保存
⏰ AI 工具定时任务:已设置
📧 邮件提醒:已启用(lockfeel@example.com)
三重保障,确保您不会错过!
示例三:用户选择跳过邮件
用户输入:
后天要去医院复查
系统处理:
1-5. (同上,保存到麦小记 + 当前 AI 工具创建定时任务)
6. 检查邮件配置 → 未设置
7. 询问用户邮箱
8. 用户回复: 跳过
9. 返回:
✅ 已为您设置提醒:「去医院复查」
📅 时间:2024-03-24 00:00:00
📧 麦小记清单:已保存
⏰ AI 工具定时任务:已设置
📧 邮件提醒:未启用
💡 如需开启邮件提醒,可随时说"设置邮件提醒"