Hafa 社交语聊 App 拉黑功能 PRD

1. 功能背景

社交语聊 App 中，用户可能遇到骚扰、恶意邀请、私信打扰、房间冲突或不希望继续接触的用户。

拉黑功能用于让当前登录用户主动屏蔽指定用户。拉黑成功后，系统需要在房间、私信、邀请、关注关系和黑名单管理中同步生效，减少双方继续产生直接互动的机会。

2. 核心角色定义

2.1 拉黑关系

当拉黑人拉黑被拉黑人后，系统建立一条拉黑关系：

拉黑人 blocked 被拉黑人

2.2 生效原则

1. 拉黑人不再看到被拉黑人创建的房间 / Party。
2. 被拉黑人不能再向拉黑人发送私信。
3. 被拉黑人不能再向拉黑人发起房间、上麦、Party 邀请。
4. 拉黑人与被拉黑人之间的关注关系自动解除。
5. 房间内发生拉黑时，系统按拉黑人在房间内的身份处理当前房间状态。
6. 解除拉黑后，不自动恢复关注关系。

3. 功能范围

3.1 本期包含

3.2 本期不包含

4. 拉黑入口

4.1 用户资料页

入口：

用户主页 / 用户资料卡 → 更多 → 拉黑

适用场景：

1. 他人个人主页。
2. 用户资料卡。
3. 房间外展示的用户资料入口。

4.2 房间内用户资料卡

入口：

房间内点击用户头像 → 用户资料卡 → 更多 → 拉黑

适用对象：

1. 房主。
2. 麦上用户。
3. 麦下用户。
4. 房间观众。

4.3 私信会话页

入口：

私信会话页 → 右上角更多 → 拉黑

5. 拉黑确认弹窗

用户点击“拉黑”后，系统展示二次确认弹窗，避免误操作。

5.1 弹窗文案

标题：

加入黑名单

说明：

拉黑后，你将无法看到对方的房间，对方也不能再给你发消息或邀请你。你们的关注关系将自动解除。

5.2 按钮

6. 拉黑成功后的通用规则

拉黑成功后，系统需要同步执行以下规则：

7. 房间内拉黑规则

房间内拉黑需要根据拉黑人的房间身份处理当前房间状态。普通用户拉黑房间内成员时，只建立拉黑关系，不改变当前房间状态；房主拉黑房间内成员时，被拉黑人立即退出当前房间。

7.1 普通用户拉黑房间内用户

当普通用户在房间内拉黑任意房间成员时，系统只建立拉黑关系，拉黑人和被拉黑人均不退出当前房间。

7.1.1 处理结果

7.1.2 轻提示

拉黑人侧轻提示：

已加入黑名单

7.1.3 适用场景

7.2 房主拉黑房间内用户

当房主在自己的房间内拉黑某个用户时，被拉黑人立即被移出当前房间。

7.2.1 处理结果

7.2.2 轻提示

房主侧轻提示：

已拉黑并移出房间

被拉黑人侧轻提示：

你已离开当前房间

7.3 与踢出房间的区别

结论：

踢出房间 = 单次房间管理行为
普通用户拉黑用户 = 强关系屏蔽 + 后续触达限制
房主拉黑用户 = 强关系屏蔽 + 当前房间处理 + 后续触达限制

8. 私信限制规则

拉黑人拉黑被拉黑人后，私信规则如下：

8.1 被拉黑人发送失败提示

消息发送失败

8.2 拉黑人主动发送提示

你已拉黑该用户，解除拉黑后可继续发送消息

9. 邀请限制规则

拉黑人拉黑被拉黑人后，邀请规则如下：

9.1 被拉黑人邀请失败提示

邀请失败

9.2 拉黑人邀请被拉黑人提示

你已拉黑该用户，解除拉黑后可邀请

10. 关注关系处理规则

拉黑成功后，系统自动解除双方关注关系。

关注数和粉丝数按解除后的关系实时更新或准实时更新。

解除拉黑后，关注关系不自动恢复，用户需要重新手动关注。

11. 黑名单管理

11.1 入口

我的 → 设置 → 隐私设置 → 黑名单

11.2 页面内容

11.3 空状态

暂无拉黑用户

11.4 账号异常展示

12. 解除拉黑规则

拉黑人解除对被拉黑人的拉黑后，能力恢复如下：

12.1 解除拉黑确认弹窗

标题：

解除拉黑？

说明：

解除后，你可能会再次看到该用户的房间、消息和邀请。

按钮：

13. 前端交互说明

13.1 拉黑成功轻提示

13.2 拉黑失败轻提示

13.3 房间内拉黑后的页面跳转

