八卦记忆系统

基于文件的记忆管理框架，零依赖，适用于任何能读写本地文件的 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. 恢复：归档记忆再次被引用 → 升回原卦位

八卦速查

与 MEMORY.md 的关系

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