新手上路

• 直接下载：点击 vc_redist.x64 下载并安装
• winget 安装：右键 Windows 开始按钮，选择“命令提示符”或“PowerShell (管理员)”，然后在终端内粘贴以下命令并回车：

  winget install Microsoft.VCRedist.2017.x64

• 自行下载：点击 .NET 官方下载页面 ，选择适合您系统的版本下载并安装。

  	Windows	macOS	Linux
  您需要下载	.NET 桌面运行时	.NET 运行时
  安装程序	x64	dotnet-install.sh

• （仅 Windows 用户）winget 安装：右键 Windows 开始按钮，选择“命令提示符”或“PowerShell (管理员)”，然后在终端内粘贴以下命令并回车：

  winget install Microsoft.DotNet.DesktopRuntime.8

• 您的系统需要安装 Python 版本 ≥ 3.10。这是 M9A 启动和管理其内部环境所必需的。
• M9A 首次运行时会自动创建并使用独立的虚拟环境，并安装所需的 Python 依赖包 (来自 requirements.txt)。您无需手动创建虚拟环境或安装这些依赖。

1. 点击屏幕左上角的苹果标志。
2. 选择“关于本机”。
3. 在弹出的窗口中，你可以看到处理器的信息。

• 若使用 Intel X86 处理器，请下载 M9A-macos-x86_64-vXXX.tar.gz
• 若使用 Apple Silicon 系列如：M1、M2 等 ARM 架构处理器，请下载 M9A-macos-aarch64-vXXX.tar.gz

	Windows	macOS	Linux	Android
参考文档	Windows 模拟器	如果你的设备搭载 Apple Silicon 请参阅： 在 Apple Silicon 平台上运行的Mac模拟器 如果你的设备搭载 Intel 芯片： 1. 推荐使用 Mac 自带的多系统安装 Windows 并参考 Windows 部分文档 2. 参阅在 Intel 平台上运行的 Mac 模拟器	Linux 模拟器与容器	Android 实体设备

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

   选项1：解压到系统目录（需要管理员权限）

   sudo mkdir -p /usr/local/bin/M9A
   sudo tar -xzf <下载的M9A压缩包路径> -C /usr/local/bin/M9A
   

   选项2：解压到用户目录（推荐，无需sudo）

   mkdir -p ~/M9A
   tar -xzf <下载的M9A压缩包路径> -C ~/M9A
   

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

   cd /usr/local/bin/M9A
   ./MaaPiCli
   

若想使用图形操作页面请按第二步操作，由执行 MaaPiCli 改为执行 MFAAvalonia 程序。

⚠️Gatekeeper 安全提示处理：

在 macOS 10.15 (Catalina) 及更高版本中，Gatekeeper 可能会阻止运行未签名的应用程序。
如果遇到"无法打开，因为无法验证开发者"等错误，请选择以下任一方案:

# 方案1：以 MaaPiCli 为例，移除隔离属性（推荐，以实际路径为准）
sudo xattr -rd com.apple.quarantine /usr/local/bin/M9A/MaaPiCli
# 或用户目录版本：xattr -rd com.apple.quarantine ~/M9A/MaaPiCli

# 方案2：添加到 Gatekeeper 白名单
sudo spctl --add /usr/local/bin/M9A/MaaPiCli
# 或用户目录版本：spctl --add ~/M9A/MaaPiCli

# 方案3：一次性处理整个目录
sudo xattr -rd com.apple.quarantine /usr/local/bin/M9A/*
# 或用户目录版本：xattr -rd com.apple.quarantine ~/M9A/*

资源下载源
• 默认使用 Mirror 酱。
• 未购买 Mirror 酱的用户请改为 GitHub。
CDK 或 Token
• 通过 Mirror 酱更新的用户应当填写 CDK 。关于 Mirror 酱
• 通过 GitHub 更新的用户可填写 Token 以提高 Github API 的访问速率限制。Token 获取方法1 方法2

软件路径

• MuMu 12 模拟器参考

	路径格式
MuMu 12 模拟器 5.0 以下	{安装目录}\shell\MuMuPlayer.exe
MuMu 12 模拟器 5.0 及以上	{安装目录}\nx_device\12.0\shell\MuMuNxDevice.exe

附加命令

• X 为多开号

	参数格式	示例
MuMu 模拟器	-v X	-v 0
雷电模拟器	index=X	index=0

MuMu 模拟器自动获取路径方法
1. 确保桌面有安装 1999 应用的模拟器快捷方式。
2. 点击 软件路径 输入框右侧图标进入文件选择界面，选择桌面上的 1999 快捷方式，路径将自动填入。

• 需选择模拟器中安装的 1999 区服。
• 目前支持：官服、B服、国际服（EN）、国际服（JP）、OPPO服、小米服、QQ服。

当前控制器
• 显示当前连接的 ADB 控制器（模拟器和 ADB 地址）。
界面按钮说明
• 点击自定义：修改 ADB 参数（一般无需手动修改）。
• 点击刷新：重新检测所有已启动模拟器。
• 连接状态：绿色为已连接。

• 任务名前的复选框用于启用/禁用任务
• 右键单击复选框将单次执行该任务
• 点击右上角添加任务按钮可添加当前列表不可见任务或重复添加已有任务
• 点击任务右侧按钮查看 任务设置 与 任务说明
• 拖动任务名可调整任务顺序

{
    "enable_pip_install": true,  // 是否启用 pip 安装，默认 true，推荐开启
    "last_version": "v3.2.0",  // 完成 pip 安装时读取 interface.json 的 version ，启动时和 version 对比，不同则尝试安装
    "mirror": "https://mirrors.ustc.edu.cn/pypi/simple", // 镜像源。pip install -i 后参数，可根据个人需求填写。注意非大陆地区用户请修改值为 ""
    "backup_mirrors": [
    "https://pypi.tuna.tsinghua.edu.cn/simple",
    "https://mirrors.cloud.tencent.com/pypi/simple/",
    "https://pypi.org/simple"
    ]  // 备用镜像源
}