IM直播 / 联络与加好友优化

联络、加好友优化 功能 原型＋PRD

1 个主 Tab 聚焦 联络 Tab 与右上 ＋ 相关加好友链路。
5 个场景 对应 01、03、04、05、07 原型。
2 个推荐池 推荐群管 / 推荐主播共用推荐与去聊天流程。
重点规则 推荐池、搜寻、返回、隐藏删除与客服入口。
推荐群管 / 推荐主播 去聊天 新对话 隐藏 / 删除

PRD 章节

1. 需求范围

  • 01：讯息列表点击右上 ＋ 展开菜单，进入搜寻、加好友、新聊天、邀请好友等入口。
  • 03：加好友 展示推荐群管 / 主播，点击 去聊天 后加好友并进入单聊。
  • 04：新聊天 支持搜寻 ID / 昵称，命中后进入一对一聊天，无结果弹窗提示。
  • 05：保留原有 邀请好友 入口，并新增讯息列表右上 ＋ 菜单路径进入我的邀请，返回回讯息列表。
  • 07：联络 Tab 有可推荐时展示顶部推荐区，下方用 全部 / 群管 / 主播 筛选好友，联系客服 直接进客服单聊。

手机端原型

01 讯息列表 / 右上＋展开菜单 讯息列表点击右上 ＋ 展开快捷菜单；菜单项进入对应页面或动作，点击页面空白处或返回时关闭菜单。
01 讯息列表右上加号展开菜单
入口规则： 右上 ＋ 为讯息列表固定入口；绿色框代表本次优化菜单，展开后保留当前列表背景，选择菜单项后依序进入搜寻、加好友、新聊天、邀请好友或联系客服。
01 页面字段定义
字段名称 定义 交互 规则说明
右上＋ 讯息列表顶部固定的新增操作入口。 点击后展开快捷菜单，再点击菜单项进入目标页面或执行动作。
  • 仅在讯息列表页展示。
  • 菜单展开不离开当前列表，保留原列表滚动位置。
快捷菜单 搜寻 / 加好友 / 新聊天 / 邀请好友 / 联系客服。 点击菜单项后进入对应页面或动作。
  • 菜单顺序与入口名称固定，避免不同端展示不一致。
  • 绿色框代表本次优化菜单；仅保留五项：搜寻、加好友、新聊天、邀请好友、联系客服。
搜寻 进入新对话页并聚焦搜寻输入框。 点击后进入 04 原型，支持 ID / 昵称搜寻。
  • 对应 04 新对话页搜寻输入框。
  • 无结果沿用 04 无结果弹窗；点击结果直接进入一对一聊天。
加好友 进入推荐群管／推荐主播的加好友页。 点击后进入 03 原型，选择卡片 去聊天 后加好友并进入单聊。
  • 对应 03 加好友推荐区原型。
  • 沿用推荐池、loading、加好友成功与返回规则。
新聊天 进入新对话默认列表页。 点击后进入 04 原型，默认展示最近联络区与全部联络人。
  • 对应 04 新对话正常态原型。
  • 未输入关键字时优先展示最近联络；点击对象直接进入一对一聊天。
邀请好友 进入我的邀请页面。 点击后进入 05 原型，执行 立即邀请。
  • 对应 05 我的邀请页面原型。
  • 左上返回回讯息列表，并保留进入前滚动位置。
联系客服 客服快捷入口。 点击后直接进入客服一对一聊天；点击聊天页返回后回到讯息列表，并保留进入前滚动位置。
  • 对应 03 原型顶部客服 icon 与客服单聊规则。
  • 客服聊天页点击返回，回到讯息列表，不回到右上菜单层。
  • 客服不可用或会话创建失败时提示连接失败，不展示客服列表。
关闭菜单 菜单外区域与返回入口。 点击页面空白处或左上返回关闭菜单；选择菜单项后直接进入目标流程。
  • 关闭菜单不改变讯息列表内容与滚动位置。
  • 重复点击右上 ＋ 切换展开／关闭状态。
