Amemo Save Memo

amemo-save-memo — 保存备忘录

接口信息

请求参数

⚠️ 服务端要求所有字段必须存在。userToken、memoTitle、memoContent 必填且有值，memoId 可选但字段必须存在。

请求示例

# 新建备忘录
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"
  }
}

响应解析

注意事项

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

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

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

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

内容提取规则

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

说明：

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

新建 vs 更新模式判断

判断逻辑：

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

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

意图指向判断规则

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

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

模糊场景处理

当无法明确判断时：

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

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

笔记内容整理

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

标题生成规则

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}」（内容已替换）

失败

❌ 保存失败，请重试

对话上下文维护

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

追踪时机

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