amemo-save-memo — 保存备忘录
接口信息
| 属性 |
值 |
| 路由 |
POST https://skill.amemo.cn/save-memo |
| Bean |
MemoBean |
| Content-Type |
application/json |
请求参数
⚠️ 服务端要求所有字段必须存在。userToken、memoTitle、memoContent 必填且有值，memoId 可选但字段必须存在。
| 参数 |
类型 |
必填 |
说明 |
userToken |
str |
✅ |
用户登录凭证 |
memoId |
str |
— |
备忘录 ID（新建传 null，更新时传入已有 ID） |
memoTitle |
str |
✅ |
备忘录标题（不能为空） |
memoContent |
str |
✅ |
备忘录内容（不能为空） |
请求示例
# 新建备忘录
curl -X POST https://skill.amemo.cn/save-memo \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"memoId": null,
"memoTitle": "开会记录",
"memoContent": "讨论了Q2计划"
}'
# 更新备忘录（传入已有 memoId）
curl -X POST https://skill.amemo.cn/save-memo \
-H "Content-Type: application/json" \
-d '{
"userToken": "<token>",
"memoId": "123456",
"memoTitle": "开会记录",
"memoContent": "更新了内容"
}'
响应解析
| 字段 |
说明 |
data.memoId |
保存成功后返回的备忘录 ID，必须提取并保存到当前对话上下文 lastMemoId |
执行流程
1. 识别触发词 → 检查 userToken
↓
2. 提取对话内容（去除触发词后的 userContent + aiContent）
↓
3. 判断新建还是更新（见下方规则）
↓
4. 整理笔记内容 → 生成 memoTitle
↓
5. 调用 POST /save-memo 接口
↓
6. 保存 memoId 到 lastMemoId → 返回结果
新建 vs 更新模式判断
lastMemoId 是否存在？
├── 不存在 → 【新建模式】memoId = null
└── 存在 → 意图判断：
├── 更新信号词 → 【更新模式】memoId = lastMemoId
├── 新建信号词 → 【新建模式】清除 lastMemoId
├── 主题明显不同 → 【新建模式】清除 lastMemoId
└── 模糊场景 → 询问用户确认
信号词对照
| 类型 |
信号词 |
| 更新 |
补充、加上、修改、更新、还有、另外、补充说明、遗漏、忘了、换成、改成 |
| 新建 |
新笔记、另一个、主题明显不同 |
模糊场景处理
🤔 您是想：
• 更新刚才的笔记「{lastMemoTitle}」
• 还是保存为一条新笔记？
内容整理
| 模式 |
memoContent 格式 |
| 新建 |
"{userContent}\n\n【AI】\n{aiContent}" |
| 更新 |
"{修改后的完整内容}"（直接替换原文） |
标题生成规则
- 提取用户消息中最核心的名词/动词
- 限制在 20 字以内
- 去除助词、语气词、疑问词
- 更新模式下保留
lastMemoTitle
| 用户输入 |
生成标题 |
"感冒了应该吃什么药" |
"感冒用药建议" |
"帮我记一下今天开会的内容" |
"今日开会记录" |
回复模板
| 场景 |
模板 |
| 新建成功 |
✅ 已保存笔记：「{memoTitle}」 |
| 更新成功 |
✅ 已更新笔记：「{memoTitle}」（内容已替换） |
| 失败 |
❌ 保存失败，请重试 |
通用错误处理见主 SKILL.md「错误处理」章节
lockfeel