14. 服务端接口

14.1 拉黑接口

POST /user/block

请求参数：

服务端处理逻辑：

1. 校验被拉黑人是否存在。
2. 禁止拉黑自己。
3. 已拉黑时返回已拉黑结果。
4. 创建拉黑关系。
5. 解除双方关注关系。
6. 限制私信、邀请、进入房间。
7. 如果存在 roomId，按房间身份处理当前房间状态：
   • 拉黑人是普通用户：不处理当前房间状态。
   • 拉黑人是房主：被拉黑人退出当前房间。
8. 返回拉黑结果。

返回示例：

{
  "success": true,
  "needExitRoom": true,
  "exitUserId": "user_123",
  "message": "blocked_success"
}

字段说明：

14.2 解除拉黑接口

POST /user/unblock

请求参数：

返回示例：

{
  "success": true,
  "message": "unblocked_success"
}

14.3 黑名单列表接口

GET /user/block-list

返回字段：

15. 数据结构说明

15.1 block_relation 表

15.2 follow_relation 表处理

拉黑成功后，系统删除或置为失效以下关注关系：

拉黑人关注被拉黑人
被拉黑人关注拉黑人

16. 各模块校验规则

16.1 房间列表过滤

查询房间列表时，不展示被拉黑人创建的房间 / Party。

不展示拉黑人已拉黑用户创建的房间 / Party

16.2 房间进入校验

进入房间前需要校验房主与当前登录用户之间是否存在拉黑关系。

如果当前登录用户已拉黑房主 → 不允许进入
如果房主已拉黑当前登录用户 → 不允许进入

用户提示：

无法进入该房间

16.3 私信发送校验

发送消息前需要校验发送方与接收方之间是否存在拉黑关系。

如果发送方已拉黑接收方 → 不允许发送
如果接收方已拉黑发送方 → 不允许发送

16.4 邀请发送校验

发起邀请前需要校验邀请方与被邀请方之间是否存在拉黑关系。

如果邀请方已拉黑被邀请方 → 不允许邀请
如果被邀请方已拉黑邀请方 → 不允许邀请

16.5 关注校验

存在拉黑关系时，双方不能关注对方。

用户尝试关注时，按以下文案提示：

17. 异常场景

18. 产品合规与合理性审视

18.1 合理性结论

18.2 隐私保护要求

1. 黑名单数据属于用户隐私，不对外展示。
2. 被拉黑人侧不展示“你已被拉黑”类文案。
3. 黑名单列表只展示完成解除拉黑所需的最小信息。
4. 私信、邀请、进入房间等限制必须由服务端校验，不能只依赖前端隐藏。
5. 后续如增加非 P0 治理能力，需要单独评估个人信息处理范围。

18.3 反骚扰要求

1. 拉黑后，被拉黑人不能继续通过私信、邀请、进入房间触达拉黑人。
2. 房主拉黑房间内用户后，被拉黑人不能继续停留在当前房间。
3. 普通用户在房间内拉黑别人后，只建立拉黑关系，双方留在当前房间。
4. 系统提示避免暴露拉黑关系，减少对抗和冲突。

19. 测试用例

19.1 基础拉黑

19.2 房主拉黑场景

19.3 普通用户拉黑场景

19.4 房间展示与进入

19.5 私信相关

19.6 邀请相关

19.7 关注关系

20. 验收标准

满足以下条件，功能可验收通过：

1. 用户可在资料页、私信页、房间用户卡片中拉黑对方。
2. 拉黑前有二次确认弹窗。
3. 拉黑后，拉黑人不再看到被拉黑人创建的房间 / Party。
4. 普通用户在房间内拉黑别人后，普通用户和被拉黑人均留在当前房间。
5. 房主在房间内拉黑用户后，被拉黑人立即退出当前房间。
6. 被拉黑人无法再次进入拉黑人创建或管理的房间 / Party。
7. 被拉黑人无法继续给拉黑人发私信。
8. 被拉黑人无法继续邀请拉黑人进入房间、上麦或加入 Party。
9. 拉黑成功后，双方关注关系自动解除。
10. 解除拉黑后，不自动恢复关注关系。
11. 黑名单页面可查看和解除拉黑用户。
12. 所有限制逻辑均由服务端校验，前端不可绕过。
13. 相关轻提示、弹窗、异常提示完整可用。
14. 被拉黑人侧不直接暴露拉黑关系。

21. 后续规划

由清理后的 PRD Markdown 转换生成。页面样式遵循 DESIGN.md 的极简网格背景、玻璃导航、克制阴影、lime 强调色和亮暗主题规则。