03 右上＋ / 加好友 加好友页新增 推荐群管 与 推荐主播 两个精美推荐区；点击卡片 去聊天 后直接加好友并进入一对一聊天。
03 加好友推荐区
随机逻辑： 每个模块单次返回 4 个账号；先按优先级分层补满，再在当前层内随机抽样；同一模块内单批不重复，跨模块优先去重，池子不足时允许回流已展示候选。
池子定义： 推荐群管 包含 所在群组群主 / 群管 与 非所在群组群主 / 群管；推荐主播 额外纳入 当前直播主播，并保留所在群组与跨群可推荐主播。
点击流程： 点击推荐卡片 去聊天 后立即送出加好友请求；成功后建立一对一会话并自动进入聊天页，聊天页返回依来源回到原列表。
03 页面字段定义
01 点击去聊天 用户点击推荐卡片按钮。
02 按钮锁定 进入 loading，防止重复点击。
03 送出请求 带入来源、类型、目标账号。
04 建立好友 成功后建立双方好友关系。
05 创建会话 创建目标对象一对一聊天。
06 进入聊天 自动跳转一对一聊天页。
07 刷新推荐 返回前剔除该推荐账号。
字段名称 定义 交互 规则说明
推荐群管池 由所在群组群主 / 群管、非所在群组群主 / 群管组成。 进入页面时加载；点击 换一批 只刷新该模块。
  • 候选需满足 尚未加好友、允许推荐。
  • 优先顺序：所在群组群主 > 所在群组群管 > 非所在群组群主 > 非所在群组群管。
推荐主播池 由当前直播主播、所在群组主播、跨群可推荐主播组成。 进入页面时加载；点击 换一批 只刷新该模块。
  • 候选需满足 尚未加好友、允许推荐。
  • 优先顺序：当前直播主播 > 所在群组主播 > 非所在群组主播。
主播直播信息 直播信息统一放在头像区域，不占用昵称与火热程度之间的文字行。 按 直播中 / 无直播 两种状态展示头像区域信息。
  • 直播中：头像加橘色外框与 直播中 tag；赛事标签优先取绑定赛事并按 10 个字符截断。
  • 无直播：不展示外框、tag、赛事标签，昵称下方直接接火热程度，不保留直播中占位。
  • 直播 tag 读取不到时不展示；直播中未绑定赛事或解析不到时，以聊天室标题前 10 个字符兜底，中文按 5 个字截断。
  • 主播上下播状态仅在进入页面与点击 换一批 时刷新，不自动轮询。
随机抽样 先按优先层级补位，再在当前层内随机抽样。 每次进入页面或点击 换一批 后重算结果。
  • 同一模块单批不重复。
  • 跨模块优先去重，池子太小则允许重复。
  • 高优先级已入选结果不因低优先级重排。
推荐卡片 展示头像、昵称前 5 个字、火热程度。 点击 去聊天 后直接建立好友关系并进入一对一聊天。
  • 火热程度随机展示 2-5 火。
  • 卡片数目标为每区 4 位。
  • 点击后按钮进入 loading，避免重复点击。
  • 推荐主播卡片文字区固定为 头像 / 昵称 / 火热程度 / 去聊天，直播信息只放头像区域。
右上快捷 icon 顶部提供 联系客服 与 搜寻 两个快捷入口。 点击客服 icon 进入客服一对一聊天；点击搜寻 icon 聚焦输入框并执行 ID / 昵称搜寻。
  • 页面底部不再展示 查找 或 联系客服 按钮。
  • 输入为空时不执行请求，保留当前页面。
  • 点击搜寻后进入 loading，避免重复提交；无结果沿用 04 无结果弹窗。
  • 客服只有一位，直接复用或新建客服单聊；客服不可用时显示统一 toast。
