steven_li
2c5205b06e
- 添加MinIO用户文件系统配置选项(BEAVER_MINIO_ROOT_USER等) - 更新外部连接器配置结构，包括BASE_URL和认证令牌设置 - 改进connector provider支持更多类型(official, feishu_bot等) - 实现Mistral模型推理模式支持reasoning_effort参数 - 增强外部连接器策略配置和运行时配置管理 - 添加connector bridge事件验证和安全保护机制 - 优化任务路由逻辑，区分simple_chat和new_task场景 - 更新初始技能工具提示配置，分离authoring admin功能
6.4 KiB
6.4 KiB
Beaver UI/UX 页面维护文档
文档目的
本目录用于按页面持续维护 Beaver 前端的 UI/UX 结构与真实测试结论。
每一页需要记录：
- 页面、子页、详情页、弹窗和主要状态。
- 组件层级关系、视觉位置和响应式变化。
- 每个可操作控件的触发方式、状态变化、反馈、UX 目的和异常恢复逻辑。
- 多视口下的越界、重叠、滚动、触控目标和可访问性结论。
- 已发现问题、优先级、代码位置和后续验收标准。
文档描述的是当前真实实现。建议设计与当前实现不一致时，必须明确标记为“待修复”，不能混写为已实现行为。
测试原则
每个页面至少执行以下检查：
- 页面身份、标题和首屏内容正确，无空白页或框架错误覆盖层。
- 在
320px、375px、390px、768px、1024px、1365px和宽屏视口检查布局。 - 至少检查一个手机横屏视口。
- 检查横向越界、内容裁切、组件重叠、嵌套滚动和固定元素遮挡。
- 真实点击或键盘操作每个主要控件，并验证状态变化。
- 检查加载、成功、失败、空数据、禁用和权限不足状态。
- 检查键盘顺序、焦点可见性、可访问名称、错误播报和触控目标尺寸。
- 截图和临时测试脚本默认保存在
/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 通道保存、重启确认、状态错误和响应式；所有实测视口无页面横向越界、无可见小点击目标。