IM直播 / 群聊功能扩展

活跃群管＋群管列表功能原型＋PRD

本方案调整为「快捷群管浮窗」：群聊天室默认于顶部置中展示群名与群人数，右上固定展示群资讯 icon；当用户在聊天室区域内上滑查看历史讯息时，方于标题栏下缘右侧展示 `快捷群管浮窗`，包含群管头像、昵称与 `私信` 按钮；用户未上滑或回到消息列表底部最新状态时，收起该浮窗；点击群资讯 icon 进入群资讯页，点击快捷群管浮窗内 `私信` 按钮后直接加好友并前往当前活跃群管的一对一聊天。群资讯页内新增群管列表模块，默认一排展示 4 个群管，依活跃发言近到远排序。用户点击群资讯内任一群管头像时，同样直接加好友并前往一对一聊天；若群管超过 4 个，则通过下方 `全部展开` 按钮继续向下展开。

入口位置 聊天室区域内上滑查看历史讯息时，于标题栏下缘右侧展示 `快捷群管浮窗`；未上滑或回到底部最新时隐藏；右上固定 `群资讯 icon`；群资讯页内新增 `群管列表` 模块。

核心页面 群聊天室、一对一聊天、群资讯列表。

排序规则 活跃群管定义为近 1 分钟发言最多的群管；同数时以最后一位发言者为主。

快捷动作 点击快捷群管浮窗内 `私信` 按钮，以及 03 内群管列表点击，统一执行 `加好友并前往一对一聊天`。

H5 原型改为 01-04 四个情境；其中 01 当前重点为“上滑查看历史讯息展示快捷群管浮窗”与“未上滑 / 回到底部最新隐藏浮窗”两种聊天室状态。
快捷群管浮窗与群资讯内群管列表并存：前者解决聊天室直达，后者解决群资料入口查看。
活跃群管计算按 1 分钟统计窗口更新，无群管发言时不刷新当前结果。

H5 原型

01 群聊天室 tab 切换 `连线稳定` / `连线不稳`；连线不稳图上补充「手势上滑查看历史讯息方展示」说明。

02 一对一聊天 维持在原本右侧位置展示，承接 01 的 `私信` 跳转结果。

03 群资讯列表 tab 切换 `默认` / `展开`；默认用当前原型，展开用群管全部展开原型。

04 一对一聊天 接续下方右侧对齐展示，维持一对一聊天结果画面。

PRD 章节

1. 需求背景

当前群聊天室顶部长期仅展示群名称，缺少可随操作状态切换的快捷群管浮窗，用户仍需先进入群资讯再层层查找。
业务希望将“查看群名”与“联系活跃群管”整合进同一顶部区域：用户上滑查看历史讯息时，快速暴露快捷群管浮窗；未上滑或回到底部最新时隐藏，避免长期占用顶部空间。
现有产品已具备群资讯页，本期重点是在不破坏现有聊天室结构的前提下，补足活跃群管识别、快捷入口、群管预览模块与直达私聊链路。
本期目标是让用户在聊天室或群资讯内，都能快速定位当前活跃群管并发起联系，同时保留顶部群名称的默认识别功能。

2. 原型交互

01：群聊天室顶部默认展示群名称，顶部中置显示 `世界杯红包收米群`，并保留群人数 `16888人`；右上持续展示 `群资讯 icon`。
02：用户上滑查看历史讯息时，于标题栏下缘右侧展示 `快捷群管浮窗`，内容为群管头像、昵称 `红豆` 与 `私信` 按钮；日期 `7月15日` 仍保留在聊天区顶部，不进入标题栏模块。
03：用户未上滑或回到消息列表底部最新状态时，收起 `快捷群管浮窗`，顶部仅保留群名称与群人数，避免长期遮挡聊天内容。
04：点击 `私信` 按钮后，直接加好友并前往当前活跃群管的一对一聊天页面。
05：群资讯页内新增 `群管列表` 模块，默认态一排展示 4 个群管头像，依活跃发言近到远排序；首位可展示 `当前活跃` 标签。
06：若群管超过 4 个，点击 `全部展开` 后切换为展开态，按每排 4 个继续向下展示；点击 `全部收起` 后恢复默认态。
07：点击群资讯内任一群管后，直接加好友并前往一对一聊天页面。

