IM直播 / 群聊功能扩展

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

本方案调整为「活跃群管快捷」：在群聊天室右上角展示活跃群管头像，点击后直接加好友并前往当前活跃群管的一对一聊天； 群资讯页内新增群管列表模块，默认一排展示 5 个群管，依活跃发言近到远排序。 用户点击群资讯内任一群管头像时，同样直接加好友并前往一对一聊天；若群管超过 5 个，则通过下方 `全部展开` 按钮继续向下展开。

入口位置 聊天室右上角新增 `活跃群管快捷`；群资讯页内新增 `群管列表` 模块。
核心页面 群聊天室、一对一聊天、群资讯列表。
排序规则 活跃群管定义为近 1 分钟发言最多的群管；同数时以最后一位发言者为主。
快捷动作 01 与 03 内群管列表点击统一执行 `加好友并前往一对一聊天`。

H5 原型

01 群聊天室 / 02 一对一聊天 聊天室右上角展示活跃群管头像；点击后直接加好友并前往当前活跃群管一对一聊天。
01 群聊天室 02 一对一聊天原型
03 群资讯列表 / 04 一对一聊天 群资讯页内群管列表默认一排展示 5 个；点击单一群管后，直接加好友并前往一对一聊天。
03 群资讯列表 04 一对一聊天原型

PRD 章节

1. 需求背景

  • 当前群聊天室缺少针对“正在活跃的群管”的快捷入口，用户仍需先进入群资讯再层层查找。
  • 业务希望优先暴露真正活跃的群管，而不是静态管理员列表，从而提高用户联系群管的效率。
  • 现有产品已具备群资讯页，本期重点是补足活跃群管识别、快捷入口、群管预览模块与直达私聊链路。
  • 本期目标是让用户在聊天室或群资讯内，都能快速定位当前活跃群管并发起联系。

2. 原型交互

  • 01：群聊天室右上角展示 `活跃群管头像` 作为快捷入口。
  • 02：点击活跃群管头像后，直接加好友并前往当前活跃群管的一对一聊天页面。
  • 03：群资讯页内新增 `群管列表` 模块，默认一排展示 5 个群管头像，依活跃发言近到远排序；首位可展示 `当前活跃` 标签。
  • 04：点击群资讯内任一群管后，直接加好友并前往一对一聊天页面；若群管超过 5 个，则点击 `全部展开` 后按每排 5 个继续向下展开。
3. 字段定义 活跃群管快捷字段
1. 活跃群管头像：聊天室右上角展示当前活跃群管头像，作为快捷入口。
2. 活跃群管定义：近 1 分钟内发言次数最多的群管。
3. 点击动作：点击快捷入口后，直接加好友并进入对应群管一对一聊天页面。
4. 返回来源页：一对一聊天页返回时，按来源场景回到触发入口的原页面。

群资料列表字段
1. 群管列表：模块标题为 `群管列表`。
2. 排序提示：左下展示 `依照活跃排序`。
3. 首排展示：默认一排展示 5 个群管，依活跃发言近到远排序，置左展示。
4. 列表项头像：每个群管展示圆形头像，占位图按原型展示。
5. 列表项账号：头像下方展示群管账号名称，超出时显示前 6 字符＋`...`；中文按 3 字、英文按 6 字截断。
6. 当前活跃标签：第一位群管可展示 `当前活跃` 标签。
7. 全部展开按钮：当群管数量超过 5 个时，底部展示 `全部展开` 按钮。
8. 展开布局：点击 `全部展开` 后，按每排 5 个继续向下展开，以下群资讯内容整体顺延。
9. 点击动作：点击任一群管后，直接加好友并进入一对一聊天页面。
4. 权限规则 1. 所有在群成员均可查看 `活跃群管快捷` 与群资讯内 `群管列表` 模块。
2. 活跃群管头像点击后，优先判断当前统计窗口内是否存在活跃群管，并直接加好友进入对应一对一聊天页。
3. 群资讯内群管列表仅展示群管账号，不重复展示普通群成员。
4. 群资讯内群管列表按近 1 分钟内的群管发言次数由高到低排序，默认首排仅展示前 5 个。
5. 若发言次数相同，则以最后一位发言的群管排前。
6. 当群管数量超过 5 个时，展示 `全部展开` 按钮；点击后按每排 5 个继续展示剩余群管。
7. 群管列表点击单一群管后，直接加好友并进入对应一对一聊天页。
8. 一对一聊天页返回时，优先返回来源页面；若来源页面不存在，再执行兜底返回。
9. 自动加好友与私聊动作是否可执行，依平台现有好友与私聊权限规则处理。
5. 返回链路规则 1. 页面栈方式：采用 App 原生页栈 `push` 一对一聊天页，返回行为定义为带来源态的定向返回，不使用普通 `back` 历史回退。
2. 从哪来：用户可自群聊天室 / 直播间点击活跃群管头像进入一对一聊天页，或自群资讯页内群管列表点击单一群管进入一对一聊天页；进入时记录 `source_scene` 以及对应来源参数。
3. 回哪里：一对一聊天页点击左上角返回时，若 `source_scene = live_room` 则按 `source_room_id` 返回原直播间 / 群聊天室；若 `source_scene = group_info` 则返回群资讯页。
4. 回不去时去哪：若来源页面已关闭、不存在、当前用户无权限进入，或来源参数缺失 / 失效，则统一返回 `好友列表`。
5. toast 文案：发生兜底跳转时提示 `原来源页面已失效，已返回好友列表`。
6. 异常场景 1. 无群管：不会发生，默认群主。
2. 群管从未发言：活跃群管为群主。
3. 多群管同时发言次数相同：以最后一位发言的群管为主。
4. 更新频率：一分钟统计一次实时更新；无群管发言无需更新。
5. 网路或其他因素影响无法更新：采异步更新，前端沿用上一次成功结果。
6. 群管头像缺失：展示默认头像占位。
7. 群管数量小于等于 5 个：不展示 `全部展开` 按钮。
8. 群管数量大于 5 个：点击 `全部展开` 后，剩余群管按每排 5 个向下展开，以下群资讯内容顺延。
9. 点击活跃群管头像、群管列表项或 `全部展开` 失败：toast 提示 `操作失败，请稍后重试`。
10. 当前用户已被移出群：不可进入群资讯内群管列表或一对一聊天页。
11. 一对一聊天页返回来源页面异常（如直播间关闭 / 群资讯页失效）：返回好友列表。

7. 建议新增字段

模块 建议新增字段 说明
聊天室快捷 active_admin_id / active_admin_name / active_admin_avatar / active_admin_msg_count / active_admin_updated_at / source_scene / source_room_id / source_room_name 用于计算并展示当前活跃群管头像快捷入口，点击后直接加好友进入一对一聊天，并在返回时定向定位来源页。
群资料列表 admin_count / admin_preview_list / is_expandable / is_expanded 用于展示群资讯内群管列表模块、首排 5 个群管预览，以及 `全部展开` 按钮与展开状态。
群管列表 admin_user_id / last_speech_at / speech_count_1m / display_rank / source_group_id 用于实现近 1 分钟发言统计排序、首排前 5 名展示、`当前活跃` 标签判定，并支持点击单一群管后直接加好友进入一对一聊天。
动作执行 auto_add_friend / chat_target_id 用于执行自动加好友并进入一对一聊天的统一动作链路。