场景：AI直接input输入导致误触其他元素，应先click聚焦再input。

问题：页面同时存在多个可点击元素时，AI未先点击聚焦就直接输入，导致输入到错误位置。

原因：模型对"先聚焦再输入"的Web交互模式理解不足。

方案：修改step_generation.md提示词，增加规则"需要输入内容时，先click聚焦，再input输入"。

效果：此类场景通过率从~40%提升至~85%。

场景：操作执行成功后页面需要加载时间（跳转、加载列表）。

问题：下一步截图时页面尚在加载中，AI对中间态页面判断错误导致执行失败。

原因：操作成功后元素虽已变化但页面响应需要时间，AI截图时过早。

方案：操作执行成功后自动追加sleep等待步骤，确保下一轮截图时页面已稳定。

效果：页面跳转类场景通过率显著提升。

场景：执行完成后需要让操作人员直观了解执行结果。

问题：操作人员无法直接看到AI的判断结论（成功/失败及原因），需翻阅日志。

方案：最终返回时追加等待1秒步骤，在备注(des)字段展示AI的成功思考过程或失败原因。

效果：操作人员无需翻阅日志即可了解每条用例的执行结论，人工复核时间降低。

场景：页面存在多个相似元素（同名按钮、重复列表项），需精确定位。

问题：ifind定位到错误的同文本元素。

方案：提示词增加规则——多相似元素时使用cutBounds指定屏幕区域范围；IntentMapper将cutBounds参数透传给TestinPro限制查找范围。

场景：长列表/长页面需要特定距离滑动。

问题：默认滑动距离不适配当前页面，目标元素被划过或未到达。

方案：提示词增加movePoints规则，允许AI根据页面情况指定滑动起止坐标。

场景：审核人员需要了解AI每步操作的决策原因。

问题：脚本只有操作步骤，无法了解AI决策依据，提示词调优时需翻阅日志。

方案：将AI思考过程写入步骤备注(des)字段，格式："思考:[AI决策依据] 执行:[操作描述]"，审核人员直接在脚本列表中查看。

场景：权限弹窗、版本更新提示、首次使用引导——这些弹窗只在特定条件下出现。

问题：agent_click强制执行的步骤在回放时弹窗不出现则执行失败，导致脚本中断。

方案：新增if_click操作类型——"如果target存在则点击value"。回放时弹窗出现则自动处理，不出现则跳过。

效果：解决了"首次执行弹窗通过，回放时无弹窗却失败"的经典问题。

场景：需要拖拽排序、鼠标悬停、键盘快捷键(CTRL+C等)、系统命令(adb/hdc)等复杂操作。

方案：新增操作类型——drag(拖拽)、hover(悬停)、press_key(键盘按键)、func_key(功能键)、pc_cmd/hdc_cmd/adb_cmd(系统命令)、assign(变量赋值)、call_script(调用子脚本)。

场景：长列表页面需多次滑动才能找到目标元素。

问题：AI生成多次滑动+查找步骤，回放时若元素不在预期位置则全部失败。

方案：后处理阶段合并多次滑动为"滑动直到找到XX元素"的复合操作，使用统一movePoints轨迹，TestinPro自动循环直到找到目标。

效果：长列表场景回放稳定性大幅提升。

场景：需要验证"确认XX提示""验证XX显示"等页面状态断言。

问题：assert使用ifind精确文本匹配，动态页面细微差异（多余空格、换行等）直接判定失败。

方案：新增agent_assert操作类型，使用AI视觉判断替代精确文本匹配，提示词中强化断言使用指导。

效果：大幅减少因文本格式细微差异导致的误判失败。

（此案例为DOCX中的空白模板，用于记录新的客户问题场景）

场景：___   问题：___   原因：___   方案：___   效果：___