雪松小助手 MaaKEDR · 雪松自动化脚本

简体中文

English

简体中文

English

外观

新手上路 | 用户手册

2618 字约 9 分钟

新手上路

前置准备

1. 确认版本系统

WindowsmacOSLinuxAndroid
系统要求Windows 10 及以上自行尝试自行尝试Android 10 及以上
需要配置环境是是是否
需要模拟器是是模拟器或容器化安卓否
使用方式图形界面或命令行图形界面或命令行图形界面或命令行图形界面
额外要求无无无Shizuku 或 root（见下方说明）
备注
Windows 用户绝大部分情况请下载 x86_64 架构
Mac 用户MaaKEDR 同时支持搭载 Apple Silicon 和 Intel 芯片的 Mac 电脑
但更推荐搭载 Intel 芯片的 Mac 电脑使用 Mac 自带的多系统安装 Windows
并使用 Windows 版 MaaKEDR 和模拟器
Android 用户MaaKEDR 提供 Android 客户端安装包（见 Releases，真机推荐 MaaKEDR-android-arm64-v8a-<版本>.apk，模拟器等 x86 环境用 MaaKEDR-android-x86_64-<版本>.apk）
需要 Android 10 及以上（只提供后台模式，系统虚拟屏要求 API 29）；首次启动请授予通知与电池白名单，并选择 Shizuku 或 root 授权

2. 安装运行环境

笔记

用户可跳过这节，在下一步下载解压后运行依赖库安装脚本，脚本自动安装失败后再看这节

启动方式
Windows
macOS
Linux
MFAA
MXU
MFAA
MXU
MFAA
MXU
需安装 VCRedist
点击 vc_redist.x64 下载
否
需安装 .NET
是
否
是
否
是
否
需安装 Python
压缩包自带，无需其他操作
需要 Python 3.13

VCRedist x64

Windows 用户必须安装 VCRedist x64：这是运行 MaaKEDR（无论哪种启动方式）的基础需求。

详细安装方式

  • 直接下载：点击 vc_redist.x64 下载并安装
  • winget 安装（管理员终端）： 
    winget install Microsoft.VCRedist.2017.x64

.NET

使用 MFAA 图形界面的用户需要自行安装 .NET 10 桌面运行时。

详细安装方式

  • 自行下载：点击 .NET 官方下载页面 ，选择您系统对应的 .NET 10 桌面运行时版本下载并安装。
  • （仅 Windows 用户）winget 安装（管理员终端）： 
    winget install Microsoft.DotNet.DesktopRuntime.10

Python

Windows 与 macOS 压缩包已内置 Python 运行环境，无需单独安装。Linux 压缩包不内置 Python，需自行安装 Python 3.13。

3. 下载正确的版本

MaaKEDR 下载地址：GitHub 发布页。点击链接后，在 Assets 处选择适配您系统的最新版压缩包下载。

提示

认准官方渠道：MaaKEDR 通过 GitHub Releases 与 Mirror酱（合作渠道，内容与官方一致）双渠道发布，部分图形界面支持通过 Mirror酱 界面内自动更新。从其他非官方渠道（仿冒网站、网盘转发等）下载存在安全风险，安装前请核对应用标识。

每个版本提供两种图形前端，按需下载其一即可：

前端后缀说明
MFAA-MFAA图形界面，需安装 .NET 桌面运行时，界面更丰富
MXU-MXU图形界面（Tauri + React），无需额外依赖
系统下载文件
Windows x86_64MaaKEDR-win-x86_64-v*-MFAA.zip 或 -MXU.zip
Windows ARM64MaaKEDR-win-aarch64-v*-MFAA.zip 或 -MXU.zip
macOS IntelMaaKEDR-macos-x86_64-v*-MFAA.tar.gz 或 -MXU.tar.gz
macOS Apple SiliconMaaKEDR-macos-aarch64-v*-MFAA.tar.gz 或 -MXU.tar.gz
Linux x86_64MaaKEDR-linux-x86_64-v*-MFAA.tar.gz 或 -MXU.tar.gz
Linux ARM64MaaKEDR-linux-aarch64-v*-MFAA.tar.gz 或 -MXU.tar.gz
Android 通用包MaaKEDR-android-universal-v*.apk（不确定就选它）
Android ARM64 手机MaaKEDR-android-arm64-v8a-v*.apk（绝大多数手机）
Android x86 模拟器MaaKEDR-android-x86_64-v*.apk（电脑上的安卓模拟器）
Mac 用户查看处理器架构方法

  1. 点击屏幕左上角的苹果标志。
  2. 选择"关于本机"。
  3. 在弹出的窗口中，你可以看到处理器的信息。
  • 若使用 Intel 处理器，请下载 -macos-x86_64- 版本
  • 若使用 Apple Silicon（如 M1、M2 等），请下载 -macos-aarch64- 版本

4. 确认模拟器和设备支持

WindowsmacOSLinuxAndroid
模拟器支持支持主流模拟器支持主流模拟器自行尝试/
需要 ADB是是是否
需要 Shizuku否否否是

MaaKEDR 通过 ADB 连接模拟器或设备。推荐使用以下模拟器：

  • MuMu 模拟器 12
  • BlueStacks 5
  • LDPlayer 9
  • 夜神模拟器

模拟器支持详情可参阅 MAA 文档。

