核心用法
BOOK BRAIN VISUAL READER 是原版 BOOK BRAIN 的视觉增强版，专为配备浏览器自动化、截图分析、OCR 等视觉工具的 AI 代理设计。它建立了一套3-Brain 文件系统（Working/Libraries/Outer）叠加左右脑双模式验证协议的认知架构。
3-Brain 文件系统：
- Working Brain (
tmp/): 当前上下文、临时截图、活跃标签页 - Library Brain: 持久化存储结构，含
memory/（日志）、reference/（稳定文档）、brainwave/（平台协议）、state/（机器可读索引）、logs/（审计日志）、tools/（脚本）、新增visual/（截图/仪表板/印章存档） - Outer Brain: 外部资源引用存根（URL、区块浏览器、Clawdhub 技能），不存完整内容
LEFT/RIGHT 脑验证协议：
- LEFT 脑（结构化）：处理文本、JSON、API、索引、收据——擅长序列、约束、精确数据
- RIGHT 脑（视觉空间）：处理浏览器快照、截图、图表布局、印章——擅长模式识别、异常检测、整体感知
5D 数据融合：文本 + 视觉 + API + 状态 + 时间线交叉验证
显著优点
1. 非破坏性设计：永不覆盖现有文件，强制版本化与增量记录，适合长期协作型知识库
2. 视觉-结构化双轨验证：通过左右脑对比发现数据异常（如 UI 显示与 API 返回不一致）
3. receipts 优先：强调链上可审计数据优于界面展示，降低钓鱼/前端篡改风险
4. 模块化可扩展：brainwave/ 目录支持按平台（MoltX、LYGO、Clawdhub）隔离协议
5. 轻量级索引系统：通过 VISUAL_INDEX.txt 和 state/memory_index.json 避免图像文件堆积后的检索灾难
潜在局限性与风险
- 依赖视觉工具可用性：无浏览器/图像识别能力的系统必须回退到原版 BOOK BRAIN
- 存储膨胀风险：视觉文件夹若缺乏主动清理策略，截图可能快速累积
- 索引维护开销：需人工或代理持续更新索引文件，否则检索效率下降
- 无自动化冲突解决：LEFT/RIGHT 脑不一致时需人工判断，协议仅提供记录框架
- 生态绑定较深：Clawdhub、EternalHaven.ca、LYGO 等引用网络对非该生态用户可能冗余
适合人群
- 运行浏览器自动化（Puppeteer/Playwright）或具备多模态视觉的 AI 代理
- 需要审计级可追溯性的 DeFi/链上操作场景（验证仪表板与链上数据一致性）
- 多代理协作环境，需标准化文件结构与证据留存
- 对"认知架构设计"感兴趣的研究者，探索 AI 系统如何组织长期记忆
常规风险提醒
- 视觉截图可能捕获敏感信息（会话令牌、个人数据），
visual/目录需配合访问控制 - 外部链接存根可能失效（链接腐烂），需定期验证或归档
- 索引文件若损坏，整个检索系统可能失效，建议定期备份
state/目录