ArkLoop

明日方舟 MuMu12 模拟器帧级作战轴录制与回放工具
支持录制操作轴、自动执行轴、续录、轴编辑与截图辅助
🔗 本项目 GitHub 仓库
如果这个项目对你有帮助，欢迎在仓库右上角点个 Star ⭐

---

📖 详细使用说明请查看 HOWTOUSE.md

本篇 README 只包含项目概览、开发构建与鸣谢信息。

功能

• 录制轴：在 MuMu12 中实时录制部署 / 技能 / 撤退操作，自动生成时间轴
• 执行轴：加载已有时间轴，按帧级精度自动复刻操作
• 续录轴：执行或暂停后可继续录制，方便分段摸索
• 轴编辑：可视化时间轴编辑器，支持新建、编辑、删除、拖动操作节点
• 截图辅助：选中轴并进图后可截取带坐标标注的游戏画面
• 循环凹图：配合断点与重试逻辑反复执行同一轴

快速开始

# 克隆仓库
git clone https://github.com/Coodist/ArkLoop.git
cd ArkLoop

# 安装 Python 依赖
.venv\Scripts\python -m pip install -r requirements.txt

# 构建前端
cd ui
npm install
npm run build
cd ..

# 运行桌面端
.venv\Scripts\python scripts\arkloop_webview.py

打包为独立 EXE：

powershell -ExecutionPolicy Bypass -File build_arkloop.ps1

输出位置：

dist\ArkLoop\ArkLoop.exe

项目结构

scripts/                正式入口
  arkloop_webview.py    PyWebview 桌面端主入口
  calibrate.py          费用条校准工具
  run.py                旧版 CLI 回放入口
src/                    核心逻辑
  mumu/                 MuMu 模拟器连接、截图、输入注入
  frame/                费用条检测、暂停检测、帧源
  logic/                坐标投影、动作执行、时间源
  axis/                 轴执行器、JSON 加载
  maa/                  MAA 识别相关配置与节点
recorder/               实时录制后端与动作识别
ui/                     React + Vite + Tailwind 时间轴编辑器
test_scripts/           开发调试脚本
tools/                  资源同步与预处理脚本
resource/               游戏数据：头像、地图、干员/关卡映射表
calibration/            费用条校准文件
timelines/              用户时间轴（运行时生成，已 gitignore）

日志

运行 ArkLoop.exe 或 scripts\arkloop_webview.py 时，日志会输出到伴随的黑色命令行窗口中。调试截图与 ROI 图片默认写入 debug/ 目录（已 gitignore）。

鸣谢

依赖

• MaaFramework — 图像识别自动化框架
• Tesseract OCR — OCR 识别
• PyWebview — 桌面 WebView 容器
• React / Vite / Tailwind CSS — 前端编辑器
• Python / OpenCV / NumPy / Pillow

参考项目

• yuanyan3060/Arknights-Tile-Pos — 地图坐标数据
• yuanyan3060/ArknightsGameResource — 干员头像等游戏资源
• Windsland52/ArknightsAutoOperator — 帧级自动操作与费用条计时参考
• MaaAssistantArknights — 地图数据（Arknights-Tile-Pos）与粗流程参照
• ArknightsCostBarRuler — 费用条计时 / 悬浮窗 / 打轴对轴参考
• prts-plus — 帧级自动操作的执行器算法（action / 投影 / 配置）