Files
beaver_project/docs/ui-ux
steven_li 2c5205b06e feat: 添加MinIO文件系统支持并优化外部连接器功能
- 添加MinIO用户文件系统配置选项(BEAVER_MINIO_ROOT_USER等)
- 更新外部连接器配置结构,包括BASE_URL和认证令牌设置
- 改进connector provider支持更多类型(official, feishu_bot等)
- 实现Mistral模型推理模式支持reasoning_effort参数
- 增强外部连接器策略配置和运行时配置管理
- 添加connector bridge事件验证和安全保护机制
- 优化任务路由逻辑,区分simple_chat和new_task场景
- 更新初始技能工具提示配置,分离authoring admin功能
2026-06-05 11:46:40 +08:00
..

Beaver UI/UX 页面维护文档

文档目的

本目录用于按页面持续维护 Beaver 前端的 UI/UX 结构与真实测试结论。

每一页需要记录:

  • 页面、子页、详情页、弹窗和主要状态。
  • 组件层级关系、视觉位置和响应式变化。
  • 每个可操作控件的触发方式、状态变化、反馈、UX 目的和异常恢复逻辑。
  • 多视口下的越界、重叠、滚动、触控目标和可访问性结论。
  • 已发现问题、优先级、代码位置和后续验收标准。

文档描述的是当前真实实现。建议设计与当前实现不一致时,必须明确标记为“待修复”,不能混写为已实现行为。

测试原则

每个页面至少执行以下检查:

  1. 页面身份、标题和首屏内容正确,无空白页或框架错误覆盖层。
  2. 320px375px390px768px1024px1365px 和宽屏视口检查布局。
  3. 至少检查一个手机横屏视口。
  4. 检查横向越界、内容裁切、组件重叠、嵌套滚动和固定元素遮挡。
  5. 真实点击或键盘操作每个主要控件,并验证状态变化。
  6. 检查加载、成功、失败、空数据、禁用和权限不足状态。
  7. 检查键盘顺序、焦点可见性、可访问名称、错误播报和触控目标尺寸。
  8. 截图和临时测试脚本默认保存在 /tmp,不提交到仓库。

问题等级

等级 定义
P0 阻断核心流程、页面不可用、数据安全或严重误操作风险
P1 核心流程明显受损、响应式严重异常、关键可访问性缺失
P2 可完成任务但体验、可发现性、触控或反馈质量不足
P3 视觉一致性、轻微布局或低风险优化项

页面清单

页面域 页面或状态 路由 文档 状态
认证门户 登录页 /login?next=... 登录页 已修复并复测通过
认证门户 注册页 /register?next=... 待创建 待测试
认证门户 注册后的模型配置子页 /register?next=... 注册成功后 待创建 待测试
主应用认证入口 登录跳转页 /login?next=... 待创建 待测试
主应用 对话工作台 / 对话工作台 已修复并复测通过
主应用 任务列表 /tasks Task 任务页 已修复并复测通过
主应用 任务详情 /tasks/[taskId] Task 任务页 已修复并复测通过
主应用 通知列表 /notifications 通知页 已修复并本地复测通过
主应用 通知详情 /notifications/[scheduledRunId] 通知页 已修复并本地复测通过
主应用 定时任务 /cron 待创建 待测试
主应用 技能列表与详情 /skills 技能页 已修复并复测通过
主应用 文件管理与预览 /files 文件页 已修复并复测通过
主应用 MCP 工具管理 /mcp 工具页 已修复并复测通过
主应用 智能体管理 /agents 待创建 待测试
主应用 Outlook /outlook Outlook 页 已修复并复测通过
主应用 技能市场与详情 /marketplace 市场页 已修复并复测通过
主应用 配置 /settings 配置页 已修复并复测通过
主应用 系统状态 /status 配置页 与配置页同实现,已复测通过
主应用 日志 /logs 待创建 待测试

当前测试环境

  • 浏览器自动化Playwright Chromium。
  • Browser 插件:本轮不可用,使用 Playwright fallback。
  • 登录页测试日期2026-06-04。
  • 登录页测试结果:自动化用例执行通过;所有实测视口无页面横向越界、无小点击目标、无首屏控件出界。
  • 对话工作台测试日期2026-06-04。
  • 对话工作台测试结果:自动化用例 4 passed;使用模拟 API 数据完成真实浏览器点击、键盘、响应式测量和截图;所有实测视口无页面横向越界、无可见小点击目标。
  • Task 任务页测试日期2026-06-04。
  • Task 任务页测试结果:自动化用例 14 passed;覆盖普通任务、定时任务、任务详情和缺省态;所有实测视口无页面横向越界、无可见小点击目标。
  • 通知页测试日期2026-06-04。
  • 通知页测试结果:本地自动化用例 4 passed;覆盖通知列表、通知详情、空态、错误态和回复交互;所有实测视口无页面横向越界、无可见小点击目标。
  • 技能页测试日期2026-06-04。
  • 技能页测试结果:本地与 terminaltest 自动化用例均 3 passed;覆盖候选操作、草稿评审操作和草稿页响应式;候选/草稿操作后不再回到已发布页,所有实测视口无页面横向越界、无可见小点击目标。
  • 文件页测试日期2026-06-04。
  • 文件页测试结果:本地与 terminaltest 自动化用例均 4 passed覆盖根目录空态、创建文件夹、目录切换、Markdown 预览、下载、删除、错误态和响应式;所有实测视口无页面横向越界、无可见小点击目标。
  • 工具页测试日期2026-06-04。
  • 工具页测试结果:本地与 terminaltest 自动化用例均 4 passed覆盖服务选择、工具详情、Tab 切换、Test、Add、Edit、Delete confirm、Refresh、JSON 错误、加载错误和响应式;所有实测视口无页面横向越界、无可见小点击目标。
  • Outlook 页测试日期2026-06-04。
  • Outlook 页测试结果:本地与 terminaltest 自动化用例均 4 passed覆盖已配置状态、overview 加载、Inbox、邮件详情、Calendar、日程详情、Settings、Test、Save、Disconnect confirm、状态错误和响应式所有实测视口无页面横向越界、无可见小点击目标。
  • 市场页与配置页测试日期2026-06-04。
  • 市场页与配置页测试结果:本地与 terminaltest 自动化用例均 4 passed覆盖市场搜索、详情、文件预览、安装、配置页智能体保存、Provider 保存、Feishu 通道保存、重启确认、状态错误和响应式;所有实测视口无页面横向越界、无可见小点击目标。