Skip to content

macos_linux.md

Latest commit

 

History

History
48 lines (33 loc) · 1.83 KB

macos_linux.md

File metadata and controls

48 lines (33 loc) · 1.83 KB
Raw

🐧 macOS & Linux Setup Guide

由于操作系统安全机制的差异，macOS 和 Linux 用户需要进行额外的配置才能正常使用 PyMCPAutoGUI。

🍎 macOS

1. 辅助功能权限 (Accessibility)

PyAutoGUI 需要控制你的鼠标和键盘，因此必须授予终端（如 Terminal, iTerm2, 或 Cursor）辅助功能权限。

  1. 打开 系统设置 (System Settings) > 隐私与安全性 (Privacy & Security) > 辅助功能 (Accessibility)。
  2. 点击 + 号，添加你正在使用的终端应用程序（例如 Cursor 或 Terminal）。
  3. 如果已经添加但仍然报错，尝试移除后重新添加。

2. 屏幕录制权限 (Screen Recording)

如果使用截图功能 (screenshot, locate_on_screen)，还需要授予 屏幕录制 权限。

  1. 打开 系统设置 > 隐私与安全性 > 屏幕录制 (Screen Recording)。
  2. 添加你的终端应用程序。

🐧 Linux

1. 系统依赖

PyAutoGUI 在 Linux 上依赖于一些系统工具。

Debian / Ubuntu:

sudo apt-get update
sudo apt-get install -y python3-tk python3-dev scrot xclip

(注意: scrot 用于截图，xclip 用于剪贴板操作)

2. 显示服务器 (Display Server)

目前 PyAutoGUI 主要支持 X11。

  • Wayland 用户: 如果你在使用 Wayland（许多现代发行版的默认设置），部分功能（如截图和鼠标控制）可能受限或无法工作。建议切换到 Xorg/X11 会话，或设置环境变量 GDK_BACKEND=x11（效果取决于具体应用）。

3. 无头模式 (Headless / CI)

如果在没有显示器的服务器或 CI 环境中运行，需要使用 Xvfb (X virtual framebuffer)。

# 安装 Xvfb
sudo apt-get install -y xvfb

# 运行
xvfb-run --auto-servernum --server-args="-screen 0 1280x1024x24" uv run python -m pymcpautogui.server