IM直播 / 群聊功能扩展

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

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

入口位置 聊天室顶部置中展示群名；右上新增 `群资讯 icon`；群标题下方新增 `活跃群管私信功能`；群资讯页内新增 `群管列表` 模块。
核心页面 群聊天室、一对一聊天、群资讯列表。
排序规则 活跃群管定义为近 1 分钟发言最多的群管；同数时以最后一位发言者为主。
快捷动作 点击活跃群管 `私信` 按钮，以及 03 内群管列表点击，统一执行 `加好友并前往一对一聊天`。

H5 原型

01 群聊天室 / 02 一对一聊天 聊天室顶部置中显示群名；右上展示群资讯 icon，群标题下方置中展示活跃群管私信功能，点击 `私信` 后直接加好友并前往一对一聊天。
01 群聊天室 02 一对一聊天原型
03 群资讯列表 / 04 一对一聊天 群资讯页内群管列表默认一排展示 5 个；点击单一群管后，直接加好友并前往一对一聊天。
03 群资讯列表 04 一对一聊天原型

PRD 章节

1. 需求背景

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

2. 原型交互

  • 01：群聊天室顶部群名置中显示，最多展示 20 字符（10 字中文）后补 `...`；右上展示 `群资讯 icon`，群标题下方置中展示 `活跃群管私信功能`。
  • 02：点击 `群资讯 icon` 进入群资讯页；点击活跃群管 `私信` 按钮后，直接加好友并前往当前活跃群管的一对一聊天页面。
  • 03：群资讯页内新增 `群管列表` 模块，默认一排展示 5 个群管头像，依活跃发言近到远排序；首位可展示 `当前活跃` 标签。
  • 04：点击群资讯内任一群管后，直接加好友并前往一对一聊天页面；若群管超过 5 个，则点击 `全部展开` 后按每排 5 个继续向下展开。
3. 字段定义 活跃群管快捷字段
1. 群名标题：顶部置中展示群名，最多显示 20 字符（10 字中文），超出后补 `...`。
2. 群资讯 icon：位于顶部右侧，点击后进入群资讯页。
3. 活跃群管私信功能：位于群标题下方置中展示，由群管头像、昵称完整展示、`私信` 按钮组成。
4. 活跃群管定义：近 1 分钟内发言次数最多的群管。
5. 点击动作：点击 `私信` 按钮后，直接加好友并进入对应群管一对一聊天页面。
6. 返回来源页：一对一聊天页返回时，按来源场景回到触发入口的原页面。

群资料列表字段
1. 群管列表：模块标题为 `群管列表`。
2. 排序提示：左下展示 `依照活跃排序`。
3. 首排展示：默认一排展示 5 个群管，依活跃发言近到远排序，置左展示。
4. 列表项头像：每个群管展示圆形头像，占位图按原型展示。
5. 列表项账号：头像下方展示群管账号名称，超出时显示前 6 字符＋`...`；中文按 3 字、英文按 6 字截断。
6. 当前活跃标签：第一位群管可展示 `当前活跃` 标签。
7. 全部展开按钮：当群管数量超过 5 个时，底部展示 `全部展开` 按钮。
8. 展开布局：点击 `全部展开` 后，按每排 5 个继续向下展开，以下群资讯内容整体顺延。
9. 点击动作：点击任一群管后，直接加好友并进入一对一聊天页面。
4. 权限规则 1. 所有在群成员均可查看 `活跃群管快捷` 与群资讯内 `群管列表` 模块。
2. 群资讯 icon 点击后进入群资讯页；活跃群管 `私信` 按钮点击后，优先判断当前统计窗口内是否存在活跃群管，并直接加好友进入对应一对一聊天页。
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. 点击群资讯 icon、活跃群管 `私信` 按钮、群管列表项或 `全部展开` 失败：toast 提示 `操作失败，请稍后重试`。
10. 当前用户已被移出群：不可进入群资讯内群管列表或一对一聊天页。
11. 一对一聊天页返回来源页面异常（如直播间关闭 / 群资讯页失效）：返回好友列表。

7. 建议新增字段

模块 建议新增字段 说明
聊天室快捷 group_name / group_name_short / group_info_entry / active_admin_id / active_admin_name / active_admin_short_name / active_admin_avatar / active_admin_msg_count / active_admin_updated_at / source_scene / source_room_id / source_room_name 用于展示群名置中标题、群资讯 icon、群标题下方置中展示的活跃群管私信功能，以及点击 `私信` 后直接加好友进入一对一聊天，并在返回时定向定位来源页。
群资料列表 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 用于执行自动加好友并进入一对一聊天的统一动作链路。