常见问题
装不上、看不到工具、记忆分裂、换电脑迁移、隐私边界、性能与卸载——按问题找答案。
装好之后 AI 里看不到小本本的工具
99% 是没有彻底重启客户端。MCP 配置只在进程启动时读取一次，关窗口不算退出。
- WorkBuddy：关主窗口后，右键任务栏托盘图标 → 退出，再重新启动；
- VS Code 系（Cursor / Windsurf / Cline）：
Ctrl+Shift+P→ Reload Window 不够，要退出整个编辑器进程； - 命令行客户端：重开终端即可。
重启后问 AI 一句”你有哪些小本本的工具”，能列出 write_memory、search_memory 等就说明通了。
WorkBuddy 还有一步容易漏：新接入的自定义连接器默认不被信任，要去「连接器 → 自定义连接器」里手动授权。
多个 AI 客户端，记忆是同一份吗
是，前提是都用默认路径 ~/.xiaobenben/memory.db。
不要在任何一个客户端里自定义库路径。一旦不一致，记忆会静默分裂成两份：每个客户端都”有记忆”，但各自只记得自己那部分，而且没有任何报错——这是最难排查的一类问题。
能改库存放位置吗
技术上可以，但不建议，理由同上。
如果确实需要（比如放在加密盘），那就在所有客户端里改成同一个新路径，包括以后新装的。
换电脑怎么迁移
- 在旧机器上退出所有 AI 客户端和
xbb serve； - 拷走
~/.xiaobenben/memory.db（连同-wal、-shm两个伴生文件，或先退出再拷单文件）； - 在新机器上装好小本本，把文件放到同样的路径；
- 拷贝向量增强包目录，省一次重新下载。
拷完在任意客户端里问一句”我们之前聊过什么”，能说出内容就成功了。
记忆会上传到服务器吗
本地版不会。它没有账号体系，也没有任何把库发出去的代码路径——连”上传”这个动作都不存在。
需要明确的是：装了云端版（绑定了组织）之后，记忆会写到云端，那时隐私边界变了，见个人云端版 · 功能说明。同一台机器上可以随时 xbb cloud off 切回纯本地。
会不会拖慢 AI 的回复
每次工具调用的本地开销是毫秒级，你不会感知到。
真正影响体感的是检索频率：每轮开口前都会查一次。库在上万条量级时，一次检索仍在百毫秒内（词法路径已做过分页缓存优化），相对于模型本身的生成时间可以忽略。
如果某天明显变慢，先看库文件是不是异常大（情景层存了大量原话），而不是怀疑检索算法。
向量增强包必须装吗
不必须。不装走纯关键词检索，日常用没问题；装了之后同义改写、口语表达也能命中，体验差别在”我换个说法它还认不认得”这一层。
macOS Intel 没有这个包（上游没有对应平台的原生库），该平台固定为关键词模式，属预期行为——不影响其它功能。
Windows 上首次运行被杀毒软件拦了
单文件程序体积 60–90MB，首次运行被实时扫描拦下是常见现象。把 ~/.xiaobenben/ 加入杀软排除目录即可。
如果只是 SmartScreen 蓝框「已保护你的电脑」，点「更多信息」→「仍要运行」。原因是程序尚未做商业代码签名，不是文件损坏。
Windows 11 24H2 上启动就退出
这是 v0.4.41 修复的已知问题。成因是 Win11 24H2 的 Windows ML 在 System32 目录预置了一份旧版 onnxruntime.dll，而小本本捆绑的版本要求更高的 API 号，两者被加载到一起时在原生层直接中止进程（不是普通异常，try/catch 拦不住）。
0.4.41 起改成按绝对路径锁住自带的那份；锁不住时安全降级为关键词检索，不再崩溃。升级即可：
xbb update
升级后需重启 AI 客户端。
记忆会不会记太多、把好的淹掉
会。这是使用方式问题，不是算法问题。
判断标准很简单：检索出来经常是废话，就是记太碎了。同一件事写了五条半句，不如合并成一条完整表述。可以告诉 AI”这类不用记”，比如临时性的口头信息、一次性的查询结果。
想删掉某条记忆
让 AI 调 forget，标记为已遗忘，检索不再返回。库里仍保留记录——这是刻意设计，为了能回答”当初记过什么、什么时候忘的”。
要彻底抹掉只能删库重来（先备份）。这一点我们不打算改：一个可以被悄悄删除的记忆库，无法证明任何事。
怎么卸载
- 退出所有 AI 客户端里的 MCP 条目（或直接删配置里的
xiaobenben段）； - 退出
xbb serve（托盘右键退出）； - 删掉
~/.xiaobenben/整个目录。
删目录等于删掉全部记忆，先备份。
支持哪些 AI 客户端
任何支持 MCP stdio 的客户端都行。已验证的清单与逐客户端配置见安装指南，包括 WorkBuddy、opencode、Claude Code、Cursor、Windsurf、Cline、Trae、豆包桌面版。
出问题了怎么反馈
右下角有反馈入口，写明你遇到的现象和版本号（xbb version）就够了。如果方便，把管理窗口里的诊断信息一起贴上。