U8 Chat 2.0 · 群成员标签（可自定义名称）产品需求文档 PRD

本演示与 PRD 都是「UI 设计之前的输入」：讲清楚「有哪些页面、从哪儿进、能写什么、写长了什么样」。已有画板（群消息、群资料）照做；没画的部分由本演示给出建议稿。最终视觉以 UI 设计为准，按钮摆放、间距一类版式细节不作为评审与验收项。

一、背景与目标

1.1 背景

群里所有人共用一套固定身份：群主显示「所有者」、管理员显示「管理员」、其余人什么都没有。

问题是这三类标签说明不了任何人是谁：一个 49 人的工作群里，「管理员」可能是技术、可能是客服、可能是财务。大家只能靠群昵称自己想办法（把职务写进名字里）。

U8 现状（产品 2026-10-08 确认）：群消息里已经显示发送者名字，而且名字就在气泡里面（气泡第一行），但没有标签功能（既没有自定义标签，也没有「所有者 / 管理员」这类默认标签）。所以本次是在气泡内的名字右边新增一枚标签胶囊，名字本身与气泡版式都不动。

1.2 目标

1. 让每个群成员都能给自己名字旁加一段文字（标签），说明自己在这个群里的身份。
2. 让群主 / 管理员的身份一眼可辨：所有者＝紫色胶囊、管理员＝绿色胶囊，而普通成员没有胶囊、只有一行文字。
3. 让群主能一键决定「标签是人人可写，还是只有管理员能写」。
4. 规则与限制照 Telegram，只有两处按 U8 调整：上限按显示宽度算（中文 8 字 / 英文 16 字符）、不拦保留词（靠胶囊颜色区分）。

1.3 不做什么（一句话）

不动个人资料（标签不是个人资料的字段）、不做分组/多标签、不做标签颜色或排序自定义、不做标签审核、不用词表拦「所有者/管理员」。

二、范围

2.1 本期做

2.2 本期不做

三、名词与统一口径

3.1 标签（Tag / Rank）

• 每个群成员可以有的一段短文字，显示在群里自己名字旁边；每个群各自一份。
• 服务端字段名沿用 TG：rank（官方描述：just an arbitrary string）。
• 空 = 没有标签：普通成员不显示任何东西；群主/管理员回落到默认标签。

3.2 默认标签（不是数据，是客户端渲染的）

3.3 角色标识（U8 的区分手段：只用标签胶囊的颜色）

• 颜色由客户端按角色渲染，用户改不掉、也不存在标签文本里 —— 所以不管成员把标签写成什么（哪怕写成「所有者」），系统都能准确区分真角色。
• 不额外加图标或徽章（产品 2026-10-08 拍板）：角色只靠胶囊颜色区分，界面更干净。
• 自己发的消息同样显示（#A1 / #A2 最后一条）：自己的气泡是深紫底，名字用半透明白；标签在深底上换成白底 + 对应色字（所有者紫字 / 管理员绿字），普通成员则是白字、无胶囊 —— 换底不换语义。

3.4 作用域与可见性

• 本群可见：标签出现在这个群的每条消息上（TG 的超级群把标签随消息一起下发：message.from_rank）与这个群的成员列表里。
• 私聊、别的群、个人资料页都不显示；同一个人可以在 A 群叫「技术支持」、在 B 群叫「打杂的」。
• 标签不影响任何权限（TG 的 channels.editAdmin 把「权限」和「标签」当两个独立参数）——写成「管理员」不会获得管理权限。

3.5 谁能改谁（★ U8 是固定规则，与 TG 不同）

与 TG 的差别（重要）：TG 里「谁能改标签」是群主可配置的权限（manage_ranks 权限 +「允许成员设置自己的标签」开关），成员默认能改自己的。U8 不做开关，直接写死成上表（产品 2026-10-09 拍板）。详见 4.4。

四、功能详情

4.1 展示位一：群消息

• 位置：气泡里面的第一行 —— [名字] [标签]，下面才是消息内容（U8 现在就是「名字在气泡里」，本次只在名字右边加标签，气泡版式不动）。
• 样式：所有者＝紫色胶囊、管理员＝绿色胶囊、普通成员＝没有胶囊只有文字。
• ★ 自己发的消息也显示名字 + 标签（U8 要求，与别人发的一样在气泡第一行）。
• 自己的气泡是深紫底，所以配色要反过来：名字用半透明白；自己的标签若是普通成员 → 白字、无胶囊；自己若是所有者 / 管理员 → 白底 + 对应色字（紫 / 绿），保证在深底上仍然分得清。
• 标签永远不会被截断：上限按显示宽度算（见 5.1），写到上限也能在气泡里完整显示。
• 对应演示屏：#A1（默认标签「所有者」）/ #A2（三档配色，含"普通成员写成『所有者』"的对照）/ #A3（写到上限 8 个汉字，完整显示）。

4.2 展示位二：群成员列表

• 成员列表每行 = 头像 + 名字 + 标签（同一套胶囊配色）。
• 没设标签的普通成员只有名字，不留空占位。
• ★ 点某一行 → 进这个人的「成员资料页」（现有行为，本次不改）。设置标签的入口在成员资料页里（一行「标签」），不在列表里直接弹编辑器 —— 见 4.6。
• 对应演示屏：#A4。

4.3 设置自己的标签

入口：群资料 →「我的标签」（右侧显示当前标签；没设过显示「未设置」）——#B1

