常见问题
绑定不上、两台设备不同步、额度用完、离线能不能用、本地记忆怎么搬上云——云端版的实际问题。
绑定票总是提示过期
绑定票是 60 秒内有效、只能用一次的。生成后要立刻用，中途去复制粘贴、切换窗口都容易超时。
多台设备或反复绑定，改用长期密钥：
xbb bind-key <密钥>
密钥可以绑多台设备，也用于”配置误删了想恢复”。它长期有效，所以别贴到聊天记录或截图里。
绑定成功，但 AI 还是记不住
按顺序查三件事：
xbb cloud—— 是不是真的显示”云端”？显示”本地（仅本机）“说明绑定没生效。- 客户端彻底重启了吗？ MCP 配置只在进程启动时读一次。关窗口不算退出。
- 库里有内容吗？让 AI 写一条，然后看用量页有没有涨。
顺序别反：先确认模式，再确认进程，最后才怀疑数据。
两台设备不同步
云端版的同步是”各自读写云端”，没有客户端之间的推送同步。所以：
- 设备 A 写入后，设备 B 下一次检索就能看到（因为查的就是服务端）；
- 但设备 B 已经打开的会话不会主动刷新——AI 不会突然”想起来”什么，它要在下一轮调用检索时才能拿到。
如果 A 写了、B 完全查不到，先确认两台设备绑的是同一个账号（管理窗口里能看到组织名），再看是不是其中一台还跑在本地模式。
离线还能用吗
不能完整用。 云端模式下检索在服务端跑，断网时检索会失败。
应对方式：
xbb cloud off # 切本地模式（用本机库）
xbb cloud on # 恢复
切模式需要重启 AI 客户端才生效。这也是为什么如果你经常在没有网络的场景工作，本地版更合适。
情景层为什么用不了
log_episodes / recall_episodes 在云端模式下返回”不支持”，这是设计决定而不是没做完：情景层保存的是逐字原话，是整库里敏感度最高的一层。它只存在于你的本机。
要翻原话：xbb cloud off 切回本地，本机库里的情景记录都还在。
本地已有的记忆怎么搬到云端
不会自动搬。 绑定云端之后，新写入的记忆进云，本地库仍然是本地库。
没有”一键上传”按钮是刻意的——那等于把你全部历史一次性传到服务器上，这个决定应该由你明确做出，而不是绑定账号的附带后果。
可行的迁移方式：
- 在云端模式下，让 AI 分批把本地记忆重新整理写入（适合几百条以内）；
- 或者联系我们协助迁移（量大时更合适）。
额度用完了会怎样
写入会被拦下，返回 E_QUOTA_EXCEEDED，不会静默丢数据。读取同样受限。
处理：到额度与余额充值，或等每月 1 日的额度重置。余额不足时的行为是”明确拒绝”，不是”先记着以后再扣”。
免费额度什么时候重置
每月 1 日 00:00（北京时）。不结转——这个月剩的不累积到下个月。
换账号 / 解绑
xbb unbind # 解除绑定并删除本机密钥
unbind 不可恢复（密钥删了就要重新获取）。如果只是想临时用本地：
xbb cloud off # 密钥保留，随时可以切回来
云端的记忆能删吗
可以，由你发起。需要注意两点：
forget是标记遗忘（检索不再返回），不是物理删除——这是为了保留”记过什么、何时忘的”；- 真正物理清除需要走账号侧的删除流程，且附件（如果上传过）会一并回收。
如果你在意的是”我不想让它在服务器上”，最直接的做法是解绑并把那条记忆删掉，然后切回本地模式。
检索变慢了
三个可能，按概率排序：
- 网络：云端检索要走一次请求，网络抖动会直接体现为慢。切本地模式对比一下就能区分。
- 库太大：几万条之后检索确实会慢一些，服务端有索引，但不会免费。
- 一次召回返回太多：单次召回的内容字节也计入流量，返回得多就意味着传输多。
会不会哪天变成收费才能用
现在就是免费的：每月含 1 GB 额度，用超了按量付费，不用就不花钱。没有”试用期结束”这回事，也没有到期自动续费。
要收费的那部分（超量）我们宁可说清楚单价，也不做”免费到某天突然收月费”这种事。