本文基于金手指项目当前可见的 Windows 窗口、截图识别、任务状态和日志结构整理。产品适配对象统一写作“梦幻西游手游时空客户端”。文章描述的是排查与开发方法，不把流程示意图当成真实软件界面，也不承诺固定结果。实际使用时，应以当前版本代码、真实窗口画面和本次运行日志为准。
先确认输入边界
桌面自动化的问题通常不是某一个坐标本身，而是输入证据已经发生变化。开始检查前，先写下程序版本、目标窗口标题、窗口句柄、外框矩形、客户区矩形、显示器编号、DPI 缩放、任务阶段和素材版本。窗口标题只能用于初筛；句柄、客户区和截图时间需要放在同一个上下文中。若目标窗口没有出现，应该记录“未找到窗口”并停在观察阶段，不要把上一轮的坐标或候选结果当作本轮输入。
记录与复核方法
每次只改变一个变量，并保留改变前后的值。例如先只重新选择窗口，再检查客户区；如果仍然失败，再检查截图区域或模板尺寸。日志至少记录采集时间、窗口矩形、裁剪区域、候选位置、识别分数、阈值、逻辑坐标、屏幕坐标、动作结果和下一状态。这样才能区分没有采到画面、采到但没有候选、命中后坐标换算错误和点击后状态没有变化。## 文件存在只是第一关
模板或图标能在目录中找到，不代表运行时一定能加载。发布前先核对配置引用的相对路径、部署后的绝对目录、文件名大小写、扩展名和工作目录。然后读取图片尺寸、颜色通道和文件签名，确认代码期望的格式与素材实际格式一致。路径错误、尺寸不匹配和通道顺序错误，往往会表现为“识别不到”，但修正阈值并不能解决。
版本与区域要一起检查
模板对应的窗口状态、缩放比例和裁剪区域必须有来源记录。若素材来自不同分辨率或不同界面阶段，应分别标注用途，不要把相似图片混在同一目录中。每次替换素材都记录旧文件、新文件、生成时间和验证截图；运行前先加载全部素材并输出成功或失败清单，再用空区域、遮挡区域和尺寸变化样本做负向验收。
发布验收
失败时任务应停在观察状态并写入清楚的错误路径。关键结论以文字和日志表达，图片只做辅助证据，避免把图片当成唯一配置说明。
实际执行清单
执行前再次核对适配对象名称、目标窗口、客户区坐标、素材版本和停止控制；执行中保留关键截图和日志；执行后确认状态字段、画面变化和资源释放。遇到空截图、候选为空、窗口移动或点击后无变化时，先回到观察状态，不用固定位置的兜底点击替代真实入口。以上信息应同时写入正文和日志，便于后续复核。
本文只总结当前项目可见代码和常见排查路径，不虚构用户案例、效果、排名或收录数据。版本、窗口布局和素材发生变化后，需要重新采集证据并更新检查清单。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。
补充复核：每次运行都应记录窗口、截图、候选、动作和结果，遇到异常先回到观察状态，再根据新的证据决定重新选择、重新采集、重新加载素材或结束阶段。