MuMuManager CLI

用途

使用命令行查询和管理 MuMu 模拟器 12 的实例与应用配置，适合账号矩阵、批量开关、自动化脚本、运维排障等场景。

前置要求

• 确保模拟器版本 V4.0.0.3179 或以上，否则部分命令不可用。
• 定位 MuMuManager.exe，常见路径：X:\Program Files\Netease\MuMuPlayer-12.0\shell\MuMuManager.exe；本机路径示例：C:\Program Files\Netease\MuMu\nx_main\MuMuManager.exe。
• 建议使用绝对路径，或将 nx_main 目录加入 PATH。

使用流程

1. 先用 info 确认可用实例；-v 支持逗号分隔列表或 all。
2. 选择需要的任务（创建/克隆/删除/重命名/导入/导出/ADB/应用/控制/设置）。
3. 尽量缩小作用范围，谨慎对 all 执行写操作。

功能速查

实例管理

• info 查看实例状态与字段说明
• create / clone / delete / rename 创建/克隆/删除/重命名实例
• import / export 备份与恢复 .mumudata（可选 --zip）

常见坑与规避

• 删除实例前先关闭该实例：control -v <index> shutdown。未关闭时可能返回 {"errcode": -1, "errmsg": "not handle cmd"}。

启动与窗口控制

• control launch / shutdown / restart 启动/关闭/重启实例
• control show_window / hide_window / layout_window 显示/隐藏/布局窗口

应用管理

• control app install / uninstall / launch / close / info 使用包名或 apk 路径
• control app info -i 查看已安装应用与当前前台应用

系统工具

• control tool func 常用功能（截图、刷新、主页、设置、安全等）
• control tool downcpu 降低 CPU
• control tool location / gyro 虚拟定位与重力感应
• control shortcut create / delete 创建/删除桌面快捷方式

设备配置与仿真

• setting 读取/修改配置，支持 --all / --all_writable / --info / --path
• simulation 修改仿真属性（IMEI/IMSI/Android ID/MAC 等）

ADB 命令

• adb -c 常用快捷命令（清理缓存/截图/录屏等）
• adb -c "shell ..." 执行自定义 shell 命令

其他

• sort 自动排列窗口
• driver install / uninstall -n lwf 安装/卸载驱动（可能需要管理员权限）
• 辅助接口 api 仅在必要时使用，稳定性依赖版本

参考

• 详见 references/mumu-manager-cli.md
• 快速定位关键词：
  • control app 应用管理
  • setting 配置项与 JSON 修改
  • simulation 仿真属性
  • adb ADB 命令
  • driver 驱动管理