OnmyojiAutoScript中石距功能异常的技术分析与解决方案

问题现象描述

在OnmyojiAutoScript项目运行过程中，当用户尝试执行石距副本功能时，系统在进入组队界面后出现了异常行为。具体表现为脚本不断循环点击石距组队列表，但无法正常进入下一步操作流程。

技术分析

从日志中可以观察到几个关键的技术细节：

1. OCR识别异常：日志显示系统将"石距"错误地识别为"石距#"，这个额外的"#"符号导致了后续的匹配失败。

2. 点击循环：系统在检测到"石距#"后，持续在坐标(254,400)附近进行点击操作，共重复了15次，最终触发了防呆机制"Too many click for a button"错误。

3. UI状态检测：系统能够正确识别当前处于"page_team"页面，但在处理特定副本选择时出现了问题。

根本原因

经过深入分析，该问题的根本原因在于：

1. OCR预处理不足：当前的OCR模块在处理游戏界面文字时，未能有效过滤特殊字符，导致识别结果包含不应存在的"#"符号。

2. 字符串匹配逻辑不严谨：在副本选择逻辑中，系统使用了严格的字符串匹配方式，未能考虑到OCR可能引入的额外字符。

3. 容错机制缺失：当OCR识别出现偏差时，系统缺乏有效的容错处理机制，导致进入无效点击循环。

解决方案

针对上述问题，建议采取以下改进措施：

1. OCR结果后处理：

   • 添加结果清洗逻辑，自动去除识别结果中的非文字符号
   • 实现模糊匹配算法，提高对OCR误差的容忍度

2. 增强字符串匹配：

   • 改用包含(in)操作而非全等(==)比较
   • 实现基于相似度的匹配算法，如编辑距离

3. 完善错误处理：

   • 添加OCR结果验证机制
   • 设置合理的重试次数限制
   • 增加异常情况的明确提示

实现建议

对于开发者而言，具体的代码改进可以集中在以下几个部分：

1. 修改副本识别模块，增加字符串清洗步骤：

def clean_ocr_text(text):
    # 移除所有非中文字符和数字
    return re.sub(r'[^\u4e00-\u9fa5\d]', '', text)

2. 更新匹配逻辑，使用更灵活的比较方式：

if "石距" in cleaned_text:
    # 执行石距相关操作

3. 添加重试机制和错误处理：

max_retries = 3
retry_count = 0

while retry_count < max_retries:
    text = ocr.detect()
    if "石距" in clean_ocr_text(text):
        break
    retry_count += 1
else:
    raise RuntimeError("无法识别石距副本")

总结

OnmyojiAutoScript中石距功能异常的问题展示了自动化脚本开发中常见的OCR处理挑战。通过增强OCR结果的清洗和验证、改进字符串匹配算法、完善错误处理机制，可以有效提升脚本的鲁棒性。这类问题的解决不仅限于当前案例，也为处理游戏中其他基于文字识别的功能提供了可复用的解决方案模式。开发者应当重视自动化测试中OCR环节的可靠性建设，这是保证脚本长期稳定运行的关键因素之一。