本文基于金手指项目当前可见的 Windows 窗口、截图识别、任务状态和日志结构整理。产品适配对象统一写作“梦幻西游手游时空客户端”。文章描述的是排查与开发方法，不把流程示意图当成真实软件界面，也不承诺固定结果。实际使用时，应以当前版本代码、真实窗口画面和本次运行日志为准。
先确认输入边界
桌面自动化的问题通常不是某一个坐标本身，而是输入证据已经发生变化。开始检查前，先写下程序版本、目标窗口标题、窗口句柄、外框矩形、客户区矩形、显示器编号、DPI 缩放、任务阶段和素材版本。窗口标题只能用于初筛；句柄、客户区和截图时间需要放在同一个上下文中。若目标窗口没有出现，应该记录“未找到窗口”并停在观察阶段，不要把上一轮的坐标或候选结果当作本轮输入。
记录与复核方法
每次只改变一个变量，并保留改变前后的值。例如先只重新选择窗口，再检查客户区；如果仍然失败，再检查截图区域或模板尺寸。日志至少记录采集时间、窗口矩形、裁剪区域、候选位置、识别分数、阈值、逻辑坐标、屏幕坐标、动作结果和下一状态。这样才能区分没有采到画面、采到但没有候选、命中后坐标换算错误和点击后状态没有变化。## 句柄失效的典型表现
窗口重启后，旧句柄可能仍然保留在日志里，但它已经不再代表当前画面。窗口被最小化、权限级别变化或客户端重新创建客户区时，也可能出现句柄可读而截图为空的情况。排查时先重新枚举可见窗口，按标题、进程关系和客户区尺寸做候选过滤，再把新句柄写入当前运行上下文。不要只比较标题，因为同一应用可能同时存在多个窗口。
重新选择后的三步校验
第一步检查句柄是否仍可访问，并记录窗口是否可见、是否最小化；第二步获取外框和客户区矩形，确认客户区宽高为正且位于合理显示器范围；第三步截取一帧原始画面，检查尺寸、颜色通道和时间戳。三步都通过后，才重新计算相对区域和点击坐标。句柄更新后，先回到观察状态，重新确认任务阶段，再决定从等待窗口、识别入口还是人工确认点继续。
多窗口恢复
多窗口任务需要逐个保存句柄和阶段，不能用一个窗口的恢复结果覆盖其他窗口。每个窗口都要重新取得客户区和截图证据，恢复时记录旧句柄、新句柄、选择原因和第一帧画面。
实际执行清单
执行前再次核对适配对象名称、目标窗口、客户区坐标、素材版本和停止控制；执行中保留关键截图和日志；执行后确认状态字段、画面变化和资源释放。遇到空截图、候选为空、窗口移动或点击后无变化时，先回到观察状态，不用固定位置的兜底点击替代真实入口。以上信息应同时写入正文和日志，便于后续复核。
本文只总结当前项目可见代码和常见排查路径，不虚构用户案例、效果、排名或收录数据。版本、窗口布局和素材发生变化后，需要重新采集证据并更新检查清单。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。