记忆整理 - Qoder

Memory Store 中的记忆会随着使用不断积累，可能出现重复、过时或遗漏的问题。Dreams 提供异步的记忆整理能力——系统会启动一个专用 Agent，回顾近期会话，对 Memory Store 进行合并、删减和补充。

核心概念

概念	说明
Dream	一次异步记忆整理任务
输入 Memory Store	整理的数据源，不会被修改
输出 Memory Store	系统自动克隆的副本，整理结果写入此处
Dreaming Session	Dream 运行时创建的内部 Session，不会出现在普通 Session 列表中

工作流程

POST /api/v1/cloud/dreams
    ↓
克隆输入 Memory Store → 生成独立的输出副本
    ↓
创建 Dreaming Session（内置 Memory Consolidation Agent）
    ↓
Agent 执行：读取近期会话 → 合并/删除/补充记忆
    ↓
Dream 完成 → outputs 中返回整理后的 Memory Store ID

API 端点一览

方法	路径	说明
POST	`/dreams`	创建 Dream
GET	`/dreams`	列出 Dreams
GET	`/dreams/{id}`	获取 Dream 详情
POST	`/dreams/{id}/cancel`	取消运行中的 Dream
POST	`/dreams/{id}/archive`	归档已完成的 Dream

快速开始

1. 触发一次记忆整理

curl -s -X POST 'https://api.qoder.com/api/v1/cloud/dreams' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      { "type": "memory_store", "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4" }
    ]
  }'

2. 查询进度

curl -s 'https://api.qoder.com/api/v1/cloud/dreams/drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9' \
  -H "Authorization: Bearer $QODER_PAT"

3. 查看结果

Dream 完成后，outputs 字段中包含整理后的 Memory Store ID：

{
  "status": "completed",
  "outputs": [
    { "type": "memory_store", "memory_store_id": "memstore_019e86b4b10578059435632bb357c5ed", "files_touched": ["preferences.md", "project/arch.md"] }
  ]
}

可选参数

参数	说明
`model`	选择整理使用的模型：`auto`（默认）、`lite`、`ultimate`
`instructions`	自定义指令（如"重点关注 Python 项目约定"），最长 4096 字符
`inputs[].type: "sessions"`	指定重点回顾的 Session ID 列表（最多 100 个）

安全设计

Copy-on-Write：输入 Memory Store 永不被修改，所有写入发生在克隆副本上
最小权限：Dreaming Agent 仅可使用 memory、session_list、session_read 三个工具，无法执行代码或访问网络
Single-flight：每个用户同一时间只能有一个活跃 Dream（状态为 pending 或 running），重复创建返回 409

常见问题

Q: Dream 会修改我原来的 Memory Store 吗？ A: 不会。Dream 始终在克隆副本上操作，原始 Memory Store 完全不受影响。 Q: Dream 需要多长时间？ A: 通常 1-5 分钟，取决于 Memory Store 大小和需要回顾的会话数量。

​核心概念

​工作流程

​API 端点一览

​快速开始

​1. 触发一次记忆整理

​2. 查询进度

​3. 查看结果

​可选参数

​安全设计

​常见问题