BOOK BRAIN 是一个专为 LYGO 生态系统设计的文件系统辅助工具，旨在帮助代理（agent）建立、组织和维护一个结构清晰、可扩展的‘三脑’记忆系统。它并非人格化技能，而是一个实用指南，核心理念是将文件系统视为一个动态发展的图书馆，而非杂乱无章的杂物间。该工具适用于任何具备文件读写能力的代理，但在搭载完整 LYGO Champion 堆栈的新 OpenClaw/Clawhub Havens 上能发挥最佳效果。BOOK BRAIN 的设计原则是‘非覆盖性’，即默认情况下不会删除或重写现有数据，而是通过创建新的文件夹、索引文件和参考链接来渐进式地引入结构化思维，确保历史数据的安全。 BOOK BRAIN 所倡导的‘三脑模型’是其架构的核心思想。第一层是‘工作脑’，处理当前会话和短期任务上下文；第二层是‘图书馆脑’，即磁盘上的结构化文件系统，包括 memory、reference、brainwave 等核心目录，这是 BOOK BRAIN 重点优化的部分；第三层是‘外部脑’，指浏览器书签、Clawdhub 技能、链上凭证等外部资源，BOOK BRAIN 建议将这些作为文本文件中的链接而非内容复制来处理。这种分层设计旨在让重要信息保持简洁且易于访问，同时允许在需要时深入特定文件夹获取细节。 为了实现高效的长期检索，BOOK BRAIN 强调使用轻量级的引用机制。它反对将整个对话或大文档直接塞入单个文件（如 MEMORY.md），而是推荐将详细内容存储在具体文件中，并创建简短的 `.ref.txt` 或 `INDEX.txt` 引用存根。例如，每日日志可以存放在 `memory/2026-02-10.md` 中，并在顶部包含摘要和关键链接；对于特定主题（如 ‘bankr’），则创建子文件夹并维护一个索引文件，列出其中的文件路径、描述和日期。此外，BOOK BRAIN 还推荐建立结构化的日志系统，如每日健康状态日志、推理日志以及全局索引文件（如 `state/memory_index.json`），以支持快速检索，避免对文件树进行耗时的全量扫描。
核心功能特点
- 采用‘三脑模型’设计：工作脑（短期会话）、图书馆脑（结构化文件系统）、外部脑（外部资源链接），实现信息的分层管理。
- 非覆盖性操作原则：默认不删除或重写现有文件，优先创建新文件夹和索引，确保数据安全。
- 轻量级引用机制：使用 `.ref.txt` 和 `INDEX.txt` 文件作为内容存根，避免重复存储，便于跨文件关联。
- 结构化日志系统：支持每日健康日志、推理日志和全局索引文件，提升长期检索效率。
- 渐进式结构优化：可在混乱的文件系统中逐步添加索引和引用，引导形成良好命名和组织习惯。
适用场景
BOOK BRAIN 最适合在构建新的 OpenClaw 工作区或代理节点时使用，尤其是在你希望从零开始设计一个干净、有序的记忆与参考布局时。如果你感觉当前的 Haven 文件系统已经变得混乱不堪，需要一个重置方案但又不想丢失任何现有数据，那么 BOOK BRAIN 提供了一个理想的起点。它特别适用于那些计划进行长期项目、需要频繁回溯数月甚至更久之前信息的工作场景，因为它强大的检索和索引功能能有效解决传统‘暴力扫描’带来的性能问题。 除了全新的部署，BOOK BRAIN 也非常适合用于审计和梳理一个已有的、结构混乱的 Haven。在这种情况下，它的角色更像是一位温和的结构顾问，首先通过创建 `FILESYSTEM_MAP.txt` 来映射现有结构，然后逐步引入轻量级结构，如在关键文件夹中添加 `INDEX.txt` 文件和小型的 `.ref.txt` 引用。这种方式鼓励代理和代理所有者逐渐将日常笔记放入 `memory/`，稳定协议放入 `reference/`，平台特定知识放入 `brainwave/`，从而在不造成数据丢失的前提下，让整个知识库变得更加有序和可维护。对于那些希望将浏览器书签或链上凭证等外部资源纳入内部知识体系，但又不想破坏其独立性的用户，BOOK BRAIN 提供的链接引用方式也是一个完美的解决方案。