Files
QuestionProject/ai_knowledge_base_v2/design-qa.md

6.4 KiB
Raw Permalink Blame History

用户端聊天页设计验收

对照范围

  • 参考图:/Users/nelson/Downloads/ChatGPT Image 2026年7月11日 16_21_34.png
  • 实际页面:http://127.0.0.1:5173/
  • 主要对照尺寸390 × 844
  • 补充响应式尺寸375 × 667、414 × 896
  • 对照截图:test_records/screenshots/用户端聊天页设计对照.png

验收结果

视觉层级

  • 顶部菜单、助手名称、连接状态、用户信息和退出按钮层级清楚。
  • 当前会话额度使用紧凑浅绿色横条,真实展示 todayUsed/dailyLimit
  • 用户消息为右侧绿色气泡AI 回复为左侧白色阅读卡片。
  • 长文本标题、段落、列表、粗体和引用层级清楚,未显示 Markdown 原始符号。
  • 底部输入区固定且不遮挡消息区。
  • 历史会话使用左侧抽屉和独立遮罩,不再呈现为后台固定列表。

交互状态

  • 已验证空会话、真实消息发送、生成中、回答完成和额度刷新。
  • 已验证抽屉打开、关闭、遮罩、改名弹窗和删除确认弹窗。
  • 已验证输入框发送失败保留、成功后清空的实现逻辑。
  • 已验证模型嵌套 <think> 内容和残留标签不展示。
  • 已验证当前会话时间、会话消息数量和会话更新时间来自真实接口。

移动端适配

  • 375px、390px、414px 宽度均无横向滚动。
  • 顶部栏固定在应用容器顶部,底部输入区贴合视口底部。
  • 中间消息列表独立滚动,长回答完整展示。
  • 输入框字号为 16px并处理底部安全区。
  • 小高度 667px 下页面未截断,核心操作始终可见。

工程检查

  • npm run build:通过。
  • Vue TypeScript 类型检查:通过(包含在构建命令中)。
  • 390 × 844 最终浏览器控制台错误和警告0。
  • 浏览器页面宽度与视口宽度一致390/390。
  • 未发现 P0、P1、P2 级视觉或交互问题。

设计取舍

参考图底部的水墨和莲花属于可选氛围元素。当前版本采用纯雾白背景,优先保证长回答阅读清晰度、加载性能和维护成本,不引入与业务无关的装饰图片。

final result: passed


后台登录页视觉重构验收2026-07-13

对照范围

  • 设计参考:/Users/nelson/Downloads/ChatGPT Image 2026年7月13日 17_18_22.png
  • 桌面最终截图:test_records/screenshots/后台登录页_桌面_最终.png
  • 移动端最终截图:test_records/screenshots/后台登录页_移动端_最终.png
  • 桌面视口1616 × 973移动端视口390 × 844。

比较历史

  • [P1] 原页面采用深绿色大色块和普通后台模板式卡片,品牌层级、东方气质和设计参考偏差明显。
  • 修复后使用雾白与浅雾绿色作为底色,左右分栏比例、圆角、留白、轻阴影和墨绿色文字层级均按参考方向重建。
  • 左侧加入代码生成的品牌纹样、圆环、点阵、波浪与莲花线稿;右侧保持单一账号密码登录路径,没有增加其他登录方式。
  • 首轮浏览器实装对照未发现 P0、P1、P2 级视觉问题,无需额外回退或遮盖性修补。

必查视觉面

  • 字体与排版:品牌、主文案、说明、功能标签和表单建立清晰层级,中文长文案无异常折行或截断。
  • 间距与布局:桌面登录容器为 1544 × 886左右区域对齐390px 移动端隐藏品牌区并保持单栏表单。
  • 颜色与设计令牌:采用浅灰白、浅雾绿、深墨绿和低饱和高级绿色,不包含亮绿或蓝紫渐变。
  • 图片与资源:登录区域图片元素数量为 0CSS url() 背景数量为 0全部装饰由 CSS 与内联 SVG 生成。
  • 响应式:桌面 bodyScrollWidth/viewportWidth=1616/1616,移动端为 390/390,无横向滚动。

交互与工程检查

  • 管理员账号与密码输入、密码可见切换、提交 loading 和错误提示仍复用原组件逻辑。
  • 使用本地管理员账号完成真实登录,成功进入“数据看板”,随后退出并恢复登录页。
  • npm run build通过Vue TypeScript 类型检查与 Vite 生产构建均通过)。
  • 未新增依赖未修改后端接口、Token 保存或登录后跳转实现。

final result: passed


用户管理“启用”开关修复验收2026-07-13

对照范围

  • 视觉问题参考:test_records/screenshots/用户管理启用开关_问题参考.png
  • 桌面完整页面:test_records/screenshots/用户管理启用开关_桌面全页.png
  • 桌面修复截图:test_records/screenshots/用户管理启用开关_桌面修复后.png
  • 窄屏修复截图:test_records/screenshots/用户管理启用开关_窄屏修复后.png
  • 桌面视口1338 × 768
  • 响应式视口820 × 768
  • 页面状态:用户管理 / 手动添加学员 / 启用状态

完整视图与重点区域证据

  • 完整视图确认手动添加区、批量导入区和用户列表未因修复发生结构变化。
  • 重点区域对照确认“有效期”和“启用”分别占据独立网格单元,两者桌面间距为 10px。
  • 两个字段均为 40px 高并垂直对齐;开关固定靠右,标签不换行、不挤压。
  • 820px 视口下两个字段改为上下整行排列,页面 bodyScrollWidth=805,没有由该表单产生横向溢出。

比较历史

  • [P1] 修复前:通用 .record-date-field 的固定 210px 宽度覆盖用户表单宽度,日期字段跨入第三列并与“启用”重叠。
  • 修复:使用 .student-form-grid .student-expiry-field 限定有效期宽度为当前网格单元的 100%;新增独立 .student-status-field,统一高度、边框、内边距和开关对齐。
  • 修复后:有效期右边界为 605.52px,启用字段左边界为 615.52px,准确保留 10px 网格间距。

必查视觉面

  • 字体与排版:沿用现有后台字体和 13px 字段标签,未发生异常换行。
  • 间距与布局:桌面三列对齐,窄屏单列对齐,字段高度均为 40px。
  • 颜色与设计令牌:沿用现有输入框边框、白色背景和 Element Plus 状态色。
  • 图片与资源:本次为原生表单控件修复,不涉及图片替换或新增图像资产。
  • 文案:保留“启用”,新增无障碍名称“启用学员账号”。

交互与工程检查

  • 可见开关点击后 aria-checkedtrue 变为 false,再次点击恢复 true
  • 浏览器控制台错误0。
  • npm run build:通过。
  • 未发现剩余 P0、P1、P2 问题。

final result: passed