阶段1：用户交互配置（收集核心参数）
|----------|-------------|--------|----------------------------------------------------------------------------------------------|-------------------------------------------|---------------------|
| 步骤编号 | 操作描述 | 组件 | 配置细节 | 输入/输出变量 | 说明 |
| 1.1 | 创建自定义对话框 | 自定义对话框 | • 标题：网页功能测试配置 • 尺寸：600×400px | - | 集中收集用户配置 |
| 1.2 | 选择测试模块（多选） | 多选框组 | • 选项：按页面实际模块填写（如首页、坐席监控、班长管理、工单管理...） • 绑定变量：test_status["selected_modules"] | 输出：selected_modules（如"班长管理", "知识库"） | 选项需与页面模块文本完全一致 |
| 1.3 | 正常截图根路径 | 文件夹选择框 | • 绑定变量：test_status["normal_root"] | 输出：normal_root（如"D:\测试\正常"） | - |
| 1.4 | 错误截图根路径 | 文件夹选择框 | • 绑定变量：test_status["error_root"] | 输出：error_root（如"D:\测试\错误"） | - |
| 1.5 | WPS配置 | 文本输入框 | • API密钥绑定：test_status["wps_api_key"]• 表格ID绑定：test_status["wps_table_id"] | 输出：WPS认证信息 | - |
| 1.6 | 初始化模块-子菜单映射 | 变量初始化 | • 变量：module_submenus_str（格式："模块1:子菜单1,子菜单2;模块2:子菜单A..."，如"班长管理:工号状态,语音信箱;知识库:知识查询..."） | 输出：module_submenus_str | 需与页面子菜单文本一致 |
| 1.7 | 显示对话框并确认 | 显示对话框 | • 模态显示，点击"确认"后生效 | - | 未勾选模块则提示"请选择至少一个模块" |
阶段2：文件夹预处理（确保存储路径）
|----------|-----------|--------|-------------------------------------|------------------------------|-----------------------------|
| 步骤编号 | 操作描述 | 组件 | 配置细节 | 输入变量 | 输出变量 |
| 2.1 | 获取当前日期 | 获取当前日期 | • 格式：YYYYMMDD | - | current_date（如"20251021"） |
| 2.2 | 拼接正常截图路径 | 文本拼接 | • 内容：{normal_root}/{current_date} | normal_root、current_date | normal_folder |
| 2.3 | 创建正常截图文件夹 | 创建文件夹 | • 路径：normal_folder，勾选"已存在不创建" | normal_folder | - |
| 2.4 | 拼接错误截图路径 | 文本拼接 | • 内容：{error_root}/{current_date} | error_root、current_date | error_folder |
| 2.5 | 创建错误截图文件夹 | 创建文件夹 | • 路径：error_folder | error_folder | - |
| 2.6 | 拼接错误日志路径 | 文本拼接 | • 内容：{error_folder}/logs | error_folder | error_log_folder |
| 2.7 | 创建错误日志文件夹 | 创建文件夹 | • 路径：error_log_folder | error_log_folder | - |
阶段3：网页自动化测试（核心遍历+定位）
|----------|---------------|---------------|---------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|----------------------------|
| 步骤编号 | 操作描述 | 组件 | 配置细节 | 输入变量 | 输出变量 |
| 3.1 | 打开目标网页 | 打开浏览器 | • 网址：目标系统URL，最大化窗口 | - | browser（浏览器实例） |
| 3.2 | 遍历选中的模块 | ForEach循环 | • 列表：selected_modules • 当前项：current_module（如"班长管理"） | selected_modules | current_module |
| 3.3 | 清洗模块名 | 文本替换 | • 替换规则：`\ / : * ? " < > | →_` | current_module |
| 3.4 | 提取当前模块的子菜单 | 文本处理 | 1. 分割module_submenus_str为["模块1:子菜单...", "模块2:子菜单..."] 2. 筛选含current_module的项→submenu_str 3. 分割submenu_str（冒号+逗号）→submenus | module_submenus_str、current_module | submenus（如"工号状态"...） |
| 3.5 | 遍历子菜单 | ForEach循环 | • 列表：submenus • 当前项：current_submenu（如"工号状态"） | submenus | current_submenu |
| 3.6 | 清洗子菜单名 | 文本替换 | • 同3.3，处理current_submenu | current_submenu | clean_submenu |
| 3.7 | 定位模块元素（展开按钮） | 获取相似元素列表(web) | • 网页：browser • XPath：//div[contains(@class, 'el-submenu__title') and text()='{``{current_module}}'] | browser、current_module | module_elements（元素列表） |
| 3.8 | 提取模块元素 | 获取列表指定位置项 | • 列表：module_elements，位置：0 • 容错：若列表为空，返回None | module_elements | target_module |
| 3.9 | 分支判断：模块元素是否存在 | 分支判断 | • 条件：target_module is not None | target_module | - |
| 3.10 | 点击模块（展开子菜单） | 点击元素(web) | • 网页：browser，目标：target_module • 点击方式：左键单击中心点 | browser、target_module | - |
| 3.11 | 等待子菜单加载 | 等待元素出现(web) | • XPath：//li[contains(@class, 'el-menu-item') and text()='{``{current_submenu}}'] • 超时：10秒 | browser、current_submenu | submenu_loaded（布尔值） |
| 3.12 | 定位子菜单元素 | 获取相似元素列表(web) | • XPath：//div[text()='{``{current_module}}']/following::ul//li[text()='{``{current_submenu}}'] | browser、current_module等 | submenu_elements（元素列表） |
| 3.13 | 提取子菜单元素 | 获取列表指定位置项 | • 列表：submenu_elements，位置：0 • 容错：若列表为空，返回None | submenu_elements | target_submenu |
| 3.14 | 点击子菜单（进入页面） | 点击元素(web) | • 网页：browser，目标：target_submenu | browser、target_submenu | - |
| 3.15 | 检测页面异常 | 组件组合 | 1. HTTP状态码→status_code 2. 控制台错误→console_errors 3. 页面标题→page_title 4. 内容长度→body_length 5. 异常汇总→is_error（布尔值）、error_reason | browser等 | is_error、error_reason |
阶段4：结果处理（区分正常/错误）
|----------|-----------|-----------|------------------------------------------------------------------------------------------------------------------|----------------------------|-------------------|
| 步骤编号 | 操作描述 | 组件 | 配置细节 | 输入变量 | 输出变量 |
| 4.1 | 初始化结果列表 | 变量初始化 | • 变量：test_results，初始值：空列表 | - | test_results |
| 4.2 | 正常场景：截图 | 网页截图(web) | • 路径：{normal_folder}/{clean_module}_{clean_submenu}_正常.png | browser、normal_folder等 | normal_img_path |
| 4.3 | 正常场景：记录结果 | 列表添加元素 | • 内容：{"模块": clean_module, "子模块": clean_submenu, "状态": "正常", "截图路径": normal_img_path, ...} | 相关变量 | test_results |
| 4.4 | 异常场景：截图 | 网页截图(web) | • 路径：{error_folder}/{clean_module}_{clean_submenu}_异常.png | browser、error_folder等 | error_img_path |
| 4.5 | 异常场景：生成日志 | 写入文本文件 | • 路径：{error_log_folder}/{clean_module}_{clean_submenu}_日志.txt • 内容：时间、模块、异常原因等 | 相关变量 | error_log_path |
| 4.6 | 异常场景：记录结果 | 列表添加元素 | • 内容：{"模块": clean_module, "子模块": clean_submenu, "状态": "错误", "截图路径": error_img_path, "异常原因": error_reason, ...} | 相关变量 | test_results |
阶段5：上传WPS表格
|----------|----------|--------------|---------------------------------------------------------|-------------------------------|---------------|
| 步骤编号 | 操作描述 | 组件 | 配置细节 | 输入变量 | 输出变量 |
| 5.1 | 生成WPS认证头 | 文本拼接 | • 内容："Token {``{wps_api_key}}" | wps_api_key | auth_header |
| 5.2 | 创建当日视图 | WPS多维表格-创建视图 | • 表格ID：wps_table_id• 视图名：current_date | wps_table_id、current_date | - |
| 5.3 | 遍历结果并上传 | ForEach循环+组件 | 1. 上传截图至WPS云存储→screenshot_url 2. 添加记录：模块、子模块、状态、截图链接等 | test_results、auth_header等 | - |
阶段6：流程结束
|----------|----------|--------|------------------------------------------------|----------------|--------|
| 步骤编号 | 操作描述 | 组件 | 配置细节 | 输入变量 | 说明 |
| 6.1 | 关闭浏览器 | 关闭浏览器 | • 实例：browser | browser | - |
| 6.2 | 提示测试完成 | 提示对话框 | • 内容："测试完成！结果已上传至WPS（视图：{``{current_date}}）" | current_date | - |