5分钟上手CUA Computer SDK像PyAutoGUI一样控制虚拟机【免费下载链接】cuaScale computer-use 2.0 with open-source drivers, cross-OS fleets, and benchmarks for training, evaluation, and data generation.项目地址: https://gitcode.com/GitHub_Trending/cua/cua还在手动一个个启动虚拟机、跑测试用例、截图、再清理吗本文带你用5分钟跑通CUA Computer SDK一个Python类搞定虚拟机生命周期管理、键鼠模拟与屏幕捕获学习成本和你熟悉的PyAutoGUI差不多只是对象换成了虚拟机。它能解决什么问题CI 截图回归按需拉起一个容器化 Linux 桌面自动开页面、截全屏图跑完即销毁不用维护测试机。AI Agent 沙箱执行Agent 只通过接口拿到坐标与按键所有动作隔离在虚拟机里即使跑飞也不会碰你的宿主机。跨平台验证同一套脚本控制 macOS / Linux / Windows / Android 镜像切换os_type与image即可。最小可用示例先看全貌安装、拉起一台 Ubuntu 虚拟机、截图、退出20 行以内跑完。# 一键安装Python 3.10 pip install cua-computer[all]import asyncio from computer import Computer async def main(): # 拉起本地 Linux 虚拟机Lume 虚拟化默认镜像 trycua/cua-ubuntu:latest computer Computer(os_typelinux, provider_typelume) await computer.run() # 启动虚拟机并等待就绪 shot await computer.interface.screenshot() # 整屏截图PNG 字节串 open(desktop.png, wb).write(shot) # 直接落盘 await computer.interface.move_cursor(320, 240) # 移动鼠标 await computer.interface.type_text(hello cua) # 输入文本 await computer.stop() # 安全停机释放资源 asyncio.run(main())拆解初始化参数display默认 1024x768、memory默认 8GB、cpu默认 4本地跑基本不用动。关键是provider_typelume走本地 Lume 虚拟化、qemu走 QEMU、cloud连云端沙箱同一份代码在开发机和 CI 上都能用。拆解键鼠与截图interface下的方法可类比 PyAutoGUImove_cursor移动、left_click点击、type_text输入、hotkey(*keys)组合键screenshot()返回 PNG 字节可直接写文件也可以丢给视觉模型做判断。拆解资源清理生产脚本里务必用try/finally包住确保await computer.stop()一定执行否则虚拟机进程会一直占着内存和端口。能力全景维度选项说明操作系统macos / linux / windows / androidos_type切换自动选默认镜像虚拟化后端lume / qemu / cloudprovider_type切换cloud 模式需api_key默认读CUA_API_KEY输入控制点击 / 移动 / 输入 / 组合键left_click、move_cursor、type_text、hotkey屏幕捕获全屏 PNG 字节interface.screenshot()语言绑定Python / TypeScriptTS 版见 libs/typescript/computer/进阶如果 computer-server 已经在别处跑着比如容器里现成的沙箱可以不启动新虚拟机直连已有端点# 连接已运行的 computer-server常用于反代/认证代理后面 computer Computer( os_typelinux, use_host_computer_serverTrue, # 不启动虚拟机直连服务端 api_base_urlhttps://your-proxy/api/svc/ns/sandbox-api, api_keyyour-api-key, # 也可走 CUA_API_KEY 环境变量 )完整参数参考docs/content/docs/reference/sandbox-sdk/index.mdx常见坑与排错现象lume启动报错或虚拟机起不来→ 本机未安装 Lume 或权限不足 → 按官方指南安装后再试或临时改provider_typeqemu绕开。现象首次run()后截图全黑或连接超时→ 虚拟机还在开机显示服务未就绪 → 调大构造参数timeout并在首次操作前稍等几秒。现象cloud 模式连接被拒→api_key缺失或代理地址拼错 → 设置CUA_API_KEY环境变量走认证代理时再传api_headers含 Authorization 头。沙箱机制与生命周期docs/content/docs/concepts/how-sandboxes-work.mdx下一步 / 学习路径读概念入门理解 Computer-Use 的边界与术语docs/content/docs/concepts/what-is-computer-use.mdx为你的场景挑选桌面镜像XFCE / Kasm / Ubuntudocs/content/docs/how-to-guides/sandbox/images.mdx本地 macOS 场景安装 Lume 并管理虚拟机列表docs/content/docs/how-to-guides/lume/manage-vms.mdx从此虚拟机自动化可以写得和 PyAutoGUI 一样短不用再手动开虚、手动清理也不怕测试脚本碰到宿主机。【免费下载链接】cuaScale computer-use 2.0 with open-source drivers, cross-OS fleets, and benchmarks for training, evaluation, and data generation.项目地址: https://gitcode.com/GitHub_Trending/cua/cua创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考