SmartOnmyoji阴阳师自动化脚本使用指南

SmartOnmyoji是一款基于Python开发的开源游戏自动化工具，专为《阴阳师》及类似卡牌手游玩家设计。通过智能图像识别技术，实现游戏内自动找图、精准点击、后台运行等核心功能，完美支持模拟器多开，让玩家告别重复操作。

核心功能特性

多场景自动作战

脚本支持御魂、觉醒、探索、魂土等核心玩法的自动化操作，内置多种游戏场景模板。用户可以根据不同游戏模式选择对应的图片模板文件夹，无需手动配置即可快速启动。

后台运行与多开支持

脚本无需游戏窗口置顶，最小化状态下仍可稳定运行。通过ModuleHandleSet.py模块支持同时管理多个游戏窗口，配合模拟器多开功能，实现"一机多号"同步操作。

全模拟器兼容

完美兼容雷电、MuMu、夜神等主流安卓模拟器，通过ADB协议实现跨设备控制。不仅限于阴阳师，任何需要重复点击的手游均可适配。

安装与配置

环境准备

1. 安装Python 3.7.6或更高版本
2. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/smar/SmartOnmyoji
3. 安装依赖库：pip install -r requirements.txt

快速开始

1. 运行主程序：python smart_onmyoji_start.py
2. 选择使用的客户端（阴阳师桌面版或模拟器）
3. 选择单开或多开模式
4. 点击"选择窗体"获取游戏窗口句柄
5. 选择目标场景模式（如御魂）
6. 调整运行参数后点击"开始匹配"

使用技巧与注意事项

防检测机制

脚本采用多种防检测技术：

• 随机坐标偏移：通过ModuleDoClick.py模块生成随机点击偏移量
• 正态分布点击模型：模拟人类点击行为模式
• 随机等待时间：避免机械重复操作
• 日志分析功能：通过click_log记录分析点击行为

自定义场景配置

用户可以自定义游戏场景：

1. 将游戏截图保存至对应场景文件夹（如img/huntu/）
2. 通过数字前缀设置点击优先级
3. 配置img_pos.json文件设置特殊标记

性能优化建议

• 压缩率设置在0.6左右平衡准确率和速度
• 特征点匹配适配不同分辨率但速度较慢
• 模板匹配速度快但要求图片完全一致
• 多开模式建议使用较高配置设备

技术原理

图像识别技术

通过ModuleImgProcess.py的SIFT特征匹配算法快速识别游戏界面元素。即使在不同的分辨率和缩放比例下，仍能保持较高的识别准确率。

智能点击系统

ModuleDoClick.py模块实现人类点击行为模拟，包括：

• 随机偏移点击
• 正态分布模型
• 区域随机点击
• 轨迹混淆算法

异常处理机制

• 实时日志记录（modules/click_log/）
• 异常提示音（modules/sounds/warming.wav）
• 连续错误自动停止
• 网络延迟自适应

常见问题解决

模拟器连接问题

检查ADB服务是否启动，尝试重启模拟器或运行adb devices命令确认连接状态。

匹配失败处理

• 确保截图清晰且存放至正确目录
• 尝试使用特征点匹配方法
• 检查游戏分辨率是否变化
• 切换为兼容模式测试

性能优化

如果运行速度较慢，可以：

• 调整图片压缩率
• 减少匹配间隔时间
• 关闭不必要的日志记录
• 使用模板匹配替代特征点匹配

安全使用建议

1. 避免高强度连续使用（建议每天不超过300次）
2. 适当使用游戏内樱饼功能
3. 定期更换点击参数和等待时间
4. 避免在官方活动期间过度使用
5. 关注游戏官方公告和政策变化

项目结构说明

• img/：各场景图片模板目录
• modules/：核心功能模块
  • ModuleImgProcess.py：图像处理模块
  • ModuleDoClick.py：点击控制模块
  • ModuleHandleSet.py：窗口管理模块
  • config.ini：配置文件
• smart_onmyoji_start.py：主程序入口

SmartOnmyoji作为学习项目开发，虽然作者已不再维护，但代码结构清晰，注释完整，适合Python初学者学习和参考。使用时请遵守游戏规则，适度使用自动化工具。