IM直播 / v3.0 / 2026-10-10

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

需求 1：讯息右上＋

  • 新增：菜单新增「邀请好友」「联系客服」两个入口。
  • 优化：加好友页展示推荐群管、推荐主播，去聊天直接免审核加好友并进入单聊。
  • 沿用：搜寻为本地聊天记录关键字搜寻；加好友的 ID 查找与扫一扫保持既有功能。

需求 2：联络 TAB

  • 新增：顶部推荐群管、推荐主播；好友分类筛选及客服快捷入口。
  • 优化：分类区上滑吸顶；从联络进入单聊，返回保留筛选和滚动位置。
  • 沿用：星标好友置顶，星标组与非星标组内均按既有昵称字母顺序排列。

需求背景与范围

需求 1：右上＋原型

加好友、邀请好友直接在此原型内展开，不再重复陈列页面。好友、星标与消息只作本地演示；扫一扫仅示意，不调用相机。

01 讯息列表 / 右上＋展开菜单新增：邀请好友、联系客服。
优化：加好友推荐页面。
点击右上＋展开菜单；选择入口进入对应页，空白或返回关闭菜单。
  • 新增：邀请好友、联系客服；菜单顺序为搜寻／加好友／扫一扫／邀请好友／联系客服。
  • 搜寻：使用提供的搜寻聊天记录截图；输入与返回沿用已确认原型，不自行新增结果页布局。
  • 加好友：ID 成功进入个人资讯；无匹配用户时只加弹窗，推荐群管与主播保留。

需求 1：讯息右上＋

1.1 新增／优化／沿用

分类范围规则
新增邀请好友入口右上＋菜单新增入口，直接进入原有邀请好友页面。
新增联系客服入口右上＋菜单新增入口，直接进入固定客服一对一聊天。
优化加好友推荐页面保留 ID 查找和顶部客服入口；下面展示推荐群管、推荐主播。
沿用右上＋及搜寻＋原有入口不算新增；搜寻是关键字搜寻本地聊天记录，不是查找用户 ID。
沿用ID 查找／扫一扫／邀请动作加好友 ID 查找、产品扫码功能、邀请业务沿用既有实现，不新增业务流程。

1.2 菜单与入口交互

入口／动作触发与结果状态规则
右上＋点击展开菜单；再次点击关闭。初始关闭；展开保留当前讯息列表与滚动位置。
菜单顺序搜寻 / 加好友 / 扫一扫 / 邀请好友 / 联系客服顺序与名称固定；选择入口后关闭菜单并进入目标页。
搜寻进入提供截图中的「搜尋」页，输入关键字搜寻本地聊天记录。沿用原有结果与返回流程；不跳个人资讯，不与加好友 ID 查找混用。
加好友进入既有加好友页，顶部 ID 输入与客服入口保留，下方展示两组推荐。推荐规则统一见共用章节。
扫一扫产品进入既有扫码流程。文档只展示扫码示意与返回，不开启镜头、申请权限或读取二维码。
邀请好友直接展开原有邀请好友页面，不在讯息列表另做弹窗。保留原有邀请入口；标题、立即邀请动作及累计邀请／邀请奖励统计沿用原功能。
联系客服直接进入固定客服一对一聊天，已有会话复用、无会话创建。不展示客服列表；失败留在来源页面并提示客服连接失败。
关闭菜单点击菜单外空白或执行返回，只关闭菜单。不改变讯息内容或滚动位置；讯息列表为空时＋仍可使用。

1.3 加好友 ID 查找：成功与失败

  • ID 输入为空时不提交请求；非空时点击输入框右侧搜寻 icon，或沿用既有键盘提交动作。
  • 提交期间锁定当前查找动作，保留输入内容与两组推荐，避免重复请求；结束后恢复操作。
  • 成功：进入对应用户个人资讯页；个人资讯中的聊天入口沿用既有功能，不把 ID 查找自动套用推荐免审核流程。
  • 查找完成但无匹配用户：只在加好友页上叠加弹窗「不存在此ID號的資訊，您可能輸錯了吧！」，按钮为「取消」「確定」。
  • 断网或超时沿用既有网络异常处理，不展示 ID 不存在弹窗。两类失败时推荐群管、推荐主播、卡片数量、ID 输入和滚动位置均保留；弹窗的取消或确定只关闭弹窗，仍在加好友页。
  • 个人资讯返回加好友页；从个人资讯进入聊天后，先返回个人资讯，再返回加好友页。
  • 原型的 400449 成功、400 失败只是演示值，不限制产品可查找的用户 ID；客服示意对象为「客服-兮兮福利专员」，ID 400449。

