错误码说明

组织与成员

码	含义	怎么办
E_NOT_MEMBER	不是该组织成员（或已被移出）	让管理员重新邀请
E_MEMBER_DISABLED	成员被禁用	管理员解禁；禁用期间无法读写
E_ORG_FROZEN	组织被冻结（试用到期或欠费）	续费即解冻，数据不会删
E_ORG_CREATE_LIMIT	达到可创建组织数量上限	联系管理员合并或申请提额
E_ORG_NAME_INVALID	组织名不合规（长度、字符）	换一个名称
E_OWNER_PROTECTED	对拥有者执行了不允许的操作	转移所有权走控制台流程，不能直接停用
E_SELF_PROTECTED	对自己执行了不允许的操作（如移除自己）	让其他管理员操作

空间与可见范围

码	含义	怎么办
E_SPACE_FORBIDDEN	想写入或放宽到不在自己子树内的空间	只能授权到自己子树内的空间；越界整笔被拒，不会部分成功
E_NOT_FOUND	按 id 找不到空间/记忆	无权可见也返回这个码——刻意不区分”不存在”与”你看不到”

邀请

码	含义	怎么办
E_INVITE_INVALID	邀请码不存在	核对链接是否被截断
E_INVITE_EXPIRED	邀请已过期	管理员重发
E_INVITE_EXHAUSTED	名额用尽	管理员加名额
E_INVITE_PHONE_NOT_ALLOWED	该手机号不在允许名单内	管理员调整名单

账号与登录

码	含义	怎么办
E_KEY_INVALID	绑定密钥/票无效或已吊销	重新生成；绑定票 60 秒单用
E_SESSION_INVALID	会话过期	重新登录账号中心
E_ACCOUNT_LOCKED	账号锁定	等锁定期或走找回
E_SMS_RATE_LIMITED / E_SMS_CODE_INVALID	验证码过频 / 错误	等下一窗口 / 重新获取

写入与数据

码	含义	怎么办
E_VALIDATION	入参不合法（超长、缺必填、格式错）	修正重试；反复出现说明字段拼错
E_DUPLICATE_CONTENT	同内容已存在	通常无害；要表达演进请用 supersede
E_PURGE_TOO_LARGE	一次清理的数据量过大	分批
E_INTERNAL	服务端内部异常	重试一次；持续出现请反馈并带上时间点

固定不支持的能力

这些不是故障，是设计边界：

能力	状态	原因
log_episodes / recall_episodes	不支持	逐字原话永不入云
reveal_secret	不支持	云端无保险箱，明文已被抹掉

排查前先拿三个事实

xbb cloud     # 当前模式 + 绑的哪个组织（"记忆写错地方"十次有九次是这个）
xbb version   # 版本号
xbb verify    # 本机库链是否完好（检不到云端数据）

再补一条组织内的判断：在 console 的空间树里，这条记忆该落在哪个空间。很多”看不到”其实是”它写在了个人空间”。

反馈时请带上

错误码原文、发生时间（北京时间，精确到分钟）、xbb version、以及涉及的成员手机号后四位与空间名。缺时间点我们只能在日志里翻。