错误码说明

怎么读

工具调用失败时响应形如：

{ "ok": false, "error": "E_KEY_INVALID" }

看码，不看文案。 码是稳定契约，文案随时可能改得更友好。

绑定阶段

码	含义	怎么办
E_KEY_INVALID	密钥/绑定票无效、已被吊销或已使用	重新生成。绑定票 60 秒单用，多机请用长期密钥
E_SESSION_INVALID	登录会话过期	重新登录账号中心
E_ACCOUNT_LOCKED	连续失败导致账号锁定	等锁定期结束，或走找回流程
E_SMS_RATE_LIMITED	验证码发送过频	等下一个时间窗
E_SMS_CODE_INVALID	验证码错误或已过期	重新获取
E_ORG_FROZEN	所属组织被冻结	联系管理员

写入阶段

码	含义	怎么办
E_VALIDATION	入参不合法：超长、格式错、必填缺失	让 AI 修参数重试。反复出现说明客户端字段拼错了
E_QUOTA_EXCEEDED	额度或余额不足	充值 或等下月 1 日重置
E_DUPLICATE_CONTENT	同内容已存在	通常无害；若确实要两条一样的内容，说明该用 supersede 表达演进
E_SPACE_FORBIDDEN	想放宽到不属于自己的空间	只能授权到自己子树内的空间，越界整笔被拒
E_NOT_MEMBER	不是该空间所属组织的成员	让管理员邀请
E_MEMBER_DISABLED	成员被禁用	联系管理员解禁

检索阶段

码	含义	怎么办
E_NOT_FOUND	按 id 找不到	无权可见也返回这个码——刻意不区分”不存在”和”你看不到”，避免泄露存在性
（无码）超时	云端检索请求超时，通常是网络	重试一次；持续出现就 xbb cloud off 临时用本地

已固定的行为差异

这三个不是错误码，但在云端模式下会以”不支持”的形式出现，避免你误以为坏了：

能力	云端模式	原因
log_episodes / recall_episodes	不支持	逐字原话永不入云
reveal_secret	不支持	云端没有保险箱，明文在写入侧已被抹掉
notify / audience	个人版组织下无对象	需要企业组织的成员与空间树

排查三条命令

xbb cloud     # 当前模式 + 绑的哪个组织（最常见的"写错地方"答案）
xbb version   # 版本号，反馈时必带
xbb verify    # 本地链是否完好

xbb verify 检的是本机库。云端模式下的记忆不在本机，它验不到——不要用它来判断云端数据是否完好。

反馈时请带上

• 错误码原文（不是截图里被截断的一行）；
• 发生时间（北京时间，精确到分钟）；
• xbb version 的输出；
• 如果是绑定问题，说明用的是绑定票还是长期密钥。

有这些基本能一次定位。缺了时间点，我们只能在日志里大海捞针。