3. 字段定义	快捷群管浮窗字段群名标题：顶部置中展示，最多 20 字符（10 字中文），超出补 `...`。群人数：群名下方展示，例如 `16888人`；连线不稳时展示 `正在连结...`。群资讯 icon：固定在顶部右侧，点击进入群资讯页。触发状态：上滑查看历史讯息时，方展示快捷群管浮窗。收起状态：未上滑或回到底部最新时隐藏浮窗，保留群名与群人数。浮窗内容：群管头像、昵称 `红豆`、`私信` 按钮。日期标签：仍位于聊天区顶部，不进入标题栏模块。点击动作：点击 `私信` 后，直接加好友并进入对应群管一对一聊天页。群资料列表字段模块标题：`群管列表`。排序提示：左下展示 `依照活跃排序`。默认态：一排展示 4 个群管，依活跃发言近到远排序，置右展示。列表项：圆形头像＋群管账号名称。账号截断：中文 3 字、英文 6 字，超出显示 `...`。当前活跃：首位群管可展示 `当前活跃` 标签。展开按钮：群管超过 4 个时展示 `全部展开`。展开态：点击 `全部展开` 后，按每排 4 个向下展示全部群管。收起按钮：展开态底部展示 `全部收起`，点击后恢复默认态。内容顺延：展开态下，后续群资讯内容整体下移。点击动作：点击任一群管，直接加好友并进入一对一聊天页。
4. 权限规则	查看权限在群成员均可查看 `快捷群管浮窗`。在群成员均可查看群资讯内 `群管列表`。群管列表仅展示群管账号，不展示普通群成员。入口权限群资讯 icon：点击进入群资讯页。 `私信` 按钮：点击后判断当前活跃群管，并进入一对一聊天页。群管列表项：点击单一群管，进入对应一对一聊天页。显示规则上滑查看历史讯息：展示快捷群管浮窗。未上滑 / 底部最新：隐藏快捷群管浮窗。日期标签固定在聊天区顶部，不进入标题栏模块。动作规则自动加好友与私聊动作，依平台现有好友与私聊权限处理。一对一聊天页返回时，优先返回来源页面。来源页面不存在时，执行兜底返回。
5. 返回链路规则	页面栈采用 App 原生页栈 `push` 一对一聊天页。返回为带来源态的定向返回。不使用普通 `back` 历史回退。来源记录来自群聊天室 / 直播间：记录 `source_scene = live_room`、`source_room_id`。来自群资讯页：记录 `source_scene = group_info`、群资讯来源参数。返回目标 `live_room`：返回原直播间 / 群聊天室。 `group_info`：返回群资讯页。来源失效：统一返回 `好友列表`。 toast 文案兜底返回时提示：`原来源页面已失效，已返回好友列表`。
6. 异常场景	活跃群管计算无群管：不会发生，默认群主。群管从未发言：活跃群管为群主。发言次数相同：以最后一位发言的群管为主。更新频率：每 1 分钟统计一次；无群管发言无需更新。网络异常：异步更新，前端沿用上一次成功结果。聊天室状态上滑未达触发阈值：顶部维持群名称展示，不展示浮窗。消息置底最新：隐藏快捷群管浮窗。上滑查看历史讯息：展示快捷群管浮窗。群管列表头像缺失：展示默认头像占位。群管小于等于 4 个：不展示 `全部展开`。群管大于 4 个：点击 `全部展开` 后，每排 4 个向下展开。展开后收起：点击 `全部收起` 后恢复默认一排展示。操作异常入口点击失败：toast 提示 `操作失败，请稍后重试`。用户已被移出群：不可进入群资讯内群管列表或一对一聊天页。返回来源异常：返回 `好友列表`。

版本记录