功能说明

工具面完全一致

个人云端版与本地版共用同一个客户端、同一份工具定义。你在本地版学到的调用节奏（开场取指令 → 每轮预检 → 收束写入）在云端一模一样。

完整工具清单见个人本地版 · 功能说明。这一页只讲不一样的三个地方。

差异一：检索在服务端跑

本地版的检索是进程内算的：词法三路 + 向量近邻，用 RRF 融合。

云端版把这一步搬到服务端：客户端发原句和词群，服务端在库里检索并把结果送回来。好处是本机不需要向量模型（省 25MB 下载与常驻内存），坏处是必须联网——离线时检索不可用。

这不是”降级”，是设计选择：记忆在云上，检索就不可能完全不碰网络。

差异二：情景层不上云

log_episodes 和 recall_episodes（逐字原话的冷存档）在云端模式下会返回”不支持”。

原因很直接：情景层保存的是对话原话，里面可能包含你随口提到的密码、身份证号、客户名单。它被设计成只在你本机存在的保险垫——一旦上云，整库的敏感面会大一个数量级。

要翻原话怎么办：xbb cloud off 切回本地模式，本地库里的情景记录都还在。

差异三：没有保险箱

reveal_secret 在云端不可用。凭据在写入侧就已被抹成占位符，服务端库里不存在明文——所以”取出来”这个动作无从谈起。

正确的凭据管理方式是密码管理器。小本本记”这个项目的密钥放在 1Password 的 XX 条目里”，不记密钥本身。

跨设备时真正有用的几个能力

按时间回看

recall_timeline 按区间取。换设备后想”接着上周那条线”，这是最快的入口——不需要记得关键词，记得大概时间就够。

按会话回看

recall_session 按会话号取。云端每次写入都带会话归属，所以”那场对话里到底定了什么”是一查即得，而不是靠回溯聊天记录。

可见范围默认只有自己

即使云端版是账号体系，每条记忆默认只有归属人可见。放宽范围是显式动作（audience），个人版场景下通常用不到——它是为企业协作准备的。

附件与提货单

记忆关联的图片/文件在云端模式下支持上云，检索时返回提货单（不含字节），要取时调 get_asset。

一个只有云端才有的状态：evicted —— 长期欠费时附件字节会被回收，记忆本身还在，描述还在，续费后重传即可。这比”整条删掉”温和，但你必须知道会发生。

模式切换的即时性

xbb cloud on/off 是进程级动作：切换后需要重启 AI 客户端才生效，因为 MCP 子进程是在客户端启动时拉起的。

如果切换后行为没变，先检查是不是旧进程还在跑。管理窗口里的模式显示是当前进程的真相，不是磁盘配置的真相。