核心用法
Bulletproof Memory 是一套面向 AI 代理的上下文持久化协议，核心机制为 Write-Ahead Log (WAL)：用户输入具体信息时，代理必须先写入 `SESSION-STATE.md` 文件，再生成回复。协议包含四层组件：
1. SESSION-STATE.md — 结构化"热内存"，记录当前任务、即时上下文、关键文件路径，置于工作区根目录
2. WAL 协议指令 — 嵌入代理配置文件，明确"用户给细节 → 立即写入 → 再响应"的强制流程
3. 恢复协议 — 检测到 <summary> 标签、"truncated"、用户问"where were we"时，自动读取 SESSION-STATE.md 恢复状态，禁止询问用户
4. 内存刷新协议 — 按上下文使用率（50%/70%/85%）分级触发主动持久化
显著优点
- 可靠性高：触发条件绑定用户输入（外部事件），而非代理内存（内部易失），彻底解决"忘记记住"的元认知失败
- 恢复零摩擦：会话启动自动读取，压缩后无缝续接，用户无感知
- 结构化检索：SESSION-STATE.md 区分于日志式每日笔记，专用于"当前正在做什么"
- 与现有工具链兼容：配合 PARA Second Brain 形成完整记忆栈
潜在缺点与局限
- 写入延迟开销：高频交互场景下，文件 I/O 可能增加响应延迟
- 文件冲突风险：多代理并发访问同一 SESSION-STATE.md 时可能产生竞态
- 信息过载：用户输入的"具体细节"边界模糊，可能导致过度写入或关键信息遗漏
- 依赖文件系统：若运行环境限制磁盘写入（如无状态容器），协议失效
- 无版本控制：文档未提及冲突解决策略，覆盖写入可能导致历史状态丢失
适合人群
- 使用 Claude Code、Cline 等支持文件操作的 AI 编程助手的开发者
- 进行多会话长周期项目（数小时至数天）的工程师、研究员
- 对上下文连续性敏感、频繁遭遇"失忆"困扰的 AI 代理重度用户
常规风险
- 过度信任持久化：SESSION-STATE.md 损坏或误删时，代理可能基于过期信息错误续接任务
- 隐私泄露：明文存储用户敏感信息（如示例中的地理位置、社交活动），缺乏加密或访问控制建议
- 提示词注入：若用户输入包含恶意构造的"具体细节"，可能污染状态文件（文档未提及输入校验）
技术可信度评估
作者 halthelobster 为社区活跃贡献者，Hal Stack 系列技能在 AI 代理开发圈有一定采用率。方案设计源自数据库 WAL 的经典原理，工程实现简单直接。但文档缺乏形式化验证、性能基准测试或大规模用户反馈，当前版本为 1.0.0，成熟度待观察。