> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironclaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 持久化记忆

> 代理可长期保存与检索的记忆系统

LLM 上下文窗口是临时的，会话结束后内容会消失；记忆系统是持久的，写入后可在后续任意会话中检索。

因此代理应主动写入与检索：

* 回答历史问题前先搜索记忆
* 完成任务后把结论写入记忆

> [!NOTE]
>
> 当问题涉及过往工作、历史决策或已存信息时，建议先调用 `memory_search`。

***

## 工作区结构

记忆路径采用类似文件系统的层级：

| 示例路径 | 用途 |
| - | - |
| `context/vision.md` | 项目目标与方向 |
| `context/architecture.md` | 架构与设计决策 |
| `daily/2024-01-15.md` | 每日记录 |
| `daily/standup.md` | 每日 standup 草稿 |
| `projects/ironclaw/notes.md` | 项目笔记 |
| `inbox/task-20240115.md` | 待处理输入 |
| `processed/task-20240115.md` | 已处理归档 |
| `ops/incidents/2024-01-15.md` | 运维事故记录 |
| `AGENTS.md` | 代理行为规则 |
| `SOUL.md` | 代理价值观与风格 |

路径可以按你的工作流自由设计；`memory_tree` 可查看完整树结构。

***

## 四个记忆工具

| 工具 | 说明 |
| - | - |
| `memory_search` | 混合全文+向量检索，返回排序结果 |
| `memory_write` | 写入文档到指定路径（可创建/覆盖） |
| `memory_read` | 按精确路径读取文档 |
| `memory_tree` | 列出当前工作区记忆路径树 |

***

## 向量检索

你可以将记忆持久化为向量索引，以获得更快的语义检索体验，特别适用于文档量较大的工作区。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.