1.4 加好友推荐与顶部客服

  • 两区分别为「推荐群管」「推荐主播」，各有换一批与去聊天按钮；顶部 ID 查找成功／失败不重新抽取推荐。
  • 群管卡点击去聊天进入该群管一对一聊天；主播卡点击去聊天进入该主播一对一聊天。两者均免审核直接建联。
  • 推荐去聊天的完整成功／失败状态见共用推荐章节；从讯息加好友页的推荐进入聊天后，返回讯息列表。
  • 点击加好友页顶部客服 icon 直达客服一对一聊天，返回加好友页；失败不跳页，保留 ID 与推荐。
  • 页面不再增设底部查找或联系客服按钮；文档成功／失败按钮仅用于验证情境。

需求 2：联络 TAB 原型

左侧为可操作列表，右侧为吸顶效果；人数、空状态与客服异常以画框下方按钮切换示意，不是产品入口。

05 联络 Tab / 推荐与好友筛选联络 TAB 顶部推荐，下方六个入口；前五项筛选好友，客服直达单聊。
05 联络 Tab 推荐与六个好友入口，已移除左滑操作示意区
全部星标群管主播最近客服
  • 顶部推荐与加好友页共用规则；下方筛选不影响推荐区。
  • 去聊天直接免审核加好友并进单聊；从联络 TAB 进入的聊天返回联络 TAB。
  • 名单保持星标好友置顶，两组内沿用昵称字母排序。
吸顶效果上滑后分类区吸顶，下滑回原位解除；页面不重复展示推荐区。
05-1 联络 Tab 冻结置顶示意原始截图
全部星标群管主播最近客服
  • 画框内上滑或鼠标上拖：分类区固定在主 TAB 下方。
  • 下滑回到原分类位置：解除固定，不重算推荐。

需求 2：联络 TAB

2.1 新增／优化／沿用

分类内容边界
新增顶部推荐群管与推荐主播共用加好友页的推荐池、卡片、优先级、去聊天及异常规则。
新增好友分类筛选与客服快捷入口六个入口固定排列；前五项筛选，客服是直达聊天的动作。
优化上滑吸顶与单聊返回推荐离开视口后仍可筛选；返回保留来源筛选、名单排序与滚动位置。
沿用星标、名单字母排序与好友单聊使用当前用户既有星标资料，不新增标星设置，不从昵称中的星形符号推定。

2.2 页面区域与筛选定义

  • 从上到下为主 TAB、推荐区、六个入口、可联络好友列表；默认选中全部。
  • 入口顺序固定：全部 / 星标 / 群管 / 主播 / 最近 / 客服。入口顺序与好友名单排序是两套规则。
  • 前五项只筛选下方可联络好友，不清空、不重算也不隐藏顶部有效推荐。
  • 任一好友条目点击后进入该对象的一对一聊天；返回联络 TAB，保留原筛选及滚动位置。
入口数据范围点击结果
全部当前所有可联络好友。展示对应好友列表。
星标当前用户已标星且仍可联络的好友。仅展示星标好友；取消星标不解除好友关系。
群管可联络好友中的群主／群管账号。按既有角色资料筛选，不根据昵称判断角色。
主播可联络好友中的主播账号。按既有角色资料筛选。
最近最近 10 位有实际一对一消息的可联络好友，按好友账号去重。先计算入选的 10 位，再按统一名单排序展示。
客服固定客服快捷入口，不是好友筛选。直接进入客服单聊，不改变之前选中的筛选，不展示客服列表或分组空态。

2.3 星标置顶与最近 10 位

  • 前五项先筛出当前可联络好友，再分为星标与非星标两组：星标组置顶，非星标组接在下方。
  • 两组内均按既有昵称字母升序；中文索引、数字、特殊字符位置及相同排序键的稳定次序沿用既有列表规则。
  • 最近先按最近一笔实际一对一消息时间倒序选出前 10 位好友，同一好友只计一次；时间取既有收发消息记录，不以打开会话的时间代替。
  • 最近仅纳入当前可联络好友；不计群聊、陌生人、已解除关系、已拉黑对象或没有实际消息的空会话。
  • 选出的 10 位再按星标置顶及字母排序显示；星标不能把未入选最近 10 位的对象补入结果。
  • 不足 10 位按实际人数展示；取消星标后按字母顺序回到非星标组。