推荐加好友流程 推荐群管与推荐主播共用同一套加好友后进入聊天流程。 点击 去聊天 后直接加好友，成功后进入一对一聊天。
  • 步骤 1：用户点击推荐卡片上的 去聊天。
  • 步骤 2：按钮进入 loading，当前卡片不可重复点击。
  • 步骤 3：前端送出加好友请求，并带入推荐来源、推荐类型与目标账号 ID。
  • 步骤 4：加好友成功后，系统建立双方好友关系。
  • 步骤 5：系统创建该对象的一对一聊天会话。
  • 步骤 6：前端自动进入该一对一聊天页。
  • 步骤 7：进入聊天前从当前推荐区移除该账号，避免返回后仍显示可加好友。
刷新频率 仅在进入页 1 次与手动刷新时更新。 点击 换一批 立即刷新当前模块。
  • 移除自动刷新，不因停留时长自动重算。
  • 加好友成功、群组关系变化、主播上下播后，下次进入或手动刷新时重算。
  • 不跨模块联动刷新。
换一批 / 候选不足 群管池与主播池分别计算可推荐候选，不跨池借用。 点击 换一批 时只锁定并刷新当前模块；成功后替换该模块结果。
  • 优先选取当前批次未展示、且最近未展示的合规候选；不因换批把主播补进群管区，或把群管补进主播区。
  • 同池候选总数少于 4 位时，按实际人数展示；当前批次无其他候选但仍有历史候选时，按「最久未展示」顺序回流，且同一批不可重复。
  • 同池没有可替换候选时，保留当前结果并禁用 换一批，提示 暂无更多推荐；不会清空已有卡片。
  • 单池为空时只隐藏该模块；两池都为空时隐藏整段推荐区。请求失败保留旧结果并恢复按钮，可再次重试。
不足 4 位 / 空池 按实际人数展示，不补假卡。 不足 4 位时仍展示模块；无可推荐时隐藏整个推荐区块。
  • 仅 1-3 位时按实际人数展示，不补假卡；回流与无可替换候选处理见 换一批 / 候选不足。
  • 群管区与主播区各自独立判断；某一区块无可推荐时，仅隐藏该区块。
  • 若两个区块都无可推荐，则整段推荐区不展示。
剔除与异常 不符合资格的账号即时移出推荐池。 操作失败时保留原卡片并异步重试。
  • 剔除对象：已加好友、已删除、已拉黑、本人、被系统禁推、不可推荐账号。
  • 网络不稳时 toast：网络不稳，操作未同步，请稍后重试。
04 右上＋ / 新对话 04 场景左右并排展示正常新对话页与搜寻无结果弹窗；绿色框标示本次新增的最近联络区需求。
04 新对话与最近联络区新增需求
04 新对话无结果弹窗
最近联络区： 新对话未输入关键字时优先展示最近联络；绿色框为本次新增需求标识，点击任一项直接进入一对一聊天。
搜寻规则： 支持 精确 ID 命中优先、昵称前缀命中次之、昵称包含命中最后；点击任一搜寻结果或联络列表项后直接进入一对一聊天。
无结果提示： 搜寻无命中时展示截图所示弹窗 不存在此ID號的資訊，您可能輸錯了吧！；点击 确定 关闭弹窗并保留输入内容。
04 页面字段定义
字段名称 定义 交互 规则说明
搜寻范围 好友 ID、好友昵称。 输入关键字后直接触发搜寻。
  • 不搜陌生人。
  • 仅命中可聊天对象。
命中优先级 ID 完全相同 > 昵称开头相同 > 昵称包含关键字 按优先级逐层匹配，前一层命中后不再进入下一层。
  • 同层多笔时按最近联系时间倒序。
  • 仍相同再按昵称排序。
默认列表 展示最近联络与全部联络人分组。 未输入关键字时展示默认列表态。
  • 右侧索引仅默认列表态展示。
  • 最近联络为空时只展示全部联络人。
