简介
小本本是一个本地优先的 AI 记忆库。记忆以一个文件存在你自己的电脑里，任何支持 MCP 的 AI 客户端一句话接入，跨会话、跨客户端都记得住。
它解决什么问题
AI 每次开新会话都从零开始。你上周跟它定下的方案、三个月前解释过的架构约束、反复纠正过的那几个偏好，下一次它全忘了——于是你又要重新讲一遍。
起因是模型本身没有持久记忆，而”把这些话写进提示词”只能撑到下次开窗。小本本补的是这一层：把这轮对话里值得留下的东西写进一个本地库，下次开窗时按需取回。
它是怎么工作的
小本本是挂在 AI 客户端上的一个 MCP 工具服务。你的 AI（WorkBuddy、opencode、Claude Code、Cursor、Trae 等）启动时读一次配置，把小本本拉起来作为一个 stdio 子进程；之后 AI 在对话中自己决定什么时候写入、什么时候检索。
你说话 → AI 判断「这条值得记」 → 调用 write_memory → 写入本机 memory.db
你提问 → AI 判断「得查一下」 → 调用 recall_topic / search_memory → 取回相关记忆
关键点在于：没有”上传”这一步。库是一个 SQLite 文件，默认落在 ~/.xiaobenben/memory.db（Windows 为 %USERPROFILE%\.xiaobenben\memory.db），不联网、不登录、不需要账号。
三个核心概念
记忆（memory）
一条记忆是”一句话 + 元数据”：内容、类型（事实 / 决策 / 偏好 / 约束 / 事件）、标签、时间、所属空间。它是你在未来某次对话里真正希望 AI 想起来的东西，比如”这个项目的接口一律用 camelCase”。
记忆没有覆盖语义。要改一条记忆，是用 supersede 写一条新的、把旧的标记为被取代——旧的那条仍留在库里，能查到”谁在什么时候推翻了什么”。这是刻意的：AI 的记忆一旦可以被静默改写，你就无法判断它此刻的说法是从哪来的。
情景（episode）
情景是原始对话片段的冷存档，逐个字保存，靠 log_episodes 写入。它的用途是”我想翻回当时那一段原话”，而不是”让 AI 记住结论”。情景层只在本机存在——即使你后来切到云端模式，情景也不会同步上去。
事件链（event chain）
库里每一次写入都会追加一条事件，事件带前一条的哈希。xbb verify 会把整条链重新算一遍，结果只有 chain OK 或 CHAIN BROKEN 两种。它挡不住”整条链重算一遍”的篡改（没有外部锚定），但能挡住最常见的两种损坏：文件被截断、某一行被工具误改。
你会得到什么
- 跨会话：上周讨论的方案，这周开窗直接接着聊。
- 跨客户端：opencode 里记的，WorkBuddy 里能用——只要它们指向同一个库文件。
- 可迁移：拷走
memory.db就是完整备份；换电脑把它放回同样位置即可。 - 可审计：每条记忆来源、时间、是否被取代都查得到；
xbb verify能证明没人动过库。
不会发生什么
- 不会上传你的记忆。本地版没有这个通道，也没有账号体系。
- 不会未经 AI 调用就自己写入。写入永远由一次工具调用触发。
- 不会把凭据留在库里。密钥类内容写入时会被抹成占位符，明文不落盘。