RPA脚本健康检查指南：数字员工定期更新与维护测评
## 定位并验证CSS选择器的当前状态
保持浏览器开发者工具（F12）的Elements面板开启，使用Ctrl+F调出页面内搜索框，输入脚本中使用的CSS选择器（例如 `#user-status-badge` 或 `.ant-table-row:nth-child(3)`）。若搜索结果数量显示为0，则表明对应DOM元素已不存在，脚本执行时极有可能抛出 `ElementNotInteractableException` 或 `NoSuchElementException` 错误。
**关键操作提示**：此项检查务必在已登录的实际账户会话中进行。登录前后的页面DOM结构常存在显著差异，使用未登录状态下的页面源码进行验证将导致结果失真。
## 核验核心API接口的响应数据规范
建议通过以下任一方式完成验证：1) 使用Postman等工具直接重放脚本涉及的HTTP请求，逐一核验响应体中关键字段（如 `data.healthScore`）的存在性、数据类型（确保仍为number而非string）及数据结构完整性。2) 在脚本的HTTP请求逻辑后增加一行调试日志，实时输出 `response.json()` 的完整内容，将其与历史存档的快照进行比对，重点观察数据嵌套层级、字段命名及空值表示方式是否发生变化。
**注意一个典型陷阱**：部分API可能在返回HTTP状态码200的同时，在业务层级通过 `{"code":5001,"msg":"接口已下线"}` 等结构标记实际失败。因此，必须同时检查HTTP状态码与响应体中的业务状态码字段。
## 重新评估脚本中的超时与等待阈值
首先，在代码中定位所有设置了 `timeout`、`wait`、`max_retries` 等参数的变量。随后，登录QoderWake管理后台，进入「任务执行日志」，筛选近7天内同数字员工的运行记录，计算并记录「单次执行耗时」的P95分位值。例如，若脚本中设定 `MAX_WAIT_SECONDS = 30`，而实际P95耗时已达42秒，则须立即上调该阈值，否则将持续触发“超时失败”的误判。调整后，请在测试环境完成至少3次完整流程测试，以确认新阈值生效且无误判。
## 审查SDK版本与平台内核的兼容性
检查脚本文件头部import语句或项目依赖文件（如requirements.txt）中指定的 `qoderwake-sdk` 版本号（例如 `qoderwake-sdk==2.1.4`）。前往QoderWake官方文档的「版本兼容性矩阵」页面，查询该SDK版本所支持的最低与最高平台内核版本范围。最后，登录QoderWake控制台，在页面右下角点击「关于」，获取当前实际运行的平台版本号（如v3.8.0）。若平台已升级至v3.9.2，而所用SDK版本仅支持到v3.7.x，则必须升级SDK版本以匹配，平台版本通常不允许进行降级操作。