谁能看到这一行：所有者、管理员（#B1）；普通成员看不到（#C1）—— 因为普通成员不能设置标签（见 4.4）。

编辑页：#B2

4.4 谁能改标签（★ 固定规则，没有开关）

产品 2026-10-09 拍板：不再做「允许成员设置自己的标签」这个开关，权限直接写死成下面这套。

• 普通成员连自己的标签也不能设 —— 所以他的群资料页里根本没有「我的标签」这一行（#C1）：不是置灰、更不是点了报错。
• 管理员改不了其他管理员、也改不了所有者 —— 在成员列表里点这类人时，没有「设置标签」入口（#C3）。
• 「能改谁」只按角色定，与标签内容无关；不拦任何词（见 5.2）。

4.5 标签可以被覆盖（★ 后设的盖掉先设的）

规则：同一个人身上只有一个标签值，最后一次写入生效 —— 谁改都算一次写入。

• 产品给的例子（演示里走完了整条链）：管理员小王自己设 AAA → 所有者改成 BBB（#C2）→ 小王自己再改成 CCC（#C4）。
• 覆盖只改变值、不改变权限：小王是管理员，被覆盖后他仍然能改自己的；普通成员被覆盖后，只能等所有者 / 管理员再改。
• 不显示来源、不留历史：群里只显示当前标签，用户看不出「这是谁设的、有没有被改过」。
• 被改的人不会收到通知（沿用既有口径）。

4.6 给成员设标签（入口在「成员资料页」）

先纠正一个落点：点群成员打开的是成员资料页（现有行为）—— 头像 + 名字 + 操作按钮 + 资料信息 + 成员资料区。设置标签的入口就放在这一页里，不影响任何既有结构。

• 权限照 4.4：管理员能改普通成员；所有者能改任何成员（含管理员）。
• 写成「所有者」「管理员」是允许的 —— U8 不做保留词校验（理由见 5.2），保存后群里会出现两枚「所有者」，但没有紫胶囊的那一枚一眼就能看出是普通成员写的（#A2）。

4.7 清空与回退

4.8 安卓端差异

五、限制（★ 本章是本文档的重点）

5.1 上限为什么是「16 个半角宽度」而不是「16 个字符」

• TG 的规则是16 个字符，不区分语言 —— 中文里 1 个汉字算 1 个字符，所以中文能写 16 个汉字。
• 但能写 ≠ 能显示：名字和标签挤在气泡内的同一行 —— 气泡最宽 252pt、左右内边距 24pt，一行可用约 228pt；减去发送者名字（按最长 120pt）与 6pt 间距，标签可用宽度约 100–110pt。
• 8 个汉字 ≈ 96pt（含内边距）→ 刚好放得下；
• 16 个汉字 ≈ 180pt → 远超气泡宽度，必然被截断成省略号。
• 用户写完发现自己写的字看不到全，会当成 bug 来报。所以 U8 把上限换算成显示宽度：16 个半角宽度（中文 8 个字 / 英文 16 个字符），从输入环节就保证能显示完。
• 影响范围：这条规则只作用于标签这一个输入框，不改动任何已有字段（个人简介 100 个字符等照旧）。代价是前端与服务端各需要同一个宽度计数函数（全角 2 / 半角 1），两边必须一致。
• 边界情况：名字特别长时，名字自己会先被截断（名字行限宽），标签仍有 8 个汉字的空间。

5.2 为什么不拦「所有者 / 管理员」这类词，改用胶囊颜色区分

先看 TG 为什么不做（我们的判断，非官方原话）：

1. TG 已用颜色解决这个问题 —— 官方文档原话是「管理员的标签始终着色，以区别于非管理员」。它的"专属标识"就是那身颜色。
2. 词表拦不住，只能拦老实人：拦了「管理员」，还能写「管理員」（繁体）、Admin、Administrator、管理 员（加空格）、群管、客服主管…… 而且 U8 是全球化产品，词表要按语言维护。
3. TG 的默认标签是客户端按角色渲染的，系统里"谁是群主"从来不靠那串文字判定，所以它觉得没必要做这层校验。

U8 的做法：把 TG 的颜色机制明确成三档

效果：普通成员把标签写成「所有者」时，显示为一行灰字、没有胶囊；真群主是紫色胶囊 —— 用户一眼分得清（演示 #A2 就是这个对照）。

六、屏清单（15 屏，与 index.html 锚点一一对应）

七、异常与边界

八、跨端

九、文案（建议稿，最终以 UI 为准）

没有「该名称不可用 / 该名称为保留字」这类文案 —— U8 不拦保留词（见 5.2）。

十、接口与埋点（建议）

十一、待确认（需要产品 / UI 拍板）

已拍板（2026-10-08）：上限＝16 个半角宽度（中文 8 个字 / 英文 16 字符，中英混排）；角色区分＝标签胶囊颜色：紫＝所有者、绿＝管理员、普通成员无胶囊，不加图标，不拦任何保留词；自己发的消息也显示标签。

已拍板（2026-10-09）：不做权限开关 —— 权限＝固定规则：所有者可改所有群成员、管理员可改自己的 ＋ 普通成员（改不了其他管理员、改不了所有者）、普通成员不能设置任何标签；标签可被覆盖（后设的盖先设的，被覆盖者若自己有权限仍可再改）。

十二、相对设计稿改了什么

本 PRD 与同目录 index.html 配套使用：PRD 讲规则与限制，演示讲「这屏长什么样、点哪儿去哪」。