zhifu-platform/docs/design/wireframes/conversation-list-presentation.md

会话与列表展示规范

本次调整依据用户于 2026-09-28 提出的三端会话与列表 UI 优化要求。页面入口、业务操作、确认步骤、权限和接口沿用已有设计；本规范维护信息展示、长内容阅读及滚动规则。

信息展示

位置	直接展示	按需查看	不向当前用户展示
H5 咨询	客户、AI 助手、人工客服身份，正文，消息时间，发送和处理状态，人工接待状态，相关订单与工单入口	长消息全文、订单详情、方案内容与规则依据	内部 run、task、event 编号，原始事件名称，工具输入输出、Prompt、模型参数、内部错误信息
商家会话队列	客户标识、接待状态、会话来源、建立时间及已有查询条件	完整会话标识及授权业务上下文	未获授权客户正文及资料
商家会话	消息身份、正文和时间，接待控制状态，订单及售后操作	长正文、完整业务编号、规则依据、工单处理记录	内部任务载荷、模型推理过程、员工权限之外的数据
商家通知	已读状态、类型、标题、摘要、发生时间和详情入口	通知全文与有权限的业务入口	客户消息正文，其他员工的通知
平台投递	商家、接收应用、业务事件、投递状态及操作	所选投递的完整编号、事件编号与版本、发送次数、失败原因、下次尝试、接收结果	客户聊天正文、订单正文、模型内部内容
平台审计	时间、操作者、范围、对象、操作及结果	变更前后的完整元数据、较长操作说明	超出平台管理权限的业务资料

状态名称使用面向用户的中文。没有服务端记录的送达、已读和未读信息不得推测或补充。客户确认与审批条件始终完整展示。

消息形式

• 客户、AI 助手和人工客服消息使用具有身份文字的消息气泡；颜色作为辅助识别。
• 人工接待、恢复助手、业务进度等系统事件使用独立状态提示。传输和模型调度事件仅更新处理状态。
• 订单、工单和方案继续使用业务卡片及原有入口。正文中的文字按文本安全展示，不能执行 HTML。
• 发送中、发送失败、等待回复和连接异常具有独立反馈。恢复操作遵循已有幂等与连接规则。
• 用户查看历史消息时保持阅读位置；新消息提示允许返回最新内容。加载更早记录后保持当前消息位置。

高度与滚动

区域	高度限制	超出后的行为
H5 咨询工作区	根据当前视口可用高度分配；输入区域保持可访问	消息区域纵向滚动；视口高度不超过 600px 时减少外围和标题间距，保留消息阅读空间
H5 咨询输入框	正常为 44–96px；视口高度不超过 600px 时最高 44px	较长草稿在输入框内滚动，发送与人工协助操作保持可见
H5、商家单条长消息	默认正文预览最高 240px	展开全文后由消息区域滚动，正文自身不产生第二个滚动区域
商家会话工作区	宽屏为 560–760px，并按视口高度减去 220px 计算	队列、消息和上下文分别纵向滚动；1150px 以下改为两栏，760px 以下纵向排列，聊天区域高 680px，客户资料最高 480px
后台数据表格	最高为 560px 与视口高度 65% 中较小值	表体纵向滚动，表头保持可见；列宽不足时表格内部横向滚动
列表长文字	使用短摘要或有限高度预览	通过展开全文或详情入口读取完整内容，键盘和触控均可使用
平台投递详情	正文最高为 560px 与视口高度 60% 中较小值	正文区域纵向滚动；窗口关闭操作保持可访问
H5 商品、订单和消息列表	沿用页面纵向滚动	保留现有分页与加载更多，不添加卡片内部滚动
H5 售后申请选择列表	最高为 360px 与视口高度 40% 中较小值	选择列表独立滚动，当前申请详情及加载更多操作位于列表外

完整编号保留在业务详情中，展示缩略不改变接口提交值。列表滚动不等同于加载全部数据；既有分页继续使用服务端游标，平台投递和审计明确标注最多显示最近 100 条。

验证要求

使用真实服务和浏览器 DOM 检查消息身份、长内容展开、阅读位置、输入区域、详情选择、滚动高度与横向宽度。覆盖加载、空内容、失败、禁用、无权限及会话过期等相关状态。检查不使用截图；生成模型调用次数单独记录。