UI 蓝图/Matrix X Chat · Communication/全局联系人、群聊与消息搜索

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR12 · 13/21 PASS COMPLETEiOS · 在有权访问的关系和会话中查找内容的用户

全局联系人、群聊与消息搜索

组合本地联系人索引和服务端消息搜索，并在部分失败时维持最小授权结果

SearchViewmatrix-x-chat-ios对照 CURRENT · matrix-global-search →

R12 · KNIFE 13 / 21

全局联系人、群聊与消息搜索 · 原生页面级细化任务包

组合本地关系索引和服务端消息搜索，在部分失败时只返回当前授权范围。

CURRENT ROUTE

SearchView

CURRENT SOURCE

MatrixXChat/Features/Search/SearchView.swift

CURRENT API

/app/api/message/global-search + local index

WORK MODE

discover · K12

ENTRY

根搜索、消息/联系人页搜索或快捷命令。

SUCCESS OUTPUT

跳转到有权访问的 profile、group 或 message anchor，并保留 query scope。

INTERACTION MODEL

Query → local relationship hits + remote message cursor → visibility decision → typed route。

A11Y

结果按类型分组，高亮不破坏朗读，分页/取消/清除历史可键盘与 VoiceOver 操作。

TELEMETRY

search_submit · result_type_open · visibility_deny；查询内容哈希或不记录。

CURRENT SOURCE + RUNTIMEiOS 257e604 · API 9e22253

matrix-x-chat-ios origin/main 为 257e604a5073b1ecab0f905d7ec59dfb78960639；本地 feat/p1-knives-1-8@56c8481 落后 main 86 个提交并有 3 个分支独有提交，不能作为最新 CURRENT
iOS main 可数 1,711 个 Swift 文件、617 个 `struct …: View`、682 个 Features Swift 文件、530 个 *Tests.swift 与 19 个 workflow 文件；App Store/TestFlight 采用哪个 build 本轮没有证明
im-core origin/main 与 EC2 production 均为 9e222534fcf6786a517f81936a2133bae7053e4d；源码有 225 个 Go 文件、78 个 Go test 文件、56 个 SQL migrations 和 405 个注册 HandleFunc
EC2 有 4 个 im-core runtime 容器加 PostgreSQL、Redis、NATS、MinIO；api.reits.tech 的 /healthz、/readyz、/api/v1/meta/app、/im/healthz 均返回 200，WebSocket 独立转发到 18081
主 App 锁定 Enterprise 1.0.47、Wallet 1.0.22、MiniApp 1.0.33、Plugin UI 1.0.34；新 tag 或插件仓最新代码不等于主 App 已消费
所有预览用户、会话、计数、游标、企业、动态、余额与小程序行情都是 REVIEW FIXTURE；只用于 UI/状态评审，不是生产数据或线上截图

IMPLEMENTATION GAPPRODUCT QA 0 / 5

搜索结果计数、消息片段与联系人名都是 fixture
索引删除、关系撤销和消息可见性 revision 的失效传播未证明
remote partial failure 与 cursor pagination 需要稳定 fixture 和 E2E

126-STATE PROGRAM / THIS SCREEN

九态挂在当前原生页面的数据、权限、游标、插件或回执上，不使用通用遮罩冒充交互完成

QA 0 / 5 VERIFIED

READYAuthorizedSearch 合同可评审

AuthorizedSearch native workspace

R12-SEARCH-READY→ 查看 visibility decision

LOADING正在读取 AuthorizedSearch

AuthorizedSearch independent regions

R12-SEARCH-LOAD→ 保留原生导航上下文

EMPTY查询没有授权范围内的结果

AuthorizedSearch result

R12-SEARCH-EMPTY→ 查看合法下一步

PARTIAL ERRORAuthorizedSearch 部分依赖未收敛

AuthorizedSearch dependency rail

R12-SEARCH-PARTIAL→ 只重试失败分区

ERRORAuthorizedSearch 请求失败

AuthorizedSearch request

R12-SEARCH-ERROR→ 安全重试

OFFLINE离线只读 · AuthorizedSearch

AuthorizedSearch safe snapshot

R12-SEARCH-OFFLINE→ 等待网络恢复

FORBIDDEN当前主体不能访问 AuthorizedSearch

AuthorizedSearch authorization

R12-SEARCH-DENY→ 返回安全页面

CONFIRM确认清除搜索历史或离开当前上下文？

AuthorizedSearch impact sheet

