本文面向梦幻西游手游时空客户端相关的桌面自动化开发与使用场景。金手指的判断依赖当前窗口截图、窗口矩形、模板文件和可复核日志，具体表现会受到客户端画面、Windows 缩放、窗口位置及运行权限影响。下面只讨论当前项目代码中已经存在的结构和排查方法，不把示意图冒充软件截图，也不虚构用户案例、排名、收录量或效果数据。关键内容即使不加载图片也能通过正文理解。
先看模板和当前目标尺寸
先看模板和当前目标尺寸
模板分数低时首先比较模板原始尺寸与当前画面目标尺寸。Windows 缩放、客户端窗口大小和字体变化都会让同一个按钮产生不同像素尺寸。多尺度匹配可以覆盖一定比例变化，但模板过大、过小或比例失真时，继续扩大尺度列表并不能解决根本问题，应先确认采集到的目标是否完整。
再确认搜索区域覆盖目标
搜索区域决定哪些像素会参与比较。区域太小会裁掉按钮边缘、文字或图标，区域太大则会引入相似背景和其他候选。排查时在诊断图上画出窗口边界、客户区、搜索区域和目标框，确认区域坐标是相对于当前窗口，而不是旧的屏幕位置。
多尺度候选要有合理边界
多尺度候选应有合理的最小和最大比例，并跳过明显超过窗口尺寸的候选。每个比例都要记录实际模板宽高，避免只记录最终分数而看不到哪个尺度产生了命中。若不同尺度都给出相近低分，优先检查颜色通道、透明背景和截图时机，而不是立刻降低阈值。
阈值调整必须有误报复核
阈值是最后一层判断，不是修复坐标和素材错误的万能开关。降低阈值可能让背景纹理、相邻按钮或文字片段成为候选。调整后必须加入误报复核：命中框是否位于允许区域、尺寸是否合理、语义状态是否符合当前任务，并保留调整前后的诊断样本。
用诊断图而不是猜测修正
诊断图应包含原始截图、裁剪区域、模板候选、分数、尺度和最终选择。正文或日志中同时写出窗口矩形、DPI、模板文件名及异常信息，才能区分素材问题、路径问题、通道问题和算法阈值问题。修正完成后再用一个最小流程复核，不要直接回到长任务链。
排查时建议一次只改变一个条件，并保留窗口矩形、截图时间、识别框、匹配分数和最终动作。若要了解窗口移动后的相对识别，可阅读窗口相对识别说明；需要了解多尺度模板时，可参考多尺度模板匹配实践。
复核记录怎么写
模板文件的版本管理同样重要。更换素材后使用描述性文件名，并在日志中写出文件路径、尺寸和通道；不要在运行中静默覆盖同名文件。若需要比较两个模板，使用同一截图、同一区域和同一尺度，才能判断差异来自素材还是环境。
阈值记录应和样本绑定，而不是只写一个全局数字。对于每个候选保存分数、位置、宽高和是否通过语义复核，低分样本与误报样本都值得保留。真实项目中宁可先缩小范围并增加复核，也不要用一个过低阈值让所有相似区域都进入动作链。
模板排错完成后应把最终区域、尺度范围和阈值写入配置说明，并注明适用的窗口条件。后续修改代码时先阅读这些边界，避免为了一个样本扩大范围而影响其他任务。\n\n本节内容应与实际运行日志一起核对，页面文字用于说明方法，具体结果以当前环境中的截图、窗口信息和代码行为为准。\n\n排查结束后再恢复完整任务链，先确认当前窗口、当前阶段与当前模板条件没有变化。\n\n实际发布前还要检查标题、摘要、canonical、封面图、图注、站内链接、移动端换行和页面 HTTP 状态，发布后的 URL 以站点返回结果为准。