amemo-save-memo

name	amemo-save-memo
description	当用户说「帮我记一下」「保存笔记」「记下这一条」或用陈述性语气描述某事（含"的时候/的情况/的经历"）时调用，将对话内容保存为云端笔记，支持新建与更新。

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": "更新了内容"
  }'

---

响应示例

{
  "code": 200,
  "desc": "success",
  "data": {
    "memoId": "abc123"
  }
}

响应解析

字段	类型	说明
code	int	状态码，200 表示成功
desc	str	状态描述
data.memoId	str	保存成功后返回的备忘录 ID，必须提取并保存到当前对话上下文 lastMemoId，用于后续更新操作

---

注意事项

📌 字段要求：所有字段必须存在，即使不传值也要传 null

📝 新建 vs 更新：新建时 memoId 传 null，更新时传入已有 memoId

🔐 认证要求：必须携带有效的 userToken

---

执行流程（由主模块调度）

内容提取规则

触发词去除规则： 从用户消息中移除"帮我记一下/保存笔记/记下这一条/记录笔记/保存备忘"等触发词，保留核心内容。

用户输入	userContent
"帮我记一下这家火锅店味道很不错"	"这家火锅店味道很不错"
"保存笔记：今天开会讨论了Q2计划"	"今天开会讨论了Q2计划"

说明：

• userContent：用户上一条消息去除触发词后的核心内容
• aiContent：AI 助手上一条回复（完整保留）
• 如果去除触发词后内容为空，则使用完整的用户消息作为 userContent

---

新建 vs 更新模式判断

判断逻辑：

1. 当前对话上下文中是否存在 lastMemoId？
   ├── 不存在 → 【新建模式】，跳到步骤 5
   └── 存在 → 进入意图指向判断

2. 意图指向判断（当 lastMemoId 存在时）：
   • 用户当前消息是否对刚才保存的内容提出改动要求
   • 当前消息内容是否与 lastMemoTitle 主题相关
   └── 判断结果：
       ├── 指向刚才的笔记 → 【更新模式】，携带 lastMemoId
       └── 是全新内容 → 【新建模式】，清除 lastMemoId

---

意图指向判断规则

更新类信号词（指向刚才的笔记，将修改后的内容替换原文）

信号词	示例
补充	"补充一下刚才的笔记"
加上	"再加上XXX"
修改	"修改为XXX"
更新	"更新一下笔记"
还有	"还有一点要补充"
另外	"另外还需要记录"
补充说明	"补充说明一下"
遗漏	"刚才漏了一条"
忘了	"忘了说XXX"
换成	"把XXX换成YYY"
改成	"改成XXX"

新建类信号（创建新笔记）

信号词	示例
新笔记	"保存一条新笔记"
另一个	"再记一个XXX"
主题明显不同	上一个是"旅行攻略"，现在说"做饭"

模糊场景处理

当无法明确判断时：

• 用户消息与 lastMemoTitle 主题明显不同 → 新建
• 用户消息与 lastMemoTitle 主题相关，且包含更新信号 → 更新
• 用户消息主题相关但无明确信号 → 询问用户确认

🤔 您是想：
• 更新刚才的笔记「{lastMemoTitle}」
• 还是保存为一条新笔记？

---

笔记内容整理

模式	memoContent 格式
新建模式	"{userContent}\n\n【AI】\n{aiContent}"
更新模式	"{修改后的完整内容}"

更新模式：将用户改动后的完整对话内容作为新内容，直接替换原始笔记内容

---

标题生成规则

1. 提取用户消息中最核心的名词/动词
2. 限制在 20 字以内
3. 去除：助词、语气词、疑问词
4. 更新模式下保留 lastMemoTitle

用户输入	生成标题
"感冒了应该吃什么药"	"感冒用药建议"
"帮我记一下今天开会的内容"	"今日开会记录"
"红烧肉怎么做才好吃"	"红烧肉做法"

---

执行步骤汇总

1. 识别触发词（保存笔记/记下/记录）
    ↓
2. 检查 userToken 是否存在
    ├── 无 token → 引导登录流程
    ↓
3. 提取对话内容（userContent + aiContent）
    ↓
4. 判断新建还是更新
    ├── 新建模式：memoId = null
    └── 更新模式：memoId = lastMemoId
    ↓
5. 整理笔记内容
    ↓
6. 生成 memoTitle
    ↓
7. 调用 POST /save-memo 接口
    ↓
8. 保存返回的 memoId 到当前对话上下文（lastMemoId）
    ↓
9. 返回结果

---

回复模板

新建成功

✅ 已保存笔记：「{memoTitle}」

更新成功

✅ 已更新笔记：「{memoTitle}」（内容已替换）

失败

❌ 保存失败，请重试

---

对话上下文维护

需维护的状态（当前对话期间有效）

字段	说明
lastMemoId	最近一次保存的笔记 ID
lastMemoTitle	最近一次保存的笔记标题
lastTaskId	最近一次保存的任务 ID

追踪时机

• 每次调用 amemo-save-memo 成功后，提取 memoId 并更新 lastMemoId
• 用户切换到完全不同的话题时，自动清除 lastMemoId 和 lastTaskId