兄弟，我刚好折腾过Wayland下Python抓屏的需求，给你整理几个靠谱的方案，完全匹配你要的低延迟、低开销、不打扰用户的要求：

先明确Wayland的核心限制（避坑前提） #

Wayland的安全模型就是禁止程序直接访问帧缓冲区，所有屏幕捕获必须通过xdg-desktop-portal走用户授权，或者直接基于PipeWire（现在绝大多数Wayland compositor都用PipeWire处理媒体流，屏幕输出就是一个PipeWire视频流）。所以正规方案都绕不开这俩，别想着找X11那套野路子，没用的。

方案1：快速上手——用pyscreenshot的Wayland后端 #

这是最省心的方案，pyscreenshot已经把xdg-desktop-portal的调用封装好了，你几乎不用管底层细节，代码风格和Windows下用pyautogui/mss差不多。

• 先确保系统装了依赖：xdg-desktop-portal，还有对应你用的compositor的后端（比如GNOME用xdg-desktop-portal-gnome，Sway用xdg-desktop-portal-wlr，KDE用xdg-desktop-portal-kde），这些一般桌面环境默认会装，没装的话用包管理器补装就行。
• 然后Python里装pyscreenshot：pip install pyscreenshot
• 代码示例：

import pyscreenshot as ImageGrab

# 捕获全屏
full_screen = ImageGrab.grab()
full_screen.save("full_screen.png")

# 捕获指定区域（比如左上角10,10到500,500的区域）
region = ImageGrab.grab(bbox=(10, 10, 500, 500))
region.save("region.png")

• 体验：第一次运行会弹出系统授权对话框，用户允许后就可以正常抓屏了，之后不会再弹（取决于compositor的权限设置），完全不干扰用户正常操作，性能上日常截图或者低帧率捕获足够，延迟很低。

方案2：极致性能——直接用pipewire Python库操作媒体流 #

如果你的需求是高频帧捕获/流媒体，要接近Windows下mss的性能，那直接操作PipeWire的视频流是最优解，因为PipeWire是为实时媒体设计的，支持零拷贝或者低拷贝的帧传输，和mss的底层逻辑类似。

• 先装Python的PipeWire绑定：pip install pipewire
• 核心思路：Wayland compositor会把屏幕输出作为一个PipeWire的视频源节点，你只需要找到这个节点，创建捕获流，然后直接读取帧缓冲区的数据。
• 简化代码示例（核心逻辑，需要根据自己的compositor调整节点查找逻辑）：

import pipewire
from pipewire import libpipewire as pw
import numpy as np

# 初始化PipeWire
pw.init()

# 创建核心实例并连接到PipeWire服务
core = pw.core_new()
core.connect()

# 枚举所有PipeWire节点，找到屏幕输出的monitor节点
# 这里需要遍历节点，筛选出类型为"Video/Output"的节点（不同compositor可能命名不同）
for node in core.get_nodes():
    props = node.props
    if props.get(pw.PW_KEY_MEDIA_TYPE) == "Video" and props.get(pw.PW_KEY_MEDIA_CATEGORY) == "Output":
        # 找到目标节点，创建捕获流
        stream = pw.stream_new(core, "screen-capture", pw.PW_MEDIA_TYPE_VIDEO, pw.PW_MEDIA_SUBTYPE_RGBA)
        # 设置帧接收回调，处理每一帧数据
        def on_frame_receive(buffer):
            # 从缓冲区读取帧数据，转成numpy数组（方便后续处理，比如用OpenCV）
            frame_data = np.frombuffer(buffer.datas[0].data, dtype=np.uint8)
            # 这里可以直接处理帧，比如显示、编码、保存
            print(f"Received frame with size: {buffer.datas[0].size}")
        
        stream.set_callback(on_frame_receive)
        # 连接到目标节点
        stream.connect(node)
        break

# 进入事件循环，持续捕获帧
try:
    while True:
        core.update()
except KeyboardInterrupt:
    pass

# 清理资源
stream.disconnect()
core.disconnect()

• 体验：性能拉满，延迟和CPU开销都极低，完全可以达到Windows下mss的水平，适合做实时流媒体或者高频截图的场景。唯一的缺点是需要写更多的底层代码，要熟悉PipeWire的节点模型。

方案3：其他备选——mss的Wayland支持（部分compositor可用） #

其实新版的mss已经开始支持Wayland了，但它的实现是基于xdg-desktop-portal的，所以需要系统装了对应的依赖，而且不是所有compositor都完美支持。你可以试试升级mss到最新版本，然后直接用原来的代码，说不定就能用：

from mss import mss

with mss() as sct:
    sct.shot()

• 体验：如果能用的话，代码完全不用改，和Windows下一模一样，但兼容性不如前两个方案，比如在Sway下可能需要额外配置，所以优先级不如前两个。

关于性能的疑问：能不能接近Windows下mss的水平？ #

完全可以！只要用方案2的PipeWire原生流方案，因为PipeWire的设计就是为了低延迟实时媒体，和Windows下的GDI/mss的底层逻辑类似，都是直接抓帧缓冲区的流，几乎没有多余的拷贝，CPU开销极低，延迟可以控制在几毫秒级别，和mss在Windows上的表现差不多。

最后总结 #

• 快速上手选pyscreenshot，省心省力，兼容性好
• 极致性能选pipewire Python库，适合流媒体/高频捕获
• 想复用旧代码可以试试新版mss
• 所有方案都符合Wayland的安全模型，第一次授权后就不会干扰用户，完全非侵入式

有问题随时问，我自己折腾过Sway和GNOME下的这几个方案，踩过不少坑，都能解决的！