amemo-save-mate — 保存助手记忆

接口信息

• 路由: POST https://skill.amemo.cn/save-mate
• Bean: MateBean
• Content-Type: application/json

请求参数

注意：服务端要求所有字段必须存在。

userToken

和

mateMemory

必填且有值。

参数	类型	必填	说明
userToken	str	是	用户登录凭证
mateMemory	str	是	要保存的记忆内容（不能为空）

请求示例

# 保存记忆
curl -X POST https://skill.amemo.cn/save-mate \
  -H "Content-Type: application/json" \
  -d '{"userToken": "<token>", "mateMemory": "用户喜欢 Python，常用 FastAPI 框架"}'

响应示例

{"code": 200, "desc": "success", "data": "..."}

注意事项

• userToken

  和

  mateMemory

  都必须有值，不能为空
• 与

  amemo-init-mate

  不同，此接口用于追加/更新记忆，而非重置
• 必须携带有效的 userToken

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

执行步骤

1. 识别触发词（保存永久记忆/永久记住 XXX/记住这个）
    ↓
2. 检查 userToken 是否存在
    ├── 无 token → 引导登录流程
    ↓
3. 提取记忆内容
    ├── 触发词为"永久记住 XXX" → 直接提取 XXX 作为记忆内容
    ├── 触发词为"记住这个" → 提取当前对话中用户最近说的关键信息
    └── 触发词为"保存永久记忆" → 读取 memory/MEMORY.md 文件内容
    ↓
4. 将新记忆内容追加写入 memory/MEMORY.md
    ├── 文件不存在 → 自动创建
    └── 文件存在 → 在文件末尾追加新条目
    ↓
5. 调用 POST /save-mate 接口，传入完整 MEMORY.md 内容
    ↓
6. 返回保存结果

保存触发场景

场景一：用户说"永久记住 XXX"（最常见）

用户：永久记住我喜欢喝美式咖啡
    ↓
AI 提取记忆内容：「我喜欢喝美式咖啡」
    ↓
AI 将内容写入 memory/MEMORY.md：
    - 我喜欢喝美式咖啡
    ↓
调用 /save-mate 同步到服务器
    ↓
回复用户：✅ 已记住「我喜欢喝美式咖啡」

场景二：用户说"记住这个"

用户在对话中分享了某个信息后说"记住这个"
    ↓
AI 提取上一条对话中的关键信息作为记忆内容
    ↓
写入 MEMORY.md → 同步到服务器

场景三：用户说"保存永久记忆"

用户：保存永久记忆
    ↓
AI 读取 memory/MEMORY.md 全部内容
    ↓
调用 /save-mate 同步到服务器

成功提示模板

"永久记住 XXX" 场景：

✅ 已记住：「{记忆内容}」

已同步到云端，所有设备均可读取。

"保存永久记忆" 场景：

✅ 永久记忆已保存！

已同步 {lines} 行记忆内容到云端，所有设备均可读取。

失败处理

MEMORY.md 不存在时：

⚠️ 暂无本地记忆可保存

请先：
1. 使用「刷新助手记忆」获取云端记忆
2. 或直接编辑 memory/MEMORY.md 添加内容

然后再说「保存永久记忆」

读取失败时：

⚠️ 无法读取本地记忆文件

请检查 memory/MEMORY.md 是否存在且可读。

接口调用失败时：

⚠️ 记忆保存失败

错误信息：{error_message}

请检查网络连接后重试。