U8 Chat 2.0 · 搜索（会话列表搜索 / 全局分类搜索 / 聊天内部搜索）产品需求文档 PRD

本 PRD 的边界：UI 图＝唯一依据。凡图里画了的（页面、文案、按钮、菜单项）照做；图里没有画的（例如「搜索筛选器」「高级搜索」「按文件类型筛选」）本期不做，只在第十一章列成待确认，不自行补设计。
若某条逻辑图里看不出来（例如搜索历史保留多少条、结果怎么排序），本 PRD 按 Telegram 的既定行为写，并在第十一章标出需要产品/开发确认。

---

一、背景与目标

1.1 背景

U8 现在没有搜索：

• 会话列表顶部虽然有一个搜索框，但只能按「聊天 / 联系人」找一个会话；
• 想找「上个月那张图」「某人发的那个文件」时，只能翻聊天记录；
• 群里想找「某人说过的话」「某天的记录」更是没有入口。

1.2 目标

把搜索做成三层，每一层解决一个问题：

三层共用同一个「搜索」入口与一套视觉。

---

二、范围

2.1 本期做

2.2 本期不做（★ UI 图里没有的一律不做）

---

三、名词与统一口径

---

四、功能详情

4.1 会话列表搜索

4.1.1 入口与默认态（iOS 1188:85507）

入口：首页（会话列表）顶部搜索框 → 点击进入搜索页。

默认态（还没输入）自上而下：

画板 1188:85603（「未搜索时默认状态2」）与 85507 是同一状态的两种排布（只有联系人头像行的间距 / 滚动位置不同，没有规则差异）—— 已按产品 2026-10-09 口径合并为一屏，本 PRD 只保留 85507。

4.1.2 输入关键字后的结果（iOS 1188:85699）

输入 「大哥」 后，页面自上而下：

要点

1. 「消息」区展示的是每个会话里最匹配的一条（不是一条条罗列全部命中），点进去 = 跳到该会话并定位到那条消息。
2. 群消息结果里，第二行才显示发送者（Jioy / 安丽 / 张妮），私聊结果不显示发送者。
3. 结果分区顺序固定：最近 → 聊天和联系人 → 消息。

4.1.3 「所有聊天」二级筛选（iOS 1188:85837）

点「所有聊天 ⌄」展开二级筛选（图上是展开态）：

• 筛选只作用于「消息」分区（聊天和联系人分区不受影响）。
• 选完自动收起下拉。

4.1.4 清空搜索历史（iOS 1188:87427）

点「最近」右侧的「清空」→ 弹出确认：

• 确认后：「最近」分区消失（页面只剩联系人头像行），关键字与其它分区不受影响。
• 取消：什么都不变。

---

4.2 全局分类搜索

4.2.1 分类 Tab（五个）

位置：搜索页底部悬浮胶囊（与底部 Tab 同款样式），自左至右：

聊天 · 群组 · 媒体 · 文件 · 语音

规则

1. 分类切换保留关键字：在「聊天」里输入「大哥」后切到「媒体」，关键字继续生效（1429:88301 就是「媒体 + 关键字 大哥」的结果）。
2. 每个分类都先在未输入时展示"最近的"（媒体/文件/语音都有），这样"没想好搜什么"也能用。
3. 列表按时间倒序（今天 → 昨天 → 周二 → 07/12 这类相对/绝对时间分组）。

4.2.2 聊天分类

见 4.1（默认态与结果）。

4.2.3 群组分类（iOS 1500:100804）

条目 = 两行（照 UI 图）：

⚠️ 群 ID 与群人数都在第二行、和群名分行显示 —— 不要挤在一行。

规则

1. 未输入关键字时列出你加入的群（按最近活跃）；输入后按群名 / username 匹配。
2. 点某群 = 进入该群。
3. 长按 / 多选等操作：UI 图上没有，本期不做。

4.2.4 媒体分类（iOS 1188:85984 / 1429:88301 / 87360）

未输入时（85984）：图片/视频网格（3 列），视频右下角带时长（1:28 / 1:39:17 / 32:09）。

滚动时（87360）：出现月份分组标题（2026 年 7 月），即列表按月份分段。

输入关键字后（1429:88301）：媒体以列表形式展示，每条：

注意：媒体未输入时是网格、输入后是列表 —— 这是 UI 图画的两套版式，照做。

4.2.5 文件分类（iOS 1188:86282 / 86819）

条目结构 = 两行（照 UI 图）：

⚠️ 两个易错点：① 类型图标是橙底白字（不是浅灰底）；② 大小与来源会话在同一行用 · 连接，不要拆成两行。
⚠️ 长文件名只在行内截断：像 config_v38qqcqq11i38qq11iajopjol... 这种必须显示成 …，不能撑破一行、也不能压到右侧时间上。

长按（86819）→ 菜单：转发 / 在聊天中查看 / 选择。

4.2.6 语音分类（iOS 1188:86424 / 86630）

条目结构 = 两行（照 UI 图）：

⚠️ 易错点：左边是播放按钮不是头像；发送者名与来源会话用 › 连在同一行（不要上下两行）。

长按（86630）→ 菜单：转发 / 在聊天中查看 / 选择。

4.2.7 长按 / 多选 / 转发（媒体、文件、语音 通用）

---

4.3 聊天内部搜索

4.3.1 入口与默认态（iOS 1188:87533）