最近联络区 新对话页顶部优先展示的最近联系对象区域，最多展示 5 笔。 点击最近联络项直接进入对应的一对一聊天；超过 5 笔时按最近联系时间倒序取前 5 笔。
  • 未输入关键字时展示；输入搜寻内容后切换为搜寻结果。
  • 最多展示 5 笔，按最近联系时间倒序；不足 5 笔按实际人数展示。
  • 区域为空时隐藏区块，不补假资料，直接展示全部联络人。
  • 本次新增需求以绿色框标识，框线不作为可点击控件。
结果点击 点击搜寻结果、最近联络项或联络列表项。 点击后直接进入一对一聊天。
  • 不增加二次确认。
  • 不先回到列表页。
无结果弹窗 文案固定为 不存在此ID號的資訊，您可能輸錯了吧！。 搜寻无命中时弹出；点击 确定 后关闭。
  • 保留当前输入内容。
  • 不保留旧结果列表。
异常处理 搜寻或进入聊天失败时保留当前状态。 前端保留输入与结果态，后台异步补同步。
  • toast：网络不稳，操作未同步，请稍后重试。
05 邀请好友 / 原有入口＋右上菜单路径 保留原有 邀请好友 功能，并新增讯息列表右上 ＋ 菜单进入 我的邀请；两条路径共用同一页面、主按钮与返回规则。
05 邀请好友
原有路径： 从既有 邀请好友 入口进入 我的邀请 页面，继续沿用现有邀请动作链路。
新增路径： 讯息列表点击右上 ＋ → 邀请好友 → 我的邀请；不在当前列表页弹窗承载，两条路径共用同一页面。
返回目标： 从 我的邀请 左上返回时，固定返回发起入口的 讯息列表，并保留滚动位置。
05 页面字段定义
字段名称 定义 交互 规则说明
入口路径 原有 邀请好友 入口与新增的讯息列表右上 ＋ 菜单路径。 两条路径均进入 05 我的邀请 原型。
  • 保留原有功能与原有入口。
  • 新增路径为：讯息列表 → 右上 ＋ → 邀请好友。
  • 两条路径共用 立即邀请、返回与异常处理规则。
页面标题 我的邀请 进入页面后顶部固定展示。
  • 不复用弹窗承载。
主按钮 立即邀请 点击后进入现有邀请动作链路。
  • 不新增新业务流。
统计字段 累计邀请人数、邀请奖励。 进入页面时展示当前统计数据。
  • 字段展示沿用现有邀请体系。
返回行为 固定返回讯息列表原入口。 点击左上返回执行回跳。
  • 保留进入前分组与滚动位置。