2.4 上滑吸顶与空状态

  • 列表向上滑动，分类区到达主 TAB 下缘后吸顶；主 TAB 与分类区均保留可操作，不遮挡右上入口。
  • 吸顶后只滚动下方列表；下滑回原分类区位置后解除吸顶，恢复自然位置。
  • 上滑、下滑及切换筛选不重复创建推荐区，不触发自动换批；双池为空时分类区接续在主 TAB 下方。
  • 从联络页进入单聊后返回，恢复原筛选、排序规则、滚动位置及对应吸顶位置；好友资格变化时按有效资料更新名单。
  • 前五项没有可联络好友时显示「该分组暂无可联络」，保留六个入口；请求失败不能当作空名单。
  • 客服失败显示「客服连接失败，请稍后重试」，保留原筛选、名单内容、排序和滚动位置；提示消失后可重试。

共用推荐规则：加好友页与联络 TAB

3.1 推荐池与优先级

模块候选来源与优先顺序固定标题小字
推荐群管所在群组群主 > 所在群组群管 > 非所在群组群主 > 非所在群组群管快去聊聊讨红包
推荐主播当前直播主播 > 所在群组主播 > 非所在群组主播精彩主播抢着看
项目规则
资格
  • 尚未加好友且允许推荐；跨群曝光符合既有权限。
  • 排除本人、已加好友、已解除关系、已拉黑、系统禁推及不可推荐账号。
抽取
  • 每区目标 4 位：优先层级补位，同层随机抽样。
  • 按账号 ID 去重：单批不重复，跨模块优先去重；不跨角色借池。
回流
  • 先选当前批未展示、最近未展示的合规账号。
  • 不足时按业务优先级、同层最久未展示顺序回流；已加好友或失效账号不能回流。

3.2 推荐人数与分散对齐

有效候选数该模块展示对齐方式
0 位不展示该模块，含标题、换一批与卡片。另一模块独立判断；两区都为 0 时整段推荐不展示。
1 位展示 1 张实际卡片。占整行，置中。
2 位展示 2 张实际卡片。左右各占 1/2，各自在半区置中。
3 位展示 3 张实际卡片。各占 1/3，各自在等宽区域置中。
4 位展示 4 张实际卡片。各占 1/4，各自在等宽区域置中。
  • 两区人数、布局与空池独立判断，不补假卡、不复制账号凑满。
  • 原型的 0／1／2／3／4 位按钮只切换文档演示情境，不是产品配置。

3.3 推荐卡片与每日火热程度

项目展示／更新规则
卡片
  • 头像、昵称前 5 字、火热程度、去聊天。
  • 直播信息仅放在头像区，不另加昵称下方直播区。
每日火数
  • 2–5 火，每个推荐账号每天更新一次。
  • 同账号同业务日固定；加好友、联络及两个推荐池共用。
日期与刷新
  • 以账号 ID＋服务端业务日期识别当日值。
  • 进入、返回、换批、切换筛选不重新随机；跨业务日首次读取新值，不定时轮询。
读取失败
  • 可保留同业务日已读值，不使用前一日值或客户端随机数。
  • 当日没有已读值，只隐藏火数，其他卡片信息保留。

3.4 直播赛事资讯与比分轮播

美国U19 1-2 挪威U195 字符窗口 · 每 0.5 秒推进 1 字
印尼女足U17 0-0 巴西女足U175 字符窗口 · 每 0.5 秒推进 1 字
  • 首次显示前 5 字；每 0.5 秒推进 1 个字符，末尾接回开头，无额外停顿，不截断全文。
  • 中文、字母、数字、空格、连字符各计 1 个 Unicode 字符；不超过 5 字时静态显示。印尼范例共 19 字，一轮 9.5 秒。
  • 加好友与联络使用同一规则；0.5 秒仅为文字播放速度，不是比分接口轮询。示意比分非实时；后台暂停，减少动态效果偏好下静态显示。
状态头像区展示
直播中
  • 橘色外框＋直播中 tag。
  • 下缘标签：完整主队、比分、客队资讯。
资料缺失
  • 比分缺失不伪造 0-0；tag 缺失不画 tag。
  • 赛事缺失改轮播完整聊天室标题；标题也空则隐藏标签。
无直播隐藏外框、直播中 tag、赛事标签，不保留占位。

