ArknightsAutoHelper 明日方舟自动化辅助脚本使用教程

ArknightsAutoHelper 是一个基于 Python 和 ADB 的明日方舟自动化辅助脚本，能够帮助玩家自动完成游戏中的重复性任务，如刷图、使用理智药、识别掉落物品等。

环境准备

系统要求

• 操作系统：Windows（建议 Windows 10 1607 及以上版本）
• 分辨率：建议高度 1080 或以上，宽高比不小于 16:9
• 需要安装 ADB 工具并正确连接模拟器

安装方式

二进制包安装（推荐）

从项目发布页面下载二进制包启动器，首次运行时会自动下载最新代码和运行环境。

源代码安装

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

主要功能

自动刷图功能

脚本支持两种刷图模式：

快速刷图模式：在当前关卡界面直接开始刷图

python3 akhelper.py quick 99  # 刷当前关卡99次
python3 akhelper.py quick -r  # 刷到理智不足自动停止

自动选关模式：从主界面开始自动选择指定关卡

python3 akhelper.py auto 5-1 2 5-2 3  # 按顺序刷5-1关卡2次，5-2关卡3次

理智管理

• 自动使用理智药回复理智（+r参数）
• 支持使用源石回复理智（+R参数）
• 智能识别当前理智和关卡消耗

公开招募识别

python3 akhelper.py recruit  # 自动识别公开招募标签

任务奖励领取

python3 akhelper.py collect  # 自动领取每日和每周任务奖励

基建管理

python3 akhelper.py riic collect  # 收取制造站和贸易站
python3 akhelper.py riic shift <房间> <干员>  # 干员换班

进阶功能

刷图计划制定

通过 arkplanner 命令可以创建智能刷图计划：

1. 输入需要的材料数量和类型
2. 自动获取当前库存材料
3. 生成最优刷图方案并保存到 config/plan.json
4. 使用 auto plan 执行刷图计划

自定义操作记录

脚本支持录制和回放自定义操作序列：

通过编写 Python 脚本可以创建复杂的操作流程：

from Arknights.helper import ArknightsHelper

helper = ArknightsHelper()
helper.replay_custom_record('get_credit')  # 回放收信用点操作

配置说明

配置文件位于 config/config.yaml，主要配置项包括：

• ADB 连接设置
• 模拟器特定参数
• 日志记录配置
• OCR 识别设置

日志文件保存在 log 目录下，采用 CSV 格式便于分析。

常见问题解答

分辨率适配问题

脚本支持多种分辨率（1280x720、1440x720、1920x1080、2160x1080等），建议使用高度不低于1080的分辨率以获得最佳识别效果。

ADB 连接问题

确保 adb devices 能够正确列出目标模拟器。不同模拟器可能需要特殊的 ADB 配置：

• MuMu、BlueStacks：需要自行启动 ADB server
• 夜神模拟器：注意版本冲突问题
• MuMu 星云引擎：不支持 ADB 接口

识别精度问题

如果遇到识别错误，可以：

1. 检查游戏画面是否清晰
2. 调整截图区域的 ROI 大小
3. 修改匹配相似度阈值

开发与扩展

项目采用模块化设计，开发者可以：

1. 阅读 scripting_example.pyi 了解脚本编写方法
2. 查看 Arknights 模块中的辅助类
3. 使用 create_custom_record 方法创建新的操作流程
4. 参与项目开发，提交 Pull Request

注意事项

• 请合理使用自动化功能，遵守游戏规则
• 脚本仅供学习和研究使用
• 遇到问题可以查看日志文件 ArknightsAutoHelper.log
• 建议在稳定的网络环境下运行

通过本教程，您应该能够快速上手使用 ArknightsAutoHelper 来提高游戏效率。记得定期更新脚本以获取最新功能和改进。