阴阳师自动化脚本从零到一：安装、配置与避坑全记录

阴阳师自动化脚本从零到一：安装、配置与避坑全记录

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

晚上十点，你刚清完御魂，发现悬赏封印还没做；周末活动开了爬塔，可体力还有几百点没刷完。如果你每天都要在"刷本"和"睡觉"之间做选择，那么阴阳师自动化脚本（Onmyoji Auto Script，社区常称 OAS）值得花一个晚上认真对待。这是一款运行在 Windows 上、通过 Python 驱动安卓模拟器的开源工具，它负责替你完成百鬼夜行、御魂副本、悬赏封印、结界突破等几十种重复操作。本篇文章按"从听说到长期使用"的真实旅程展开，读完你就能独立完成环境搭建、首次运行和参数调优。

一、第一次听说：它到底在替你做什么

与其把它想成一个"机器人"，不如把它想成一套**"能看懂屏幕的手"**。OAS 的工作闭环只有四步：

1. 截屏——通过 ADB 或模拟器专用通道抓取当前游戏画面；
2. 识别——用内置图像模板、OCR 文字识别（首次出现术语，可理解为"把截图里的字和图标认出来"）和 AI 模型判断当前在哪个界面；
3. 决策——对照任务规则决定下一步该点什么、滑到哪、等多久；
4. 操作——模拟点击、滑动、长按，然后回到第 1 步。

这套流程写在哪里？所有任务逻辑都放在项目根目录的tasks/文件夹里，每个子目录对应一个玩法模块，例如tasks/Hyakkiyakou/（百鬼夜行）、tasks/FindJade/（悬赏挖宝）、tasks/Orochi/（八岐大蛇）。当你之后想改某个玩法的行为，去对应目录改配置即可，不必动核心代码。

OAS 的图形界面采用侧边导航结构，任务模块以卡片形式集中呈现，方便按需勾选

二、第一次安装：环境搭建三步法

动手前先确认三件事：Windows 10/11 系统、Python 3.10 或更高版本、一个安卓模拟器（雷电、夜神、MuMu 均可）。游戏本身建议提前登录好，脚本不负责注册账号。

第 1 步：克隆项目并安装依赖

打开命令行，依次执行：

git clone https://gitcode.com/gh_mirrors/on/OnmyojiAutoScript cd OnmyojiAutoScript pip install -r requirements.txt

依赖清单由requirements.txt固定版本号，首次安装约需几分钟。若你的 Python 是 3.11 或 3.12，个别包可能需要换用兼容版本，卡住时优先检查这一步。

第 2 步：让电脑能找到模拟器

OAS 通过 ADB（Android Debug Bridge，安卓调试桥，可理解为"电脑与安卓设备通信的官方通道"）与模拟器通信。打开模拟器的"设置"，开启 ADB 调试或 ROOT 权限，并记下模拟器端口（雷电默认5555，夜神默认62001，MuMu 默认7555）。在命令行验证连接是否打通：

adb connect 127.0.0.1:5555 adb devices

能看到设备编号即表示连接成功。如果adb命令不可用，请先安装 Android Platform Tools 并加入系统环境变量。

第 3 步：启动图形界面

python gui.py

首次启动会自动拉起 OCR 服务，稍等片刻即可看到主窗口。到此安装环节结束，整个过程通常不超过 20 分钟。

三、第一次运行：从"回到庭院"开始试水

不建议一上来就开百鬼夜行或斗技，先跑一个最安全的任务建立信心。项目里恰好有一个极简模块tasks/GotoMain/，它的全部逻辑就是"识别当前页面并回到庭院"，非常适合作为冒烟测试。

在界面左侧导航找到任务列表，勾选"回到庭院"类任务，连接好设备后点击运行，观察三点：

• 日志区是否按预期输出"识别到 X 页面 → 执行 Y 操作"；
• 模拟器窗口里的游戏是否真的在动；
• 完成后任务状态是否正常结束。

跑通这一步，说明"截屏—识别—操作"链路完整，可以放心选真实任务了。若日志反复报识别失败，多半是画面问题，见第五节排查清单。

图形界面中的按钮组件支持点击、状态切换等配置，任务运行时依赖这些交互组件完成操作

四、第一次调优：用百鬼夜行看懂参数

新手最容易困惑的是"那些数字到底该填什么"。以社区讨论度最高的百鬼夜行为例，配置集中在tasks/Hyakkiyakou/config.py，核心是两类参数：权重和模型阈值。

权重决定"哪些式神值得砸豆子"。源码默认值如下：

hya_sp: float = 1.0 # SP 式神权重 hya_ssr: float = 1.0 # SSR 式神权重 hya_sr: float = 0.7 # SR 式神权重 hya_r: float = 0.3 # R 式神权重 hya_n: float = 0.0 # N 卡权重

想优先收集某张式神，可在hya_priorities里直接填式神名，命中后会提高其优先级。想刷 SR 碎片但不想浪费豆子给 R 卡，把hya_r调成 0 即可。

模型阈值决定"识别得多快、多准"。两个关键项：

建议新手保持默认，等跑完三场再微调conf_threshold到 0.5~0.7 区间找手感。另有hya_limit_time（单次运行时长，默认 20 分钟）和hya_auto_bean（自动调整豆子数量）两个开关，前者用来控制单次投入时间，后者适合挂机时开启。

五、长期使用：常见问题排查清单

使用两三周后，你大概率会遇到下面三类问题，按清单逐项排除即可。

问题 1：任务启动后界面毫无反应

优先级从高到低检查：

1. adb devices是否还能看到设备——模拟器重启后连接会失效，重新执行一次连接命令；
2. 模拟器的 ADB 调试开关是否被重置——部分模拟器更新后会默认关闭；
3. 游戏窗口是否完整可见——脚本需要看到游戏画面，被遮挡或最小化会影响截屏；
4. 是否以管理员身份运行——部分截屏通道需要管理员权限。

问题 2：识别准确率忽高忽低

先确认游戏画质设置是否被改动，分辨率与截图模板不匹配是头号原因。其次，如果游戏内调整过 UI 缩放，把缩放恢复为推荐值。最后再考虑调低conf_threshold——但请注意，阈值越低误点风险越高，宁可少识别不可错操作。

问题 3：运行变卡，CPU 或内存占用过高

• 模拟器分辨率降到 720P 级别，游戏画质选"均衡"；
• 适当拉大截图间隔（百鬼夜行模块里对应hya_interval，默认 300ms，可上调到 400~500ms）；
• 关闭模拟器的高帧率和多余特效；
• 长时间挂机建议每 4~6 小时重启一次模拟器，释放内存碎片。

六、下一步：今晚就能完成的最小闭环

第一次接触自动化工具，别贪多。按这个顺序走：

1. 克隆项目、装依赖、启动python gui.py（约 20 分钟）；
2. 用"回到庭院"任务验证链路通不通（约 5 分钟）；
3. 勾选百鬼夜行，保持全部默认参数，先跑一场 20 分钟（约半小时）；
4. 跑完后看日志统计，再决定是否调权重和阈值。

跑完这四步，你就有了一套能稳定复现的"最小可用流程"。之后再按需探索悬赏封印、御魂副本、结界突破等模块——它们的配置逻辑和百鬼夜行同源，无非是"识别什么、点什么、等多久"的组合。把时间花在理解参数含义上，而不是盲目堆任务，是这台"看得懂屏幕的手"用得长久的关键。

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