R12-SEARCH-CONFIRM→ 确认或取消

SUCCESSSearchRoute 已建立

AuthorizedSearch receipt

R12-SEARCH-SUCCESS→ 查看回执

UI STUDIOtarget-matrix-global-search

iOS390 × 844100%

100%

SearchView

TARGET UI390 × 844FIT 100%

R12 DESIGN CANDIDATEtarget-matrix-global-searchREVIEW FIXTURE · NOT LIVE DATA

9:41●●●　⌁　▰

E07 · NATIVE EVIDENCE OPENIOS SOURCE / CURRENT PROD API257e604 · 9e22253

API PRODUCTIONhealth/ready/meta/im-health 200IOS RELEASEApp Store build not proven

搜索

⌕游标×

本地索引 + 服务端消息搜索 PARTIAL SAFE

联系人与群聊3 个结果

游

游标迁移讨论组18 位成员 · Alex、Yuki 在内

›

Y

Yuki Data昵称命中 · 数据平台

›

消息查看全部 12 条

产

产品协作群

新的会话设计已经同步游标

今天 10:24

›

数

数据平台

ACK 必须绑定 device_id游标

昨天 18:02

›

REFERENCE VIEWPORT390 × 844Dynamic Type · safe area

PRIMARY TASK提交查询主操作、权限与完成反馈必须同屏可验证

DATA CONTRACTSearchQueryready / loading / empty / error 使用同一 fixture

ACCESSIBILITYVoiceOver + 44pt焦点顺序、可读名称、对比度进入 UI CI

VISUAL BASELINETARGET · 2026-07-18桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

目标定义与下一轮逐页细化入口

当前处于 B1/B2：可以拆出架构、设计、交互和 QA 任务，但完成 D01–D12、通过 B3/B4 之前，不得宣称页面已经可以照稿实现。

01

页面区域

查询导航
结果类型
查询健康
联系人/群组
消息上下文
可见性边界

02

用户动作

提交查询
切换类型
打开联系人/群组
跳转消息
继续分页
清除历史

03

必须状态

通信状态已就绪
安全快照同步
当前范围为空
部分内容未同步
本次同步失败
离线只读快照
关系或权限不允许
高影响操作确认
服务端回执已完成

04

数据契约

SearchQuery
ContactHit
GroupHit
MessageHit
VisibilityDecision
SearchCursor
PartialSearchStatus

TARGET MODULES

目标页面必须交付的模块

01活跃查询
02类型分段
03本地命中
04服务端消息命中
05高亮上下文
06游标分页
07部分安全
08授权边界

PRODUCT ROUTE INDEX

Matrix X Chat · Communication 的 28 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言，但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

登录入口LoginView · AuthFlow

会话列表MainTabView.chats · ConversationListView

聊天室AppRoute.chatById · ChatView

联系人MainTabView.contacts · ContactsListView

工作台MainTabView.workspace · PluginRegistry.workspace

全局搜索SearchView

新的朋友AppRoute.friendRequests · FriendRequestsView

群聊详情GroupChatDetailView

用户资料AppRoute.userProfile · UserProfileView

应用市场WorkspaceView · AppMarketView

朋友圈DiscoveryView · MomentFeedView

钱包AppRoute.wallet · WalletPluginHostView(.home)

设置与隐私MainTabView.profile · SettingsView

小程序容器PluginRegistry.miniApp · IMMiniAppViewShell

手机号 / 邮箱登录与设备验证LoginView · AuthFlow

会话、文件夹与未读收敛MainTabView.chats · ConversationListView

消息时间线、重放与发送回执AppRoute.chatById · ChatView

联系人、关系与群组入口MainTabView.contacts · ContactsListView

全局联系人、群聊与消息搜索SearchView

好友请求与并发关系决策AppRoute.friendRequests · FriendRequestsView

群资料、成员与权限控制GroupChatDetailView

联系人资料、隐私与会话授权AppRoute.userProfile · UserProfileView

企业工作台与应用编排MainTabView.workspace · PluginRegistry.workspace

企业应用市场与订阅WorkspaceView · AppMarketView

朋友圈媒体与可见性时间线DiscoveryView · MomentFeedView

钱包资产、资金动作与强认证AppRoute.wallet · WalletPluginHostView(.home)

账号、设备、隐私与本地设置总览MainTabView.profile · SettingsView

小程序可信运行容器PluginRegistry.miniApp · IMMiniAppViewShell

← 联系人、关系与群组入口好友请求与并发关系决策 →