> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# 平台环境配置

每篇平台指南负责准备一种环境：Midscene 所需的连接工具、设备连接与系统权限。Playground、Midscene Test 和 JavaScript SDK 都使用同样的环境。每篇指南最后的「验证」一节会引导你在 Playground 中检查环境。

Midscene 基于多模态视觉模型理解屏幕截图，直接面向最终渲染的视觉界面进行自动化操作，而不依赖底层的 DOM 或原生控件树。因此，同一套交互与断言方式可以通用于原生应用及各类跨平台技术栈。

## 选择平台

| 平台                                      | npm 包                | 连接方式                                                  | 典型场景                          |
| --------------------------------------- | -------------------- | ----------------------------------------------------- | ----------------------------- |
| [Web](/zh/platforms/web.md)             | `@midscene/web`      | Chrome 插件（Playground 体验）；Playwright / Puppeteer（工程接入） | 网页测试与浏览器自动化                   |
| [Chrome Bridge](/zh/bridge-mode.md)     | `@midscene/web`      | Chrome 插件                                             | 复用桌面 Chrome 已有的登录状态与标签页       |
| [Android](/zh/platforms/android.md)     | `@midscene/android`  | `adb`                                                 | Android 应用与系统界面自动化            |
| [iOS](/zh/platforms/ios.md)             | `@midscene/ios`      | WebDriverAgent                                        | iOS 应用与系统界面自动化                |
| [HarmonyOS](/zh/platforms/harmonyos.md) | `@midscene/harmony`  | HDC                                                   | HarmonyOS NEXT 应用与系统界面自动化     |
| [桌面端](/zh/platforms/desktop.md)         | `@midscene/computer` | 原生键鼠控制或 RDP                                           | Windows、macOS 和 Linux 桌面应用自动化 |