5. 正确设置分辨率

MaaKEDR 支持主流模拟器，但您需要设置模拟器分辨率以达到运行要求。 分辨率应为 横屏 16:9 比例，推荐（以及最低）分辨率为 1280x720，不符合要求造成的运行报错将不会被解决。

警告

注意修改分辨率后模拟器主页应该是横屏（平板版），不要选成竖屏（手机版）了！

6. 开始使用

重要

不要在压缩软件中直接运行程序！

确认解压完整，并确保将 MaaKEDR 解压到一个独立的文件夹中。推荐解压路径如 D:\MaaKEDR。请勿将程序解压到如 C:\、C:\Program Files\ 等需要 UAC 权限的路径。

Windows

解压后运行 maakedr.exe 即可。

macOS

详情

  1. 打开终端，解压压缩包：

    mkdir -p ~/MaaKEDR
tar -xzf ~/Downloads/MaaKEDR-macos-*.tar.gz -C ~/MaaKEDR

  2. 进入解压目录并运行程序：

    cd ~/MaaKEDR
./maakedr

Gatekeeper 安全提示：

macOS 10.15（Catalina）及更高版本可能会阻止运行未签名的应用程序。如果遇到"无法打开，因为无法验证开发者"等错误：

sudo xattr -rd com.apple.quarantine ~/MaaKEDR/maakedr

Linux

同 macOS，下载对应版本的压缩包，解压后运行 maakedr 即可。

Android

安卓版是独立的一套：不需要电脑、不需要模拟器、也不用解压，直接装 APK。

从 Releases 下载对应架构的 APK：真机选 arm64-v8a，x86 模拟器选 x86_64，不确定请选 universal。

  1. 首次启动时授予通知权限并加入电池白名单：后台挂机、定时触发与运行进度通知都依赖这些权限。
  2. 选择 Shizuku 或 root 完成授权，并等待服务连接。Shizuku 需另行安装并启动：
    • Android 11 及以上：可在设备上通过无线调试直接启动，无需电脑
    • 更低版本且没有 root 时：需要一台电脑通过 ADB 启动
    • 详见 Shizuku 官方文档
  3. 首次启动会自动解包任务资源。
  4. 在应用内选择服务器、勾选任务后开始运行，无需配置 ADB 连接。

笔记

安卓端与桌面端的配置项基本一致，但资源跟随 APK 打包，因此不支持热更新，也不支持 Mirror酱 的增量更新——换版本需要重新下载安装 APK。设备上仍显示旧内容时，清除 MaaKEDR 的应用数据再重新打开即可。

警告

没有 Shizuku 也没有 root 时，APK 可以安装但无法执行任务（拿不到截屏与点击权限）。这种情况下请改用桌面版。

7. 配置 MaaKEDR

首次启动

首次启动 MaaKEDR 后，程序会自动初始化并创建 config/ 配置目录。在 日志 板块显示"AgentServer 启动"后，直到看见"任务已全部完成"前，请不要点击停止任务。

资源类型

需选择模拟器中安装的《雪松》区服。目前支持：

  • 官服（base）
  • B 服（bilibili）
  • TapTap 服（taptap）

连接

MaaKEDR 需正确的 ADB 连接才能在目标模拟器执行任务。绝大多数情况下，您只需保持有且仅有目标模拟器启动，点击"刷新"即可完成连接。

  • 刷新：重新检测所有已启动模拟器
  • 自定义：修改 ADB 参数（一般无需手动修改）
  • 重新连接：重新连接已选定模拟器

任务列表

MaaKEDR 提供以下自动化任务：

任务功能
启动游戏从启动到登录至主界面
领取奖励日常签到、周常奖励、战令奖励、邮件奖励、派遣奖励
资源刷取指定关卡自动刷资源，支持体力管理
剩余体力刷取固定清空体力模式，榨干剩余体力
活动关卡刷取活动关卡扫荡（每日 3 次，不消耗体力）
活动商店兑换活动商店定额保障商品自动购买
PVP竞技场自动战斗
体力信息读取主界面体力并输出回满时间

重要

大部分任务需在使用前正确配置。启用任务前，请确保您已阅读并理解了该任务的任务说明，并结合实际情况对任务设置进行配置。

配置文件

MaaKEDR 首次运行时会自动在 config/ 目录下生成配置文件，您可以用文本编辑器手动修改。

config/pip_config.json

pip 安装相关设置。一般情况下，您无需修改此文件，除非您有特殊需求。

{
    "enable_pip_install": true, // 是否启用 pip 安装，默认 true
    "mirror": "https://pypi.tuna.tsinghua.edu.cn/simple", // 镜像源
    "backup_mirror": "https://mirrors.ustc.edu.cn/pypi/simple", // 备用镜像源
}

常见问题

无法连接模拟器

  • 确认模拟器的 ADB 调试已开启
  • 尝试使用 adb devices 命令检测设备是否正常连接
  • 检查模拟器 ADB 端口：MuMu 为 127.0.0.1:16384，BlueStacks 为 127.0.0.1:5555

任务执行异常

  • 确认游戏处于正确的界面（如在主菜单或对应功能页面）
  • 查看 debug/ 目录下的截图，确认识别区域是否正确
  • 查看 maafw.log 日志文件（项目根目录）定位问题
AGPL-3.0 License
Copyright © 2025 APPLe-DF