# Beaver UI/UX 页面维护文档

## 文档目的

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

每一页需要记录：

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

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

## 测试原则

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

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

## 问题等级

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

## 页面清单

| 页面域 | 页面或状态 | 路由 | 文档 | 状态 |
| --- | --- | --- | --- | --- |
| 认证门户 | 登录页 | `/login?next=...` | [登录页](./pages/auth-login.md) | 已修复并复测通过 |
| 认证门户 | 注册页 | `/register?next=...` | 待创建 | 待测试 |
| 认证门户 | 注册后的模型配置子页 | `/register?next=...` 注册成功后 | 待创建 | 待测试 |
| 主应用认证入口 | 登录跳转页 | `/login?next=...` | 待创建 | 待测试 |
| 主应用 | 对话工作台 | `/` | [对话工作台](./pages/chat-workbench.md) | 已修复并复测通过 |
| 主应用 | 任务列表 | `/tasks` | [Task 任务页](./pages/task-management.md) | 已修复并复测通过 |
| 主应用 | 任务详情 | `/tasks/[taskId]` | [Task 任务页](./pages/task-management.md) | 已修复并复测通过 |
| 主应用 | 通知列表 | `/notifications` | [通知页](./pages/notifications.md) | 已修复并本地复测通过 |
| 主应用 | 通知详情 | `/notifications/[scheduledRunId]` | [通知页](./pages/notifications.md) | 已修复并本地复测通过 |
| 主应用 | 定时任务 | `/cron` | 待创建 | 待测试 |
| 主应用 | 技能列表与详情 | `/skills` | [技能页](./pages/skills.md) | 已修复并复测通过 |
| 主应用 | 文件管理与预览 | `/files` | [文件页](./pages/files.md) | 已修复并复测通过 |
| 主应用 | MCP 工具管理 | `/mcp` | [工具页](./pages/mcp-tools.md) | 已修复并复测通过 |
| 主应用 | 智能体管理 | `/agents` | 待创建 | 待测试 |
| 主应用 | Outlook | `/outlook` | [Outlook 页](./pages/outlook.md) | 已修复并复测通过 |
| 主应用 | 技能市场与详情 | `/marketplace` | [市场页](./pages/marketplace.md) | 已修复并复测通过 |
| 主应用 | 配置 | `/settings` | [配置页](./pages/settings.md) | 已修复并复测通过 |
| 主应用 | 系统状态 | `/status` | [配置页](./pages/settings.md) | 与配置页同实现，已复测通过 |
| 主应用 | 日志 | `/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 通道保存、重启确认、状态错误和响应式；所有实测视口无页面横向越界、无可见小点击目标。