07 联络 Tab / 推荐区 + 隐藏删除 联络页顶部新增与加好友页一致的 推荐群管 / 推荐主播 模块；点击推荐卡片 去聊天 后直接进入一对一聊天，返回回联络列表。
07 联络 Tab 推荐区与隐藏删除
推荐逻辑： 联络页推荐区与加好友页完全共用推荐池、优先级、随机抽样、刷新频率、直播状态与空池策略；绿色框标示本次新增的 推荐群管 与 推荐主播 模块；推荐群管 小字固定为 快去聊聊讨红包，有可推荐时固定展示在列表顶部，不因下方筛选切换而消失。
操作说明： 左滑联系人行露出 隐藏 与 删除；隐藏 仅隐藏当前用户本地展示，不影响好友关系与历史聊天；删除 解除联络关系，并同步清出联络相关默认列表。
推荐加好友： 联络页推荐卡片点击 去聊天 后不再停留确认页；成功后直接进入一对一聊天，聊天页点击返回固定回到联络列表并刷新推荐区。
联络分组： 下方分段固定为 全部 / 群管 / 主播，用于筛选已建立联络关系的好友列表；联系客服 为独立快捷按钮，不属于筛选项，点击直接进入客服一对一聊天。
07-1 联络 Tab / 上滑固定分类区 列表上滑后，分类区固定在主 Tab 下方；推荐区离开视口，分类仍可直接切换。
07-1 联络 Tab 上滑固定分类区
固定规则： 绿色框标示本次新增的分类区与隐藏／删除操作行；上滑超过推荐区底部后，全部 / 群管 / 主播 / 客服 分类区固定在主 Tab 下方；下滑回到原位置后恢复自然流位置。
07 页面字段定义
01 点击去聊天 点击联络页推荐卡片。
02 建立关系 送出请求并建立好友。
03 进入聊天 成功后自动进单聊。
04 返回刷新 返回联络并剔除已加账号。
字段名称 定义 交互 规则说明
推荐区 有可推荐账号时展示 推荐群管 与 推荐主播 模块。 展示位置固定在列表顶部，不随下方筛选切换隐藏。
  • 与 03 加好友页共用推荐池、优先级与空池策略。
  • 推荐群管 标题旁小字固定展示 快去聊聊讨红包。
  • 推荐主播 标题旁小字沿用 精彩主播抢看。
  • 绿色框标示本次新增需求；某一推荐池完全无可推荐时隐藏该模块，两个池都为空时隐藏整个推荐区。
推荐卡片 展示头像、昵称前 5 个字、火热程度；直播信息只放头像区域。 点击 去聊天 后加好友并进入一对一聊天。
  • 火热程度随机 2-5 火。
  • 直播主播头像使用橘色外框、直播中 tag 与头像下缘赛事标签。
  • 未直播主播不展示外框、tag、赛事标签，昵称下方直接接火热程度。
  • 成功后从推荐区移除该账号；返回联络页时刷新列表。
固定分类区 全部 / 群管 / 主播 / 客服 分段控制项。 列表上滑后固定在主 Tab 下方，点击后筛选下方联络列表。
  • 默认选中 全部。
  • 绿色框标示上滑后固定的分类区；固定时不遮挡主 Tab、返回入口与右上操作入口。
  • 推荐区不因分类区固定而重复展示或重新加载。
  • 下滑回到原分类位置后解除固定。
联络筛选 筛选项为 全部 / 群管 / 主播，旁边保留 联系客服 快捷入口。 全部 / 群管 / 主播 只筛选下方好友联络列表；联系客服 不参与筛选。
  • 默认选中 全部。
  • 全部 展示所有已建立联络关系的好友。
  • 群管 仅展示已成为好友的群主 / 群管账号。
  • 主播 仅展示已成为好友的主播账号。
  • 联系客服 不展示列表，直接进入客服单聊。
联系客服 客服快捷入口，不作为多人联络列表展示。 点击 联系客服 后不筛选列表，直接联系并进入客服一对一聊天。
  • 当前仅一位客服，不展示客服列表或空态。
  • 已有客服会话则复用；没有则新建。
  • 客服入口请求失败时，toast 提示 客服连接失败，请稍后重试。
隐藏 / 删除 左滑联系人行展示 隐藏 与 删除。 隐藏仅移出当前用户列表；删除解除联络关系。
  • 绿色框标示本次新增的隐藏／删除操作行；隐藏不删除历史聊天，不影响搜寻命中。
  • 删除后同步移出联络、最近联络与推荐缓存。
异常处理 筛选、推荐、隐藏、删除或客服请求失败。 保留当前页面状态并提示。
  • 网络异常统一 toast：网络不稳，操作未同步，请稍后重试。

权限规则

