金手指面向梦幻西游手游时空客户端的桌面操作场景，关键判断建立在当前窗口截图、窗口矩形和可复核日志之上。下面的内容对应现有代码中的真实结构，重点是把一个容易被忽略的环节拆开说明。文章不把示意图当成软件截图，读者仍应以自己的窗口尺寸和实际日志为准。
重复点击通常是状态缺少边界
把动作看成状态转换
一个自动化动作不应只有‘找到按钮就点击’这一条路径。当前代码为重复动作保留动作键，并在动作前后记录观察与完成信息。动作键的价值是把一次点击与任务步骤对应起来，后续日志能看出是同一动作重试，还是流程真的进入了下一步。
观察要发生在重复动作之前
observe_before_repeating_action 用于在再次执行相同动作前检查状态。实际判断可以来自当前画面、动作历史或等待条件，核心是让程序先确认上一次动作是否已经产生预期变化。若画面没有变化，应该记录原因并重新截图，而不是无条件快速点击同一位置。
完成标记不能代替画面验证
mark_action_completed 只表示当前代码路径认为动作已完成，不等于外部界面一定完成。窗口切换、网络等待或弹窗遮挡都可能让点击落下但画面暂未更新。完成标记应与下一次截图、任务状态或明确的结果文字结合使用，避免把内部变量当成屏幕事实。
等待要可被停止事件打断
动作之间的等待用于给窗口和界面留出稳定时间，但等待不应让停止操作失去响应。当前安全点击器有 interruptible_sleep，并通过 stop_event 检查退出请求。长等待拆成短步进，既能等待画面稳定，也能在用户停止任务时尽快释放输入状态。
重复原因要按类别记录
如果同一动作连续出现，可能是识别分数不足、画面未稳定、完成条件过严或前台窗口变化。日志应区分动作键、当前步骤、最近一次匹配结果和停止状态。这样复盘时能判断是‘没找到所以重试’，还是‘已经完成却没有推进’，两者处理方向不同。
以最小可复现流程验证
测试时只保留一个目标窗口和一个动作，先观察一次成功推进，再模拟遮挡、延迟和停止请求。每次测试都保存同帧截图与状态日志，不用虚构成功率或效果数据。确认状态边界后，再把动作放回更长的梦幻西游手游时空客户端任务流程中。
排查时建议一次只改变一个条件：先固定窗口位置，再固定显示缩放，最后替换模板或调整阈值。每次复现都保留窗口矩形、截图时间点、匹配结果和最终动作，才能把视觉问题、坐标问题与状态问题区分开。若需要继续了解窗口相对识别，可阅读游戏窗口移动后的图像识别；多尺度匹配的背景见OpenCV 多尺度模板匹配实践。
现场验证清单
状态排错可以建立一个最小表格：动作键、进入前画面、执行的输入、等待条件、完成证据和下一步。动作键必须稳定，不能用随机文本或容易变化的截图名称代替。进入前如果已经看到完成态，就直接推进；如果看到中间态，就等待并重新截图；如果看到未知态，就记录当前画面并停止扩大动作范围。完成标记只在证据充分时写入，下一动作也要有自己的前置判断。这样做会让日志稍微变长，但能避免同一按钮在页面没有变化时被反复触发。对于梦幻西游手游时空客户端的连续任务，尤其要把任务切换、窗口切换和结果文字识别分别记为状态，不要把一次鼠标点击当成全部流程已经完成。
另外，所有判断都应以当前截图和当前窗口为准，旧日志只用于比较，不替代现场证据。
状态边界清楚后，再扩大到多个窗口和连续任务，避免把复杂流程中的偶发变化误判为单一点击问题。