清空 / 删除 / 退群别混:个人水线、共享房间与成员资格

清空 / 删除 / 退群别混:个人水线、共享房间与成员资格

Hello,我是小兔大白糖。 产品口里一句「删掉这个聊天」,后端耳里可能是三种完全不同的合同——个人看不见旧消息、双方房间拆掉、还是人走了群还在。写成这篇,给要做 IM 会话生命周期选型调研 的初中级后端同学:不是某仓库会话接口说明书,而是业界常见的作用域心智模型。

说明:字段名(如 cleared_at)与模式 A~F 是教学分析框架,不是某厂官方协议。公开聊天产品在文案上常把「清空 / 删除 / 退出」分开——此处只作行为归纳,不声称内部实现。示例为教学脱敏示意。已读水位与成员关系建模见系列文:已读回执水位、成员嵌入 vs 集合。

估计阅读时间:8 分钟


目录


为什么现在要关心

硬规则一句话:先钉作用域——个人视图、共享房间、成员资格——再谈按钮文案。

现场误伤几乎都长这样:

用户口头说常期望若实现错了
「清空聊天」我这边看不到旧消息误删全屋消息;对方也被清
「删除会话」列表里消失群被整屋删掉;或只是本地藏起来
「退出群」我走了群还在当成删群;或创建者直接 leave 留下无主群

删掉比喻后仍成立的三条硬规则:

  1. Clear = 个人水线:只改当前成员视角的可见起点;消息正文与其他成员未读不动。
  2. Delete 房间 = 共享语义:通常仅 1:1 允许「双方列表都消失」;群用 Leave / 解散,不把 Delete 当 Clear。
  3. Leave / Kick = 成员资格:改的是「还在不在群里」;创建者 leave 前要转让或走解散流程。

问题空间:三个按钮,三种合同

本篇主线是会话生命周期的作用域拆分;已读上报形状与 membership 存法交给系列文。

主题本篇是否展开相关阅读
已读水位 vs 消息 ID 列表点到为止(Clear 常与已读同落 membership)/blog/im_read_receipt_watermark_vs_ids/
成员嵌入文档 vs 独立集合点到为止(资格变更落在哪一层)/blog/im_chat_membership_embed_vs_collection/
Clear / Delete / Leave 作用域主线—
1:1 删房 vs 群退群 / 解散主线—

能力拆三层,别揉成一个「删除」接口:

能力人话代价直觉
个人可见水线(Clear)从现在起我不看旧历史写放大小;历史仍占存储;对端无感
共享房间生命周期(Delete / Dissolve)这间房还在不在1:1 可双方失效;群解散影响全员
成员资格(Leave / Kick)人还在不在这屋里权限、转让、无主群风险

心智模型:合租客厅

Clear 是你翻自己的日历;Delete 1:1 是拆两人小黑屋;Leave 是你搬走;Kick 是管家请人走;Dissolve 是整套房退租。

类比对应概念硬规则直觉
把自己房间日历翻到「今天起」Clear(个人水线)室友日历不动;客厅里的旧照片还在
两人专用小黑屋拆了Delete 1:1 房间下次再聊是新屋(新房间身份)
你搬走,客厅还在Leave只失效自己的资格
管家请某人走Kick改他人资格,需权限
整套房退租Dissolve房间关闭 + 全员资格失效

类比局限一句说清:只解释作用域与产品语义;解释不了消息存储引擎选型、已读扇出细节、推送通道——那些见已读文、成员关系文与触达相关文。 日历类比管「我从哪天起看得见」,解释不了合规取证要不要保留原文。


精确定义:作用域与常见模式

先问:这次操作改的是「我的视图」「整间房」还是「谁还在房里」?三者不能共用一个 Delete。

常见模式对比

