自主记忆
启用后，代理会自动从过去的会话中提取持久知识，并在每个新会话中注入紧凑的摘要。随着时间推移，它会构建一个项目范围的记忆存储——包括技术决策、常用工作流、常见问题——无需手动操作即可持续传递。
默认禁用。可通过 /settings 或 config.yml 启用：
memories: enabled: true在会话开始时，如果当前项目存在记忆摘要，它会作为 Memory Guidance 块注入到系统提示中。代理会被指示：
- 将记忆视为启发式上下文——对流程和先前决策有用，但不能作为当前仓库状态的权威依据。
- 当记忆改变了计划时，引用记忆产物路径，并在执行操作前结合当前仓库的证据。
- 当仓库状态和用户指令与记忆冲突时，优先使用仓库状态和用户指令；将冲突的记忆视为过时信息。
读取记忆产物
Section titled “读取记忆产物”代理可以使用 read 工具通过 memory:// URL 直接读取记忆文件：
| URL | 内容 |
|---|---|
memory://root | 启动时注入的紧凑摘要 |
memory://root/MEMORY.md | 完整的长期记忆文档 |
memory://root/skills/<name>/SKILL.md | 生成的技能手册 |
/memory 斜杠命令
Section titled “/memory 斜杠命令”| 子命令 | 效果 |
|---|---|
view | 显示当前记忆注入的内容 |
clear / reset | 删除所有记忆数据和生成的产物 |
enqueue / rebuild | 强制在下次启动时运行整合 |
记忆通过后台管道构建，在启动时或通过斜杠命令手动触发运行。
阶段 1 — 逐会话提取： 对于自上次处理以来发生变化的每个过去会话，模型读取会话历史并提取持久信号：技术决策、约束条件、已解决的故障、常用工作流。过于新近、过于久远或当前活跃的会话会被跳过。每次提取会为该会话生成一个原始记忆块和一份简短概要。
阶段 2 — 整合： 提取完成后，第二次模型处理会读取所有逐会话的提取结果，并生成三个写入磁盘的输出：
MEMORY.md— 精心整理的长期记忆文档memory_summary.md— 在会话开始时注入的紧凑文本skills/— 可复用的过程化手册，每个位于独立的子目录中
阶段 2 使用租约机制来防止多个进程同时启动时重复运行。来自先前运行的过时技能目录会被自动清理。
所有输出在写入磁盘之前都会进行敏感信息扫描。
记忆提取和整合行为完全由 src/prompts/memories/ 中的静态提示文件驱动。
| 文件 | 用途 | 变量 |
|---|---|---|
stage_one_system.md | 逐会话提取的系统提示 | — |
stage_one_input.md | 包装会话内容的用户轮次模板 | {{thread_id}}、{{response_items_json}} |
consolidation.md | 跨会话整合的提示 | {{raw_memories}}、{{rollout_summaries}} |
read_path.md | 注入到实时会话中的记忆引导 | {{memory_summary}} |
记忆依托于模型角色系统。
| 阶段 | 角色 | 用途 |
|---|---|---|
| 阶段 1（提取） | default | 逐会话知识提取 |
| 阶段 2（整合） | smol | 跨会话综合 |
如果未配置 smol，阶段 2 会回退到 default 角色。
| 设置 | 默认值 | 描述 |
|---|---|---|
memories.enabled | false | 主开关 |
memories.maxRolloutAgeDays | 30 | 超过此天数的会话不会被处理 |
memories.minRolloutIdleHours | 12 | 最近活跃时间短于此小时数的会话会被跳过 |
memories.maxRolloutsPerStartup | 64 | 单次启动处理的会话数上限 |
memories.summaryInjectionTokenLimit | 5000 | 注入系统提示的摘要最大 token 数 |
高级用途可在配置中使用额外的调优参数（并发数、租约持续时间、token 预算）。
src/memories/index.ts— 管道编排、注入、斜杠命令处理src/memories/storage.ts— 基于 SQLite 的任务队列和线程注册src/prompts/memories/— 记忆提示模板src/internal-urls/memory-protocol.ts—memory://URL 处理器