入口：聊天页（单聊或群聊）→ 顶部搜索。

默认态：顶部变成搜索框 在此聊天中搜索（+ 右侧 ✕ 关闭），下方就是原来的聊天记录（不切换页面）。

左下角两颗圆形入口按钮（悬浮在聊天页左下）：

这两颗按钮只在搜索态（顶部是「在此聊天中搜索」时）出现。
发送者名字在气泡里（群聊的既有表现）：名字是气泡内的第一行（在气泡内部、内容上方），并且按人着色 —— UI 图上 张磊 / 杨小红 是蓝色 #008cd7、噜噜咕噜 是橙色 #e57100。自己的消息（紫色气泡）不带名字行。进入搜索态不改这个规则。

4.3.2 关键字搜索（iOS 1188:87815）

在搜索框输入关键字（图上示例 什么）后：

• 搜索框内显示关键字 + 清空 ✕；
• 下方聊天记录定位到命中的消息，并且 命中的关键字在消息文本里高亮 —— 设计稿里是一个矩形色块 Rectangle 544824：填充亮黄 #ffe628、尺寸 30×21（正好盖住 2 个字的关键字「什么」），只盖关键字那几个字，不是整条消息；
• 命中的结果可以在聊天模式（定位到原文）和列表模式之间切换（见 4.3.5）。

4.3.3 按日期（iOS 1188:88041）

点左下日历按钮 → 底部弹起半个月屏面板：

规则

1. 选某一天 → 点「完成」→ 面板收起，聊天记录跳到那一天（该天的消息定位 / 按天过滤）。
2. 面板弹起时背景聊天页压暗；点 ✕ 或遮罩 = 关闭面板，不改变当前位置。
3. 月份可翻（‹ ›）。

4.3.4 按成员（iOS 1188:88393 / 88707 / 90297）

点左下人像按钮 → 搜索框变成 来自：，下方弹出一块悬浮成员面板：

规则

1. 点某个成员 → 面板收起 → 聊天记录自动定位到该成员的首条命中消息（88998）。

并且 被定位的那条消息「整条气泡变色」：设计稿在它上面盖了一层名为 变色 的覆盖层 —— 填充 #e57100、不透明度 15%，气泡本体（218×48）和气泡角（10×15）都盖，视觉上是很浅的暖橙色底，与白色气泡区分开。

所有人都变色：UI 图 89278（定位到自己发的消息）那一屏没有画变色层，但按产品口径（2026-10-09）自己的消息同样变色 —— 规则统一，不区分是谁发的（见 4.3.7）。

1. 定位后：

• 顶部悬浮一枚计数胶囊：1/16（当前第 1 条 / 共 16 条）；
• 计数胶囊右侧：以 列表 模式显示（切换按钮）。

1. 自己发的消息也能被定位（89278），并且同样变色（规则同上，不区分是谁发的）。

4.3.5 两种浏览模式（iOS 88998 ↔ 89526）

规则

1. 计数 N/M 表示当前第 N 条 / 共 M 条命中；聊天模式下上下切换命中项，聊天记录跟着定位。
2. 列表模式下点某条 = 回到聊天模式并定位到该条。
3. 列表条目里图片类消息显示 [图片] 占位。

4.3.6 组合筛选与「未找到」（iOS 89741 / 89662 / 90024）

• 成员 + 关键字可以叠加：先选成员（来自：噜噜咕噜），再在搜索框输入关键字（什么）→ 结果为「该成员 + 含该关键字」（89741）。
• 列表模式下同样可以叠加关键字（89662）。
• 未找到（90024）：关键字没有命中时，在聊天记录上浮出一条白色圆角提示卡（带阴影）：左侧一个「文档 + 放大镜」图标 + 文字 未找到相关信息；位置在屏幕中部偏左（贴着左边约 20pt，不是居中、也不带遮罩）。

⚠️ 它不是整页空态 —— 成员筛选定位到的消息仍然正常显示在下面（该条照常变色），只是关键字这一层没有结果。

4.3.7 高亮规则汇总（★ 全部照 UI 图，逐条给出处）

⚠️ 表里最后两行（列表模式高亮、自己消息变色）是 UI 图里没有画的 —— 按产品口径 2026-10-09 补齐，规则与聊天模式保持一致（不留「同一功能两种表现」的口子）。实现按本表做，UI 出图时请把这两处补上。

---

五、屏清单（与 UI 画板一一对应）

5.1 iOS · 会话列表搜索（4 屏）

5.2 iOS · 全局分类搜索（12 屏）

5.3 iOS · 聊天内部搜索（12 屏）

5.4 安卓：与 iOS 同屏同规则（20 屏）

安卓 SECTION 1293:101505（全局）+ 1336:64713（聊天内部）覆盖同样的屏，规则完全一致，只是版式按安卓（412×892）。对应的安卓屏 node：

安卓少了 iOS 的「媒体长按（未选择）」等屏 —— 按 iOS 的规则实现，安卓只是没有单独出图。

---

六、异常与边界

---

七、跨端

---

八、文案

以上全部照 UI 图，一字不改；本 PRD 不新增任何用户可见文案。

---

九、接口与埋点（建议）

---

十、待确认

---

十一、相对 UI 图（本次不动什么）

---

本 PRD 以 Figma 画板为唯一依据。评审时请对照 iPad/iPhone 设计稿一起看：第六章的文案表可以直接做「文案核对清单」。