工作智能体记忆存储位置解析

表述：本文面向开发与运维，说明 工作区「我的智能体」 的跨会话记忆 落在哪、以什么形态存、与数据库如何分工。产品侧用户说法见 docs/core-mechanisms/智能体记忆.md 与 help/product-features/agent-memory.md。

日期：2026-07-09 相关代码：backend/internal/agentmemory/、backend/internal/runtimews/

---

结论

Cadau 工作智能体的 记忆主体在文件夹，不在数据库。

产品采用 「文件优先 Workspace」 范式（见 docs/产品规格.md §3.5）：跨会话记忆以 Markdown 文件 落在磁盘；数据库只存智能体元数据、开关配置和聊天消息，不存长期记忆正文。

---

根目录在哪

由配置项 runtime_dir（环境变量 RUNTIME_DIR）决定：

配置示例（backend/mindlink.json）：

"paths": {
  "runtime_dir": "tmp/runtime"
}

每只工作智能体对应一个子目录，目录名 = 智能体 ID（user_agents.id）：

{RUNTIME_DIR}/{智能体ID}/

创建智能体时，后端调用 InitAgentRuntime 初始化该目录（backend/internal/runtimews/init_runtime.go）。

---

目录树：记忆相关文件

{RUNTIME_DIR}/{智能体ID}/
├── USER.md                          ← 用户画像（「关于你」）
├── MEMORY.md                        ← 长期记忆索引（标题 + 类型 + 一句话）
├── memory/
│   ├── entries/
│   │   ├── preference-abc12345.md   ← 长期记忆条目正文（每条一个 .md）
│   │   └── project-deadline-xyz.md
│   ├── 2026-07-09.md                ← 日笔记（按日期）
│   ├── 2026-07-08.md
│   ├── legacy-conversation-log.md   ← 旧版整段对话流水（迁移归档）
│   └── .session-surfaced/
│       └── {会话ID}.json            ← 辅助：记录本轮已注入哪些记忆（去重）

各层对应关系

常量定义见 backend/internal/agentmemory/types.go：

• EntriesSubdir = "memory/entries"
• LegacyArchiveRel = "memory/legacy-conversation-log.md"

---

写入与读取路径（实现）

长期记忆

• 索引：MEMORY.md，由 RebuildIndex 根据 memory/entries/ 下条目自动重建。
• 正文：memory/entries/{filename}.md，由 WriteEntry 写入。
• 包：backend/internal/agentmemory/store.go

日笔记

• 路径：memory/{YYYY-MM-DD}.md
• 写入：AppendDailyNote（用户「记住」选日笔记、或上下文压缩前 flush）
• 包：backend/internal/agentmemory/flush.go

用户画像

• 路径：USER.md
• 包：backend/internal/runtimews/files.go（UserFile = "USER.md"）

会话注入去重（辅助状态）

• 路径：memory/.session-surfaced/{session_id}.json
• 用途：记录上一轮已注入正文的记忆文件名，避免重复塞满上下文；不是用户可见的记忆内容。
• 包：backend/internal/agentmemory/surfaced.go

统一写入入口

工具与 REST 共用 WriteMemory（backend/internal/agentmemory/write.go）：

• layer = long_term → memory/entries/*.md
• layer = daily → memory/YYYY-MM-DD.md

对应 REST 路由（backend/internal/httpserver/router.go）：

• GET/PUT /user-agents/{id}/memory — 索引 MEMORY.md
• GET/POST/PUT/DELETE /user-agents/{id}/memory/entries[/{filename}] — 条目 CRUD
• POST /user-agents/{id}/memory/remember — 消息「记住」
• GET/POST /user-agents/{id}/memory/maintain/history|run — 本助手整理历史 / 手动整理
• GET/POST /admin/agent-memory-maintain/* — 管理端全站状态、历史、立刻整理

闲时整理审计文件：

• {RUNTIME_DIR}/.memory_maintain_status.json、.memory_maintain_history.jsonl
• {RUNTIME_DIR}/{智能体ID}/memory/.maintain/log.jsonl

工具：memory_write（可带 path 更新）、memory_delete、memory_search、memory_get。

---

数据库里有什么

PostgreSQL 不存记忆正文，只存与记忆 相关 的元数据与对话：

记忆相关开关定义于 backend/internal/runtimews/agentconfig.go：

MemoryAutoAppend  *bool  `json:"memory_auto_append,omitempty"`
MemoryAutoExtract *bool  `json:"memory_auto_extract,omitempty"`

默认策略：memory_auto_append 关闭，memory_auto_extract 开启（见 agentconfig_test.go）。

智能体概况中的 memory_bytes 由运行时扫描 MEMORY.md + memory/entries/ 体积汇总（backend/internal/store/agent_stats.go + agentmemory.TotalByteSize），不是数据库字段。

---

容易混淆的其它目录

帮助智能体（未选工作区时的产品帮助）没有上述个人记忆目录；它读部署侧 help/ 系统知识文档。

---

检索方式

当前 memory_search 工具与 REST GET .../memory/search 使用 关键词匹配（agentmemory.Search、SelectRelevant），在 memory/entries/ 与日笔记中查找；不是向量库索引。

对话每轮注入时（MemoryContextForChat / BuildContextBlock）大致包含：

1. MEMORY.md 索引（清单）
2. 与当前问题相关的少量条目全文（默认最多约 5 条）
3. 今、昨两日笔记节选

---

本机如何查看

1. 在 Web 智能体 → 我的智能体 记下智能体 ID。
2. 打开 {RUNTIME_DIR}/{智能体ID}/（本地一般为 backend/tmp/runtime/{智能体ID}/）。
3. 查看 MEMORY.md、memory/entries/、memory/YYYY-MM-DD.md 等。

若目录不存在，可能原因：

• 该智能体尚未产生任何记忆写入；
• 后端进程工作目录与 runtime_dir 配置不一致（路径为相对路径时依赖 CWD）。

---

产品边界（排查时常见）

---

相关文档