八卦记忆系统#

基于文件的记忆管理框架，零依赖，适用于任何能读写本地文件的 AI Agent。

详细架构见 references/architecture.md（权威来源： memory/bagua/README.md）。

⚡ 自激活（首次触发必做）#

检测条件：如果 AGENTS.md 或 SOUL.md 中不存在 ## 记忆规则 章节，说明尚未激活。

激活步骤：

1. 运行 bash scripts/init_bagua.sh .（在 workspace 根目录，自动创建 memory/ 和 MEMORY.md）
2. 读取 references/soul-inject.md，将其内容追加到 AGENTS.md（或 SOUL.md）末尾
3. 如果 HEARTBEAT.md 存在，将 references/heartbeat-inject.md 追加进去
4. 告知用户："八卦记忆系统已激活 ✅"

核心流程#

写入记忆#

1. 新信息按归类指南判断所属卦位
2. 写入对应 memory/bagua/<卦位>/ 下的 Markdown 文件
3. 文件命名： YYYY-MM-DD.md（时间线类）或按主题命名

检索记忆（渐进式）#

1. L0：读 MEMORY.md（索引+归类指南）
2. L1：根据话题读 1-2 个相关卦位
3. L2：复杂检索时读 memory/bagua/README.md（卦变关联表）

记忆维护#

1. 归档：离卦超过 7 天 → 移入艮卦
2. 压缩：艮卦超过 30 天 → 摘要化
3. 恢复：归档记忆再次被引用 → 升回原卦位

八卦速查#

卦目录存什么边界☰ 乾qian/系统规则、行为准则-☷ 坤kun/知识库、事实相对稳定的信息☲ 离li/近期新发现只放"新东西"，不放对话总结☵ 坎kan/决策推理只记"为什么"（reason）☳ 震zhen/事件时间线只记"发生了什么"（fact）☴ 巽xun/关联网络人/项目/概念关系☶ 艮gen/归档记忆冷却中的旧记忆☱ 兑dui/用户偏好风格、习惯、情感

与 MEMORY.md 的关系#

MEMORY.md 是入口（L0），记忆本体在 memory/bagua/ 各卦位下。