模式作用域数据落点(教学名)适用
A. Clear(个人)仅自己membership:cleared_at、本地未读归零;历史可仍在库,查询 msg.ts > cleared_at1:1 与群都该有
B. Hide / Archive仅自己列表membership 标志,不改历史可见水线「先不看」
C. Delete 1:1 房间双方共享房间软删 + 双方 membership 失效;再聊开新房仅 1:1
D. Leave自己资格删 / 失效自己的 membership;群仍在群
E. Kick他人资格管理员移除目标 membership群 + 权限
F. Dissolve整屋房间关闭 + 全员失效群主 / 管理员

教学倾向:产品文案把 A / C / D 分词;实现上 禁止用删消息表冒充 Clear。

Clear 常与已读水线一起落在 membership 上:清完后未读归零,历史拉取从 cleared_at 之后开始——合同仍是个人视图,不是共享房间死亡。

代价先说清:

  • Clear 便宜、对端无感,但库里历史还在(存储与合规策略要另订)。
  • Delete 1:1 语义清晰,但「再聊」必须开新房,旧房 ID 不宜复活糊弄过去。
  • Leave 简单,创建者无转让直接走 → 无主群;Dissolve 影响面最大,文案与权限要配齐。

示意流程与作用域矩阵

伪流程只演示合同顺序;字段名为教学脱敏,非生产 API。

Clear 只抬个人可见水线:共享消息库与其他成员未读不动
Clear 只抬个人可见水线:共享消息库与其他成员未读不动 · 点击查看 SVG 原图
Clear(chat_id, me):
  assert member(me)
  update membership(me): cleared_at=now, unread=0
  // 不碰 messages;不碰其他 membership

Delete_1to1(chat_id, me):
  assert type==1:1 && member(me)
  soft-delete room; invalidate all memberships
  // 再发消息 → 新 room_id

Leave(group_id, me):
  assert type==group && not sole-owner-without-transfer
  remove membership(me); maybe bump member_count
1:1 Delete 拆共享房间;群 Leave 只去掉自己的成员资格
1:1 Delete 拆共享房间;群 Leave 只去掉自己的成员资格 · 点击查看 SVG 原图

作用域一眼矩阵:

操作作用域矩阵:个人视图、共享房间、成员资格三列对照
操作作用域矩阵:个人视图、共享房间、成员资格三列对照 · 点击查看 SVG 原图
操作个人视图共享房间成员资格
Clear改(水线)不动仍在
Hide / Archive列表藏不动仍在
Delete 1:1双方列表消失软删 / 关闭双方失效
Leave—房间仍在自己失效
Kick—房间仍在目标失效
Dissolve全员不可用关闭全员失效

反模式

最贵的错:用物理删 messages 冒充 Clear;其次是群上的「删除」语义漂移。

反模式为何糟更稳的拆法
Clear 物理删 messages取证没了;对端同步灾难;多端对不齐只写 membership 水线;历史策略单独订
群提供 Delete 却做成 Clear(或反过来)用户以为「全屋没了」或「只是我看不见」群文案用退出 / 解散;Clear 单独入口
创建者可 Leave 且无转让无主群:没人能管权限与解散leave 前强制转让,或走 Dissolve
客户端「删除」只藏本地服务端仍推旧房未读;换端又冒出来列表 Hide 与服务端合同对齐;真删走 C/D/F
1:1 Delete 复用群 Leave 语义「我走了」≠「两人房拆了」类型分支:1:1 → C;群 → D/E/F

选型结论

  1. PRD 用词与 API 一一对应:clear / delete / leave / kick / dissolve,禁止一个「删除」覆盖三种合同。
  2. Clear 只写 membership 水线;不要用删消息表冒充;接受「库里可能仍有历史」的存储代价。
  3. Delete 限 1:1 共享房间语义;群生命周期用 leave / kick / dissolve,不复用 1:1 delete。
  4. 客户端文案避免「删除」一词吞掉 clear:清空聊天 ≠ 删除会话 ≠ 退出群。
  5. 审计分字段:谁抬了水线、谁拆了房、谁被踢——事后才能回答「到底删了什么」。

系列导航