3.5 进入、换一批与刷新

触发／情境处理规则
进入／返回
  • 进入读取推荐；联络单聊返回刷新好友及推荐。
  • 个人资讯／顶部客服返回加好友：保留 ID、有效推荐、滚动位置，不重新抽样。
换一批
  • 只刷新当前模块，期间锁定该按钮；另一模块不变。
  • 成功替换；失败保留有效旧卡并恢复按钮。
无替换候选当前卡仍有效：保留结果、禁用换一批，提示「暂无更多推荐」。
空池／失败真实空池才隐藏；首次请求失败显示读取失败，不误判 0 位。
资格失效建联成功或已知失效立即剔除；完整重算与补位只在进入／手动换批。
不自动刷新
  • 停留、滚动、吸顶、筛选、ID 查找不重算推荐。
  • 群组关系、上下播与赛事在进入／换批读取；火数与文字轮播不新增自动请求。

3.6 去聊天：免审核加好友后进入单聊

步骤行为状态约束
1点击推荐卡片去聊天。记录来源页面、推荐类型及目标账号 ID。
2当前卡片进入 loading。锁定对应提交动作，防止重复点击。
3提交建联请求并重新校验账号资格。不发送待审核申请，不等待对方同意。
4确认双方好友关系已经建立。免审核直接加好友；已存在关系时复用，不重复建立。
5立即从已加载推荐结果剔除该账号。不等待会话创建、跳转或返回；加好友页与联络页共享结果失效状态。
6复用已有一对一会话，或创建对应会话。不重复创建相同双方会话。
7自动进入该群管／主播一对一聊天。不经过推荐确认页；返回目标按来源规则。
  • 好友关系未建立且卡片仍有效：失败保留卡片，恢复按钮，由用户主动重试，不自动重复提交。
  • 好友关系已建立，但会话创建或跳转失败：好友关系保留，推荐卡不恢复；用户可从好友列表重新进入聊天。
  • 断网、超时无法确认结果时先读取实际好友关系／会话状态，再决定重试；已有关系或会话复用，避免多端重复建联。
  • 多端或另一入口先完成加好友时，后到的请求以实际关系为准；页面再次进入时刷新有效资格，不新增后台轮询。

返回链路与状态保留

进入来源返回链路应保留状态
讯息右上＋ → 搜寻搜寻页返回讯息列表；结果页仍按既有搜寻流程。讯息列表滚动位置；搜寻不改好友关系。
讯息右上＋ → 加好友加好友页返回讯息列表。来源列表位置；ID 失败只关弹窗，不触发返回。
加好友 → ID 成功 → 个人资讯 → 聊天聊天 → 个人资讯 → 加好友 → 来源列表。原 ID 输入及有效推荐；个人资讯聊天沿用既有业务。
讯息加好友推荐 → 群管／主播单聊聊天直接返回讯息列表。已建立好友关系保留，推荐账号已即时剔除。
讯息右上＋ → 邀请好友／联系客服／扫一扫目标页返回讯息列表。原滚动位置；邀请动作与扫码按既有功能。
加好友页顶部客服 icon → 客服单聊客服聊天返回加好友页，不直接跳讯息列表。ID 输入、有效推荐及进入前页面位置。
联络推荐／好友条目／客服快捷入口 → 单聊聊天返回联络 TAB。原筛选、排序、滚动与吸顶位置；按新好友资格更新内容。
联络右上＋ → 搜寻／加好友／邀请好友／扫一扫／客服各目标页返回联络 TAB；个人资讯与其聊天先逐层返回加好友。联络来源筛选及滚动位置；复用对应页面，不新增另一套 UI。
联络右上＋的加好友推荐 → 单聊聊天返回联络 TAB。进入加好友前的联络筛选和滚动位置；已建联账号不恢复推荐。
既有邀请好友入口沿用该入口原有返回链路。不因新增菜单路径改变既有业务入口。

权限与同步规则

异常场景

