跳转到主要内容

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 上下文窗口是临时的,会话结束后内容会消失;记忆系统是持久的,写入后可在后续任意会话中检索。 因此代理应主动写入与检索:
  • 回答历史问题前先搜索记忆
  • 完成任务后把结论写入记忆
当问题涉及过往工作、历史决策或已存信息时,建议先调用 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列出当前工作区记忆路径树

向量检索

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