# Macro Automation Studio 文档

> Macro Automation Studio 文档：模拟器和云手机设置、Python SDK 参考、MAS Agent、MCP 服务器、API 密钥、Webhook 和教程。

Every page is also available as Markdown at the same path with a .md suffix. The full text of every page is at https://automationmacro.com/zh-CN/docs/llms-full.txt.

## 开始

- [Python 安卓模拟器自动化入门指南](https://automationmacro.com/zh-CN/docs/getting-started.md): 在 Macro Automation Studio 中开始 Python 安卓模拟器自动化：连接设备，然后运行 Marketplace 脚本、让 MAS Agent 编写，或亲手写出第一个宏。
- [Macro Automation Studio 下载与安装教程](https://automationmacro.com/zh-CN/docs/install.md): 在 64 位 Windows 或 Apple Silicon Mac 上下载并安装 Macro Automation Studio，用邮箱或 Google 登录，了解更新机制和项目文件的存放位置。
- [图像识别脚本的工作原理：MAS 核心概念](https://automationmacro.com/zh-CN/docs/concepts.md): 图像识别脚本在 MAS 中如何工作：模板图片和 OCR 读取安卓屏幕，拟人化输入通过 adb 发送，以及宏在哪里运行。

## MAS Agent

- [AI 自动操作手机：用 MAS Agent 从提示词生成宏](https://automationmacro.com/zh-CN/docs/agent.md): 描述一个安卓自动化任务，让 MAS Agent 在模拟器或云设备上探索应用，得到一个经过验证、可在 Studio 中编辑的 Python 宏。

## 设备

- [安卓模拟器 ADB 连接：模拟器、云手机和真机](https://automationmacro.com/zh-CN/docs/devices.md): Macro Automation Studio 中的安卓模拟器 ADB 连接：它能发现的模拟器、adb 端口规则、按端口添加设备、云设备，以及你自己的手机。
- [蓝叠模拟器 ADB 端口与连接设置（BlueStacks）](https://automationmacro.com/zh-CN/docs/bluestacks-setup-guide.md): 在 BlueStacks 5 中开启 ADB，找到蓝叠模拟器 ADB 端口，连接 Macro Automation Studio，并解决 Windows 和 Mac 上找不到设备与设备离线的错误。
- [雷电模拟器 ADB 端口与调试连接设置（LDPlayer）](https://automationmacro.com/zh-CN/docs/ldplayer-setup-guide.md): 在 LDPlayer 9 中开启 ADB 调试，找到雷电模拟器 ADB 端口，把实例连接到 Macro Automation Studio，并用会看屏幕的宏替代操作录制。
- [MuMu 模拟器 ADB 端口与连接设置（MuMu Player 12）](https://automationmacro.com/zh-CN/docs/mumu-setup-guide.md): 查看 MuMu 模拟器 ADB 端口，把 Macro Automation Studio 连接到 MuMu Player 12，把每个多开实例添加为设备，并用 MAS 宏替代操作录制。
- [逍遥模拟器 ADB 端口与连接设置（MEmu Play）](https://automationmacro.com/zh-CN/docs/memu-setup-guide.md): 通过 21503 端口把 MEmu Play 连接到 Macro Automation Studio，找到逍遥模拟器 ADB 端口，添加为设备，修复设备离线错误，并用 MAS 宏替代录制器。
- [adb 连接不上模拟器怎么办：设备离线与找不到设备](https://automationmacro.com/zh-CN/docs/adb-troubleshooting.md): 解决 Macro Automation Studio 中 BlueStacks、LDPlayer、MuMu、MEmu 和 Nox 的 adb 连接不上模拟器、找不到设备和设备离线问题，附可自行检查的 adb 命令。
- [云手机 24 小时挂机：创建、查看与运行宏](https://automationmacro.com/zh-CN/docs/cloud-devices.md): 在 Macro Automation Studio 中创建安卓云手机，通过 WebRTC 查看画面，安装 APK，在电脑关机时于服务端运行宏，并处理卡住的云设备。
- [模拟器多开同步运行：MAS 设备组](https://automationmacro.com/zh-CN/docs/device-groups.md): 在 Macro Automation Studio 中把多开的安卓模拟器窗口和云设备编成设备组，给每台设备分配宏、参数和代理，实现模拟器多开同步一键启动。
- [模拟器代理 IP：每个多开窗口独立 IP](https://automationmacro.com/zh-CN/docs/proxies.md): 在 Macro Automation Studio 中为每个模拟器实例或云设备绑定一个 HTTP、HTTPS 或 SOCKS5 代理，测试出口 IP，并在 Webhook 中读回它。

## 教程

- [游戏脚本制作教程：用 MAS 给任何安卓游戏做脚本](https://automationmacro.com/zh-CN/docs/make-a-bot-for-any-game.md): 在 Macro Automation Studio 中给任何安卓游戏制作脚本的游戏脚本制作教程：从 Marketplace 安装、让 MAS Agent 编写，或在 BlueStacks 上用 Python 自己写。
- [Python 找图点击脚本：蓝叠与雷电模拟器图像识别循环](https://automationmacro.com/zh-CN/docs/guides/image-recognition-macros.md): 在 Asset Lab 中截取模板，在 BlueStacks 或 LDPlayer 上匹配，并循环等待某个状态出现，做出一个带图像识别的 Python 找图点击脚本。
- [Python 控制安卓模拟器：ADB 自动化教程](https://automationmacro.com/zh-CN/docs/guides/control-an-emulator-from-python.md): 面向 Macro Automation Studio 的 Python 控制安卓模拟器教程：在 BlueStacks 上点击、滑动、输入、按键和截图，adb 由应用替你管理。
- [Python OCR 识别游戏数字：用 Tesseract 读取计数器](https://automationmacro.com/zh-CN/docs/guides/ocr-text-reading.md): 在 MAS 中用 read_text 给游戏脚本加上 Python OCR 识别数字的能力：在 Asset Lab 中选区域，调整 psm 和颜色转换，解析计数器和计时器。
- [雷电模拟器脚本循环、停止条件与定时运行](https://automationmacro.com/zh-CN/docs/guides/loops-and-scheduling.md): 让 LDPlayer 或 BlueStacks 上的宏带停止条件循环，在运行之间保存进度，用状态码退出，并在 MAS 定时任务中每天运行。
- [模拟器多开挂机脚本：雷电、蓝叠多开同步运行](https://automationmacro.com/zh-CN/docs/guides/multi-instance.md): MAS 中的模拟器多开挂机：按端口添加每个 BlueStacks 或 LDPlayer 实例，编成设备组，给每台设备自己的设置方案和代理，一键同步运行。