情境处理结果保留与恢复
ID 无匹配用户弹窗「不存在此ID號的資訊，您可能輸錯了吧！」，提供取消／確定。仍在加好友页，保留 ID、两组推荐与原位置；两按钮只关弹窗。
ID 为空不发送请求。保持加好友界面，不显示不存在 ID 弹窗。
ID 请求断网／超时沿用既有查找网络异常处理，不把请求失败误判为 ID 不存在。保留输入与推荐，恢复提交动作后由用户重试。
推荐候选少于 4 位按 0／1／2／3／4 位布局规则。各模块独立，不补假卡、不跨池借用。
无其他替换候选但现有卡有效保留当前结果，禁用换一批并提示「暂无更多推荐」。不清空已有卡片；下次进入重新校验资格。
推荐读取／换批失败保留已读有效结果；没有旧结果则显示读取失败，不能当成空池。恢复按钮，用户可主动重试。
账号资格失效即时移除失效账号。只保留当前仍有效卡片，进入或手动换批时重算补位。
加好友失败，关系未建立网络异常提示「网络不稳，操作未同步，请稍后重试」。保留有效推荐，恢复按钮；不自动重复发送。
关系已建立，会话失败保留好友关系及推荐剔除结果，提示操作未同步。从好友列表重试进入单聊，不恢复已加好友卡片。
当日火数读取失败可用同业务日已读值；没有当日值则不显示火数。不使用前一天缓存，不客户端补随机火数。
直播／赛事资料缺失tag 缺失不画 tag；比分缺失不补造；赛事缺失用完整房间标题，标题也空则隐藏标签。已读有效卡片信息保留；无直播不保留直播标识占位。
前五项筛选无好友显示「该分组暂无可联络」。保留六个入口及有效推荐；读取失败不当作空名单。
客服读取／会话建立／跳转失败提示「客服连接失败，请稍后重试」。停留来源页面，保留 ID 或筛选、推荐、名单排序和滚动位置；恢复后重试。
邀请统计或动作失败沿用现有邀请功能的读取、loading 与错误处理。保留现有页面与实际统计，不虚构邀请成功或奖励。

字段定义与建议新增字段

7.1 页面字段对应

页面／字段取值或资料来源约束
菜单项搜寻、加好友、扫一扫、邀请好友、联系客服。前面三个沿用，后面两个新增入口；顺序固定。
加好友 ID用户输入、既有用户查找资料。空输入不提交；查找失败不影响推荐。
推荐账号账号 ID、头像、昵称、群管／主播角色、是否允许推荐。可推荐、未加好友及当前权限校验通过。
推荐卡昵称账号原始昵称。卡片展示前 5 个字符，完整资料不改写。
火热程度账号当日 2–5 火与服务端业务日期。同账号同业务日，跨页面、跨推荐池一致。
直播资讯当前直播状态、绑定赛事主队／比分／客队、聊天室完整标题。资料缺失按兜底规则，已读文字 5 字窗口、500 ms 推进 1 字。
好友筛选全部／星标／群管／主播／最近。仅可联络好友；客服另作动作，不写入选中筛选。
星标与昵称排序当前用户既有标星资料及现有昵称索引。星标先、非星标后，两组内既有字母排序。
最近消息时间实际一对一收发消息中的最新时间。账号去重，时间倒序入选 10 位，再按统一名单顺序展示。
客服既有单一客服账号及会话。400449 为原型示例，不新增用户可选客服列表。
进入来源与页面状态来源页面、原筛选、ID 输入、滚动位置。用于准确返回；不由聊天类型猜测来源。

7.2 建议传递与持久化资料

  • 以下为实现所需资料映射，不是新增后台配置界面；已有字段直接复用，不要求重复建字段。
  • 推荐请求／建联动作：当前用户、目标账号 ID、来源（加好友／联络）、推荐类型、模块当前批次标识。
  • 推荐资格：好友关系、拉黑／禁推／允许推荐状态、群组关系及账号角色；以服务端实际结果为准。
  • 每日火数：账号 ID、服务端业务日期、当日展示值；唯一约束为账号与业务日期。
  • 最近好友：好友账号 ID、最近一笔一对一消息时间；星标读取当前用户既有标星状态。
  • 返回参数：进入来源页面、来源筛选、原滚动位置、ID 输入及必要的上层页面引用；仅作导航恢复。
  • 幂等与过期响应：沿用现有请求／会话幂等机制，关联当前用户与目标账号；响应需能确认对应的页面和模块。

版本记录

版本日期本次更新
v3.02026-10-10
  • 需求 1 原型与说明在前，接需求 2 原型与说明；区分新增与优化。
  • 移除重复独立卡片与验收清单；联络状态用按钮切换，吸顶画框对齐。
  • 共用规则改为分点表格，轮播速度改动态示意；已确认的业务规则不变。
  • 好友、消息、星标及状态控件仅本地示意；真实接口需开发联调。