权限规则 1. 推荐池排除本人、已加好友、已删除、已拉黑、被禁推账号；跨群曝光需有权限。
2. 推荐群管 / 主播候选需满足 尚未加好友 与 允许推荐。
3. 新对话 只检索当前可聊天的好友 / 联络对象，未输入时展示最近联络区。
4. 讯息列表右上 ＋ 菜单沿用既有入口权限，不因菜单展开改变列表权限。
5. 联系客服 为单一客服快捷入口，不展示客服列表或空态。
返回链路规则 1. 从原有 邀请好友 入口或讯息列表右上 ＋ 菜单进入 我的邀请 后，返回回讯息列表并保留滚动位置。
2. 从右上 ＋ 菜单进入 加好友 / 新对话，或从推荐卡片进入单聊，返回优先回到来源页。
3. 从联络页推荐或 联系客服 进入单聊，返回回联络页并保留原筛选。
异常场景
共通请求状态
  • 断网／超时／同步失败：保留当前页面与输入，停止当前请求并提示 网络不稳，操作未同步，请稍后重试。
  • loading：右上 ＋、菜单项、去聊天、搜寻、隐藏、删除与客服入口进入 loading 后锁定，避免重复提交；失败后恢复可操作。
  • 读取不到：菜单或列表数据读取失败时不展示假资料，保留已读内容并提供重试入口。
01 讯息列表／右上菜单
  • 讯息列表为空时仍保留右上 ＋；菜单可正常展开，选择入口后进入对应流程。
  • 菜单读取失败时不展开残缺菜单；点击空白处或返回关闭菜单，不改变列表内容与滚动位置。
03 加好友
  • 推荐池不足 4 位按实际人数展示；完全无可推荐时隐藏对应区块，不能补假卡。
  • 推荐对象已加好友、已删除、已拉黑、本人、被禁推或权限失效时，从当前结果移除。
  • 客服 icon 读取或会话创建失败时提示客服连接失败；客服聊天页点击返回回讯息列表。
04 新对话
  • 输入为空时展示最近联络；最近联络为空时隐藏区块并展示全部联络人。
  • 格式不合法、无搜寻历史或关键字无命中时不清除输入；无命中展示 04 弹窗。
  • 搜寻结果读取失败或断网时保留输入与既有列表，不与旧结果重复叠加。
05 邀请好友
  • 原有邀请好友入口与右上 ＋ 菜单新增路径均进入同一 05 页面，不重复创建另一套页面流程。
  • 邀请统计读取失败时保留页面骨架，显示读取失败提示；主操作 loading 结束后可重试。
  • 点击返回回讯息列表并保留进入前分组与滚动位置。
07 联络／分类／直播状态
  • 推荐区为空时隐藏对应模块；分类区固定期间切换筛选、返回或刷新失败时，保留当前筛选与滚动位置。
  • 隐藏／删除失败时保留联系人行并提示；成功后同步移出联络、最近联络与推荐缓存。
  • 直播 tag 读取不到时不展示 tag；无直播时不展示外框、tag、赛事标签；赛事读取不到时以聊天室标题前 10 个字符兜底。

版本记录

版本 作者 日期 变更内容
v1.7 Tilly 2026-09-08
  • 新增 01 讯息列表右上 ＋ 菜单，保留搜寻、加好友、新聊天、邀请好友、联系客服五项，并补充逐项交互与原型对应关系。
  • 03 页移除底部查找／联系客服按钮，改为顶部搜寻与客服 icon；客服单聊返回讯息列表。
  • 04 页新增最近联络区绿色需求框线与空状态、搜寻无结果规则。
  • 05 页保留原有邀请好友功能，并新增讯息列表右上 ＋ 菜单路径，两条路径共用同一页面与返回规则。
  • 07／07-1 页新增推荐区、分类区、隐藏／删除操作行绿色需求框线，并维持两原型并排。
  • 群管池／主播池的 换一批 按池独立处理候选不足、历史回流、按钮禁用与失败恢复；04 最近联络最多展示 5 笔。
  • 异常场景按页面分段补充空状态、断网、loading、读取失败、返回与重试规则。
v1.2 Tilly 2026-09-07 统一推荐群管、推荐主播、直播信息与推荐加好友流程；更新联络分组与客服单聊规则。