记忆 API

管理与检索 Agent 的长期记忆。Lyncore 记忆体系为五层（L1 上下文 / L2 偏好 / L3 历史 / L4 模式 / L5 长任务），API 侧以统一的条目 CRUD + 语义检索暴露。

版本说明：记忆接口两者都提供，路径为 /api/v1/memory（注意前缀含 /v1）。

---

GET /api/v1/memory

列出记忆条目（分页）。

查询参数： page（默认 1）、page_size（默认 20）、type（按记忆类型筛选）。

---

POST /api/v1/memory

创建一条记忆。

请求：

{
  "content": "用户偏好使用中文进行对话",
  "type": "preference",
  "session_id": "conv_xxx（可选）"
}

字段	类型	必填	说明
content	string	✅	记忆内容
type	string	-	类型：preference / fact / conversation 等
session_id	string	-	关联会话 ID

---

PUT /api/v1/memory/:id

更新指定记忆条目。

---

DELETE /api/v1/memory/:id

删除指定记忆条目。

---

POST /api/v1/memory/search

语义检索记忆（向量检索，L3 历史为异步向量化）。

请求：

{
  "query": "用户偏好",
  "type": "preference",
  "limit": 5
}

字段	类型	必填	说明
query	string	✅	检索文本
type	string	-	类型筛选
limit	int	-	返回数量，默认 10，最大 50

响应：

{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "mem_abc123",
        "content": "用户偏好使用中文进行对话",
        "type": "preference",
        "score": 0.95,
        "created_at": "2026-08-05T14:00:00Z"
      }
    ],
    "total": 2
  },
  "message": "ok",
  "request_id": "req_abc123"
}

---

错误码

场景	code	message
记忆不存在	40400	记忆条目不存在
查询为空	40001	查询内容不能为空