AutoABM

中文

English

中文

English

主题

AutoABM 记忆系统文档 ​

完整的记忆系统使用指南和实现原理文档

📚 文档目录 ​

01-usage-guide.md �?使用指南 ​

面向用户的完整使用手册，涵盖�?

  • 四种记忆类型：User（用户画像）、Feedback（行为反馈）、Project（项目动态）、Reference（外部引用）
  • 四种触发方式：自动提取、显式请求、/memory 命令、/remember 命令
  • 存储格式：YAML frontmatter + Markdown 内容
  • 管理操作：遗忘、忽略、手动编辑、禁用、自定义目录
  • 生命周期：从学习到注入，新鲜度管�?

适合人群：所�?Claude Code 用户

02-implementation.md �?实现原理 ​

面向开发者的技术深度解析，涵盖�?

  • **5 大核心模�?*：路径解析、提示词构建、记忆扫描、智能检索、自动提�?
  • 路径解析系统：优先级链、安全校验、启用条�?
  • **系统提示词注�?*：loadMemoryPrompt() �?buildMemoryLines()，MEMORY.md 截断策略
  • 自动记忆提取：分叉代理、互斥机制、工具权限、合并机�?
  • **智能检�?*：scanMemoryFiles() �?Sonnet 选择 �?新鲜度警�?
  • 代理记忆：三级作用域（user/project/local�?
  • 团队记忆同步：Pull/Push API、合并语�?
  • **完整数据�?*：从会话启动到上下文注入

适合人群：贡献者、架构师、想深入了解实现的开发�?

03-autodream.md �?AutoDream 记忆整合 ​

Claude �?做梦"机制——后台静默整合记忆的深度解析，涵盖：

  • 核心概念：像人类睡眠整理记忆一样，定期回顾多个会话整合知识
  • 五重门控：功能开�?�?时间门控(24h) �?扫描节流(10min) �?会话门控(5�? �?锁门�?
  • **四阶段流�?*：Orient（定向）�?Gather（收集）�?Consolidate（整合）�?Prune（修剪）
  • 安全限制：Bash 只读、写操作仅限记忆目录、PID 锁文件互�?
  • UI 展示：底�?"dreaming" 标签、Shift+Down 详情对话框、完成通知
  • 配置控制：settings.json 本地开�?+ GrowthBook 远程 feature flag
  • �?extractMemories 对比：白天记笔记 vs 睡觉整理笔记�?

适合人群：贡献者、架构师、对 Claude 自动化记忆管理感兴趣的开发�?

🖼�?配图说明 ​

所有配图采用深色背景（#1a1a2e�? AutoABM 橙蓝品牌色（#FF7A00）风格，�?Claude Code 官方文档一致�?

图片说明尺寸
01-memory-overview.png记忆系统概览 �?四层架构（触�?类型/存储/检索）632 KB
02-memory-types.png四种记忆类型 �?2x2 网格展示 User/Feedback/Project/Reference507 KB
03-memory-trigger.png记忆触发流程 �?从对话到存储的四种路�?474 KB
04-memory-lifecycle.png记忆生命周期 �?完整循环流程 + 新鲜度判�?1.0 MB
05-architecture-overview.png实现架构总览 �?5 个核心模�?+ 辅助模块3.5 MB
06-path-resolution.png路径解析流程 �?三层优先�?+ 安全校验1.0 MB
07-prompt-injection.png提示词注入流�?�?loadMemoryPrompt 分发逻辑1.1 MB
08-auto-extraction.png自动提取流程 �?分叉代理完整流程1.2 MB
09-memory-retrieval.png智能检索流�?�?Sonnet 选择 + 新鲜度管�?816 KB
10-agent-memory.png代理记忆作用�?�?三级嵌套结构523 KB
11-autodream-overview.pngAutoDream 概览 �?做梦机制的核心架构与人类睡眠类比777 KB
12-autodream-trigger.pngAutoDream 触发流程 �?五重门控检查链493 KB
13-autodream-phases.pngAutoDream 四阶�?�?Orient/Gather/Consolidate/Prune602 KB

🚀 快速开�? ​

用户 ​

  1. 阅读 使用指南
  2. 了解四种记忆类型和触发方�?
  3. 尝试 /memory �?/remember 命令

开发�? ​

  1. 阅读 实现原理
  2. 查看源码位置�?
    • src/memdir/paths.ts �?路径解析
    • src/memdir/memdir.ts �?提示词构�?
    • src/memdir/memoryScan.ts �?记忆扫描
    • src/memdir/findRelevantMemories.ts �?智能检�?
    • src/services/extractMemories/ �?自动提取
  3. 理解数据流和模块交互

📝 核心概念速查 ​

概念说明
MEMORY.md索引文件，始终加载到上下文（最�?200 �?/ 25KB�?
主题文件*.md 文件，包�?frontmatter + 内容
自动提取每次回复后后台运行，分叉代理分析对话
AutoDream�?24h + 5 个会话后，后台整�?去重/修剪全部记忆
*智能检�?Sonnet 模型从所有记忆中选择最�?5 个相关的
*新鲜�?�? 天无警告�?1 天附带陈旧警�?
分叉代理共享提示词缓存，限制工具权限，最�?5 turns
*三级作用�?代理记忆：user（全局�? project（项目）> local（本地）

🔗 相关资源 ​

Released under the MIT License.

Copyright 2026 AutoABM Contributors