yysScript：阴阳师御魂副本自动化解决方案

项目概述

yysScript是一款基于Python开发的自动化脚本工具，专为阴阳师游戏设计，通过图像识别技术实现御魂副本的自动挑战。该工具采用非侵入式设计，不修改游戏内存数据，仅通过屏幕图像识别与鼠标模拟操作实现自动化流程，确保账号安全的同时提高游戏资源获取效率。

技术原理

图像识别机制

yysScript核心采用模板匹配算法（Template Matching）实现游戏界面元素的识别与定位。系统通过预存的界面元素样本图像（位于yys/img/目录）与实时游戏画面进行比对，计算归一化互相关系数（NCC）确定匹配度，当匹配值超过阈值（默认0.85）时判定为有效识别。

图像识别流程包含以下关键步骤：

1. 游戏窗口捕获：使用OpenCV的cv2.VideoCapture接口获取指定窗口画面
2. 预处理：对图像进行灰度转换、高斯模糊等操作降低噪声干扰
3. 多尺度匹配：在不同缩放比例下执行模板匹配以适应窗口分辨率变化
4. 非极大值抑制：消除重叠匹配区域，获取唯一最优匹配结果

图1：yysScript运行界面展示，包含双开控制窗口、日志输出及游戏客户端实例

实现架构

模块设计

系统采用模块化架构设计，主要包含以下核心组件：

• Window模块：提供图形用户界面，实现任务控制与状态展示
• YuHunModule模块：御魂副本自动化核心逻辑实现
• EncryptModule模块：提供配置文件加密与授权验证功能
• 图像资源管理：维护游戏界面元素样本库，支持动态更新

多线程架构

为支持多开功能，系统采用多线程设计：

• 主线程：负责UI渲染与用户交互
• 工作线程：每个游戏实例对应独立线程，执行图像识别与操作模拟
• 日志线程：异步处理运行日志记录，避免阻塞主流程

安装与配置

环境要求

• 操作系统：Windows 7/10/11（64位）
• Python环境：3.6+（推荐3.8版本）
• 依赖库：OpenCV-Python 4.5+、PyAutoGUI 0.9.53+、PyQt5 5.15+
• 游戏环境：阴阳师官方PC端或兼容安卓模拟器

部署步骤

1. 克隆项目仓库

git clone https://gitcode.com/gh_mirrors/yy/yysScript
cd yysScript

2. 安装依赖包

pip install -r requirements.txt

3. 启动应用

# 方式一：直接运行可执行文件
yys/Window.exe

# 方式二：Python源码运行
python yys/Window.py

高级配置

多开设置

在config.ini中配置多开参数：

[MultiInstance]
max_instances = 2  # 最大实例数
instance_interval = 3  # 实例启动间隔（秒）

识别精度优化

调整图像识别参数提升匹配准确性：

# YuHunModule.py 中调整匹配阈值
MATCH_THRESHOLD = 0.88  # 提高阈值增强匹配严格度
SCAN_SCALES = [0.9, 1.0, 1.1]  # 增加缩放比例覆盖更多场景

故障排查

常见问题解决

1. 识别失败

   • 检查游戏窗口分辨率是否为1920x1080
   • 更新yys/img/目录下的图像样本
   • 调整匹配阈值参数

2. 点击偏差

   • 执行calibrate.py重新校准屏幕坐标
   • 检查是否启用了系统缩放（建议设置为100%）

3. 多开卡顿

   • 降低同时运行的实例数量
   • 关闭游戏内高画质设置
   • 增加实例启动间隔时间

日志分析

运行日志位于logs/目录，通过分析日志可定位问题：

2023-09-28 12:36:05 [INFO] 开始识别挑战按钮
2023-09-28 12:36:06 [WARNING] 未找到匹配元素: tiaozhan.jpg
2023-09-28 12:36:06 [INFO] 重试识别（第2次）

性能优化

资源占用控制

通过以下方式降低系统资源消耗：

• 减少截图频率（默认300ms/次，最低可设为100ms）
• 缩小识别区域，仅检测关键界面元素
• 采用灰度图像进行匹配，降低计算量

运行效率提升

• 预加载所有模板图像到内存
• 使用多进程处理图像识别任务
• 实现识别结果缓存机制，避免重复计算

安全与维护

账号安全建议

• 避免使用第三方辅助工具同时运行
• 控制单次连续运行时间（建议每2小时重启一次）
• 定期修改游戏账号密码

版本维护

• 关注官方更新通知，及时同步图像样本库
• 定期备份config.ini和自定义图像资源
• 通过git pull获取最新功能与安全补丁

总结

yysScript通过成熟的图像识别技术与模块化架构设计，为阴阳师玩家提供了可靠的御魂副本自动化解决方案。其非侵入式设计确保了账号安全，多开功能提升了资源获取效率，而开放的架构也为技术爱好者提供了二次开发的可能性。合理使用该工具能够有效平衡游戏娱乐与时间管理，实现健康游戏的目标。

项目遵循MIT开源协议，欢迎社区贡献代码与改进建议，共同提升工具的稳定性与功能丰富度。