当前位置：首页 > news >正文

OnmyojiAutoScript：阴阳师自动化脚本的技术实现与应用指南

news 2026/6/3 14:17:16

OnmyojiAutoScript：阴阳师自动化脚本的技术实现与应用指南

【免费下载链接】OnmyojiAutoScriptOnmyoji Auto Script | 阴阳师脚本项目地址: https://gitcode.com/gh_mirrors/on/OnmyojiAutoScript

OnmyojiAutoScript（简称OAS）是一个专门为《阴阳师》手游设计的Python自动化脚本框架，通过图像识别和任务调度技术实现游戏操作的自动化处理。该项目采用模块化架构，支持20多个游戏任务的智能执行，为玩家提供了高效的游戏辅助解决方案。

技术架构与核心价值

模块化设计理念

OAS采用分层架构设计，将不同功能模块进行清晰分离，确保系统的可维护性和扩展性。核心架构包含以下层次：

任务执行层 (Task Layer) ├── 深渊暗域模块 (AbyssShadows) ├── 地域鬼王模块 (AreaBoss) ├── 探索副本模块 (Exploration) ├── 御魂副本模块 (Orochi) └── 其他20+任务模块 核心服务层 (Core Service Layer) ├── 设备控制模块 (device/) ├── 配置管理模块 (config/) ├── 图像识别模块 (ocr/) └── 任务调度模块 (scheduler/) 基础设施层 (Infrastructure Layer) ├── 日志系统 (logger.py) ├── 异常处理 (exception.py) └── 工具函数 (utils.py)

这种分层架构使得每个模块都可以独立开发和测试，同时通过标准化的接口进行通信。例如，设备控制模块负责与模拟器或物理设备的交互，而图像识别模块则专注于游戏界面的元素检测。

图像识别技术实现

OAS的核心技术在于其图像识别系统。脚本通过预先训练的模板匹配算法，能够准确识别游戏界面中的各种元素。以下是一些典型的识别模板：

深渊暗域地图识别模板 - 用于定位怪物分布区域

游戏确认按钮识别模板 - 用于自动化点击操作

地域鬼王BOSS识别模板 - 用于特定BOSS的定位

这些识别模板虽然分辨率较低，但在实际应用中通过算法优化能够实现高精度的匹配。系统采用多级匹配策略：首先进行快速粗略匹配，然后对候选区域进行精细验证，最后结合上下文信息进行决策。

典型应用场景分析

御魂副本自动化

御魂副本是《阴阳师》中最耗时的日常任务之一。OAS的御魂自动化模块能够智能处理以下流程：

副本选择与进入：自动识别御魂副本入口，选择指定层数
队伍配置检测：检查当前队伍配置是否符合预设要求
战斗流程控制：自动开始战斗，监控战斗进度
奖励收集：战斗结束后自动领取奖励并整理御魂

技术实现上，该模块使用了配置文件module/config/argument/argument.yaml来存储不同御魂副本的参数设置，包括层数选择、队伍配置、重复次数等。

结界突破批量处理

结界突破需要频繁的点击操作和策略判断。OAS的结界突破模块实现了以下功能：

功能模块	技术实现	效率提升
结界列表刷新	图像识别刷新按钮位置	减少80%手动操作时间
目标选择	OCR识别结界等级和剩余次数	提高选择准确性
战斗监控	实时检测战斗状态变化	避免超时等待
奖励统计	自动记录突破成果	提供数据支持

该模块的配置文件位于tasks/RealmRaid/config.py，支持自定义突破策略和优先级设置。

百鬼夜行智能撒豆

百鬼夜行是获取式神碎片的重要途径，但手动操作效率低下。OAS的百鬼夜行模块采用了先进的AI识别技术：

式神识别：基于卷积神经网络的图像分类模型
轨迹预测：计算式神移动轨迹和最佳投掷时机
资源优化：智能分配豆子数量，优先高价值式神

百鬼夜行界面识别百鬼夜行界面识别示例 - 用于式神定位和豆子投掷

配置与部署指南

环境准备与安装

系统要求：
- Windows 10/11 操作系统
- Python 3.8 或更高版本
- 至少4GB可用内存
- 支持OpenGL的显卡

项目部署：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/on/OnmyojiAutoScript # 进入项目目录 cd OnmyojiAutoScript # 安装依赖包 pip install -r requirements.txt

模拟器配置：
- 推荐使用MuMu模拟器或雷电模拟器
- 设置分辨率为1280×720（最佳识别效果）
- 开启ADB调试模式
- 配置合适的性能参数

基础配置流程

OAS的配置系统采用YAML格式，支持灵活的配置选项。主要配置文件包括：

全局配置：config/argument/default.yaml
设备配置：module/device/device.py
任务配置：各任务模块下的config.py文件

配置示例：

# 任务调度配置示例 scheduler: enabled_tasks: - exploration - realm_raid - soul_zone execution_interval: 300 # 任务间隔5分钟 max_retry: 3

任务模块启用与定制

每个任务模块都提供了详细的配置选项。以探索副本为例，配置文件tasks/Exploration/config.py包含以下可调参数：

# 探索副本配置示例 EXPLORATION_CONFIG = { "chapter": 28, # 章节选择 "difficulty": "hard", # 难度设置 "team_preset": "soul", # 队伍预设 "auto_revive": True, # 自动复活 "max_runs": 100, # 最大运行次数 }

技术特色与创新点

智能错误处理机制

OAS设计了多层次的错误处理系统，确保脚本的稳定运行：

图像识别容错：当模板匹配失败时，自动尝试备用识别方案
网络异常恢复：检测网络中断并自动重连
游戏状态监控：实时监控游戏进程状态，异常时自动重启
日志记录与分析：详细记录运行日志，便于问题排查

错误处理代码位于module/base/protect.py，提供了装饰器和上下文管理器两种错误处理模式。

多设备支持架构

系统支持同时管理多个游戏实例，适用于多账号玩家：

设备管理架构 ├── 设备发现 (device discovery) │ ├── ADB设备扫描 │ ├── 模拟器实例检测 │ └── 物理设备连接 ├── 会话管理 (session management) │ ├── 设备状态监控 │ ├── 任务分配调度 │ └── 资源隔离控制 └── 数据同步 (data synchronization) ├── 配置同步 ├── 进度备份 └── 日志聚合

性能优化策略

OAS采用了多种性能优化技术：

优化领域	技术手段	效果提升
图像识别	缓存识别结果	减少50%识别时间
内存管理	对象池技术	降低30%内存占用
任务调度	优先级队列	提高20%执行效率
网络通信	连接复用	减少40%连接开销

进阶应用与扩展开发

自定义任务开发

开发者可以通过继承基础任务类来创建新的任务模块。基础类定义在tasks/base_task.py，提供了完整的任务执行框架：

from tasks.base_task import BaseTask class CustomTask(BaseTask): def __init__(self, config): super().__init__(config) def execute(self): # 实现自定义任务逻辑 self.logger.info("开始执行自定义任务") def on_error(self, error): # 自定义错误处理 self.logger.error(f"任务执行出错: {error}")

插件系统集成

OAS支持插件机制，可以通过插件扩展系统功能。插件开发指南位于module/config/config_server.py，定义了插件接口规范：

# 插件接口定义 class PluginInterface: def initialize(self, context): """插件初始化""" pass def process(self, data): """数据处理""" pass def cleanup(self): """清理资源""" pass