Skip to content

群资料页与成员预览 ​

快速群名片和完整资料由 groupProfile 下的统一组件承接;GroupProfileDialog 保留为现有入口适配。联系人与群共用 ProfileWorkspace 的响应式目录、已访问章节保留、滚动位置和 TabActivity,各自提供内容,不共享展示设置。

与联系人共用同一套基座(2026-11-12 收口) ​

群侧不另起基础框架,全部直接复用联系人侧的共享实现,只提供群特有内容:

关注点共用来源群侧用法
名片外壳.weq-member-pop + .weq-contact-cardGroupProfileSurface 的快速名片同时挂 weq-group-card 变体,宽度/圆角/内距/渐变继承,不自建
数据行components/contactProfile/ContactRow.tsx群事实行、详细资料 7 行、扩展资料、标签来源全部用 ContactRow;仓库里不再有群专用 <dl> 行模型
技术详情ContactTechnicalDetails冻结原因代码、头像编号/版本、排序指标
局部失败ContactInlineError群资料读取失败、成员预览失败都用「一行 status + 文字重试」
空态ContactEmptyState扩展资料等章节的空态
目录/章节标题/正文宽度ProfileWorkspace + profile-workspace.css群只传 10 个章节;标题与 max-width: 720px 由容器输出

styles/group-card.css 只保留群特有样式:身份区排版、群标签 chip、成员预览(八位;窄屏两行四位,热区 ≥44)、简介三行折叠、页头与页内操作行;禁止再定义卡片底、行、目录。

群资料页页头目前由 GroupProfileSurface 渲染占位结构(「群资料」+ 关闭,位于文档流、不再绝对定位压住标题),等共用 ProfilePageHeader 契约落地后替换。

数据与加载 ​

  • useGroupReadScope 仅读账号配置,不为查看资料创建写操作轮询;缓存键包含账号配置及目标群。
  • 名片先显示传入对象,本地群资料用于补全;名称不由云端覆盖会话缓存。只读指标快照中的成功值可显示好友数或已知异常状态,不因开卡计算指标。
  • account.groupMemberPreview 要求当前账号与配置 ID,在读取后再次检查来源。服务端先取最多 32 位本地候选,与当前已知好友关系排序去重后选最多八位。
  • 缺少成员时可复用现有完整名单缓存,仍不足且在线能力可用时调用 FetchGroupMemberListPage 一次,不追 token、不调用完整名单刷新方法。协议没有八人请求参数,响应是服务端的一页,只有显示结果截到八位。
  • 预览缓存按会话服务实例、群与在线可用性隔离,60 秒有效,并发请求合并,最多保留 200 项。失败保留已有成员,不缓存失败结果;预览从不写完整名单或投影好友总数。
  • 公告、相册、文件、精华、打卡支持页内宿主和原有独立浮层,复用同一内容逻辑。完整扩展资料只在详细资料章节读取,保留原有服务端缓存和请求合并。
  • 章节使用 TabActivity 暂停读取,资料历史的迁移状态轮询也随章节停止。公告草稿、文件操作及相册上传向所属资料页注册离开状态。

导航与兼容 ​

群资料导航目标增加 section、albumId、folderId、fileId,旧调用默认概览。资料页独立持有目标,不依赖当前聊天群。原消息、相册、文件等直达浮层仍可使用原调用形式。

本地生成群只提供适用的本地分区,不向真实 QQ 群查询。缺少明确入群证据时保持未知,不依据成员预览或目录缺项判断退群。

操作能力 ​

群名、成员昵称、撤回、禁言、移出成员、精华和群文件使用 @weq/service/qq-permissions 的逐操作规则。不能用一个 canManage 代替全部动作:管理员能修改同级管理员群昵称,但不能撤回同级消息;上传者能删除或重命名自己的普通群文件,但不能移动文件或管理文件夹。

GroupInfoService.operationContext 合并当前群目录角色、目标成员状态和在线 0x88d_0 的已确认字段。不能复用入群资料查询的 0x88d_110:同一群的成功回包可能缺少全员禁言等操作字段;缺失仍保留未知,不能解释为未禁言。展示读取有界缓存 15 秒、合并并发;写入强制重新读取,且在异步读取后检查账号实例与 QQ 运行时。在线读取失败保持能力未知,不将新开放的成员操作默认放行。禁言用绝对到期时间计算,聊天页到期重绘,后端发送前再次检查。

禁言时,桌面发送按钮和手机展开编辑页的发送按钮使用同一组件,替换为禁言图标及可见状态:全员禁言显示「全员禁言」,个人禁言显示剩余时长。倒计时只重绘按钮,页面隐藏后停止更新;禁言到期或查询确认解除后恢复正常发送。个人禁言优先展示,到期后若全员禁言仍有效则切换为全员禁言;群主和管理员的全员禁言豁免不变,禁言期间不清空或锁定草稿。

群名称的成员开关、成员踢人开关、精华开关及上传禁止位分别使用自身规则。逐条精华 canRemove 的明确返回优先于角色和群开关;缺少逐条返回时保留本地确认的原消息作者,而不是设置精华的操作者。

相册的 GetMediaList 返回在 data.9 提供权限对象,操作列表为 right.1,不是位掩码:1 新建、2 修改、3 上传、4 删除媒体、5 置顶、6 删除整册。列表缺失保持未知,明确空列表表示这些能力均未开放。现有媒体删除入口遵循 Android 的 DELETEALBUM(6)或可信上传者判断,不直接以群管理身份代替服务端能力;上传者兼容可信的 UID/UIN。群级新建沿用已确认的官方 CGI 创建许可读取,不从单册上传能力外推。读取置顶能力不新增置顶入口。

成员独立撤回能力和话题群临时管理身份的消费规则已知,但当前协议尚未接通其成员权限读取,不能把 isAllowRecallMsg(新成员读历史)或普通管理角色当成该权限数据。服务端最终受理结果和账号动态撤回窗口仍以 QQ 返回为准。

定向回归 ​

  • group_member_preview.test.ts:有界候选、好友优先、去重、失败保留、重试、并发与缓存。
  • group_profile_router.test.ts:当前账号及数据源绑定、迟到响应隔离。
  • group_card_refactor.test.ts:名片正文分工、父子名片返回、共享目录与活动状态、在途操作阻止离开。
  • group_card_query.test.ts:读取按活动状态启动、查询复用、同号切换数据源隔离。
  • test/browser/run-group-card-refactor.mjs:真实组件的八位头像、展开、嵌套返回、目录、按需扩展资料、成员检索及响应式主题截图。

当前文档对应 v2.7.4 · 已发布内容以 CHANGELOG 为准