# 一秒智客云 UI 交互设计说明

## 一、设计目标

界面需要同时满足企业可信度、AI 技术感和高频服务效率。视觉采用石墨黑、纸白、信号绿与少量警示金，不使用花哨渐变和大面积高饱和色；组件圆角控制在 8px 以内，体现正式 B2B 产品的克制感。

## 二、信息架构

### 客服端四个主视图

1. 首页：欢迎、浏览上下文、快捷问题和快捷服务。
2. 咨询：消息流、引用、产品推荐、追问、附件、语音和转人工。
3. 记录：当前会话、历史会话和新会话。
4. 服务：需求单、人工顾问、知识中心和隐私说明。

### AI 知识中心

1. 知识库：统计、搜索、文档列表和启停。
2. 标准问答：新增问题、分类、答案和关键词。
3. 命中分析：召回测试、匹配分和置信度。
4. 网站接入：组件嵌入代码。

## 三、响应式规则

- 大于 720px：客服窗固定在右下角，宽约 410px，高度不超过视口。
- 小于等于 720px：客服窗铺满移动屏幕，不显示设备模拟外框。
- PC 的 AI 知识中心使用左侧导航和主内容区。
- 手机端知识中心隐藏左侧导航，内容单列滚动。
- 所有固定控件使用稳定宽高，避免动态内容造成跳动。

## 四、核心交互状态

### 悬浮入口

- 默认：圆形按钮、呼吸圈和未读角标。
- 主动邀请：入口上方显示短提示，可点击打开或关闭提示。
- 打开：客服窗上浮并淡入，入口保留在下方。

### 对话

- 空状态：提示用户输入问题并说明知识引用机制。
- 发送中：禁止重复发送，显示三点打字动画。
- 流式生成：按字符分批更新回答。
- 完成：显示引用、推荐产品、追问和评价。
- 无匹配：引导补充行业、设备、目标或项目阶段。

### 引用详情

- 点击来源卡片后从底部打开知识详情。
- 展示知识正文、分类、更新时间、置信度和启用状态。
- 支持关闭和继续追问。

### 项目需求单

- 校验企业名称、联系人、联系电话和需求描述。
- 手机号或固定电话格式不合法时就地提示。
- 成功后生成演示需求编号，并明确未上传服务器。

### 人工顾问

- 展示模拟服务组、排队人数和预计时间。
- 用户确认后加入会话消息，并明确当前没有真实客服后台。

### 附件与语音

- 附件大于 8MB 时拒绝并提示。
- 原型只展示文件名，不读取或上传内容。
- 语音不支持、识别失败、结束和重复启动均有状态反馈。

### 知识管理

- 知识开关即时影响后续召回。
- 新增标准问答后保存在当前浏览器并立即启用。
- 搜索为空时显示空状态。
- 召回测试无结果时给出知识补充建议。

## 五、动画说明

- 悬浮入口呼吸圈：2.4 秒循环，弱提示而不持续干扰。
- 主动邀请：短距离上移动画。
- 客服窗：透明度、位移和轻微缩放组合。
- 视图切换：小幅淡入与向上移动。
- 流式回答：三点跳动与逐字生成。
- 扫描线：模拟工业视觉检测过程。
- 卡片悬停：2px 至 5px 位移，配合边框和阴影变化。
- 系统检测到“减少动态效果”时，自动关闭长动画和过渡。

## 六、无障碍与容错

- 图标按钮提供 `aria-label` 或 `title`。
- 键盘可使用 Tab 聚焦，输入框支持 Enter 发送、Shift+Enter 换行。
- 颜色之外使用文字和结构表达状态。
- 输入长度、电话格式、文件大小和本地存储异常均有提示。
- 页面最小宽度 320px，390×844 视口无横向溢出。

## 七、正式上线建议

- 增加焦点锁定、Esc 关闭、消息实时播报和更完整的键盘导航。
- 对接企业设计系统、品牌字体和颜色令牌。
- 加入加载失败、网络中断、接口超时、重试和会话过期状态。
- 根据隐私要求提供授权、撤回、下载和删除数据入口。

技术支持：一秒互联公司 www.yimiaonet.com
