'commit'

Apps/XinDianTu/Doc/流程说明.md

@@ -69,6 +69,12 @@
 - 中文路径与空文件校验：`Kit.py` 统一图片读写与校验，避免并发读写导致崩溃。
 - 异步任务清理：每页结束清理已完成任务，最终 `asyncio.gather` 等待残余任务，防止内存堆积。
 
+### 3.7 模板匹配与设备一致性（关键建议）
+- **识别原理**：使用 `d.image.click` 等基于 OpenCV 的图形学匹配方法时，本质上是像素级的特征对齐。
+- **设备差异性**：不同手机的**屏幕分辨率**、**像素密度 (DPI)** 以及 **UI 缩放比例** 存在显著差异。同一张按钮截图（如 `qbsd.jpg`）在 A 设备上能匹配成功，但在 B 设备上可能因像素尺寸微调或渲染差异而识别失败。
+- **一机一策**：在实际生产环境中，建议遵循“一机一议”原则。即针对不同的处理机（或同款但配置不同的手机），应分别采集对应的模板图片，确保匹配精度。
+- **优化方案**：建议将模板文件按设备分辨率或型号分类存放（如 `Template/1080x2400/qbsd.jpg`），或者在无法匹配时使用视觉大模型（VL）作为兜底定位方案。
+
 ---
 
 ## 4. 数据持久化