Memory Ingest

从用户指定的内容中提取信息，智能导入 Hanako 的分层记忆系统。

用途

当你有内容需要记住时——对话中的关键事实、决策记录、经验教训、行为规则、项目里程碑——memory-ingest 帮你分配合适的记忆层，不再需要手动找文件、选工具、逐层写入。

支持的目标层

层	目标文件	用途	搜索方式
pin	pinned.md	置顶记忆，始终在上下文中	每次对话自动注入
fact	facts.db	结构化的标签化事实	search_memory 标签+全文检索
lesson	experience/*.md	经验教训，按分类组织	recall_experience 按分类浏览
soul	SOUL.md	行为准则与身份原则	全局行为指导
memory	MEMORY.md	项目记忆，按章节组织	编译为 system prompt
session	SESSION-STATE.md	会话工作内存	WAL 协议即时写入

使用方法

单条模式

memory-ingest content="用户偏好简洁工具" layer="pin"
→ ✅ 写入 pinned.md

memory-ingest content="用户喜欢深色主题" layer="auto" contentType="preference"
→ ✅ 同时写入 pin + fact（自动路由）

memory-ingest content="安装前先检查环境" layer="lesson" category="工具使用"
→ ✅ 写入经验库「工具使用」

memory-ingest content="不修改编译文件" layer="soul"
→ ✅ 写入 SOUL.md

多目标写入

memory-ingest content="同时写入多层的重要事实" targets=["pin", "fact"] tags=["重要"] source="会议记录"
→ ✅ 2 条写入（pin + fact）

批量模式

memory-ingest items=[
  { content: "事实A", layer: "fact", tags: ["标签"] },
  { content: "经验", layer: "lesson", category: "工具" },
  { content: "笔记", layer: "session" },
  { content: "规则", layer: "soul" }
]
→ ✅ 4 条写入

预览模式

memory-ingest content="待确认的信息" layer="pin" preview=true
→ 📋 预览：将写入 pinned.md（实际不执行）

内容类型 → 自动路由

用 contentType 参数告诉工具内容的性质，工具自动路由到合适的层：

contentType	默认路由	典型场景
fact	fact	确认的知识点、用户信息
preference	pin, fact	用户喜好、审美偏好
decision	pin, fact, session	技术选型、架构决策
lesson	lesson	踩坑经验、正确做法
rule	soul	行为规则、安全边界
insight	fact, session	深层洞察、模式发现
note	session	临时笔记、事项记录
status	session	工作进度、状态更新
event	fact, session	重要事件、里程碑

设计原则

• 机械写入，不调 LLM：分析由调用方（Agent）完成，工具只负责写
• 幂等写入：每层有去重检查，不重复追加
• 预览安全：preview=true 时不执行任何写操作
• 兼容性：facts.db 和 experience/ 写入格式与 dream-weaver 一致，可互操作