mirrors / trycua--cua

项目文件夹

trycua--cua
文件
main
T
wehub-resource-sync 75d92d0be7 docs: make Chinese README the default
2026-07-13 10:11:19 +00:00

212 行
9.5 KiB
Markdown
原始文件 永久链接 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的，可以安全地忽略该警告。 使用 Escape 按钮显示他们。
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/trycua/cua) · [上游 README](https://github.com/trycua/cua/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
<div align="center">
<a href="https://cua.ai" target="_blank" rel="noopener noreferrer">
<picture>
<source media="(prefers-color-scheme: dark)" alt="Cua logo" width="150" srcset="img/logo_white.svg">
<source media="(prefers-color-scheme: light)" alt="Cua logo" width="150" srcset="img/logo_black.svg">
<img alt="Cua logo" width="150" src="img/logo_black.svg">
</picture>
</a>
<p align="center">构建、评测并部署使用计算机的智能体（agent）</p>
<p align="center">
<a href="https://cua.ai" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/cua.ai-0ea5e9" alt="cua.ai"></a>
<a href="https://discord.gg/mVnXXpdE85" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/Discord-Join%20Server-10b981?logo=discord&logoColor=white" alt="Discord"></a>
<a href="https://x.com/trycua" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/twitter/follow/trycua?style=social" alt="Twitter"></a>
<a href="https://cua.ai/docs" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/Docs-0ea5e9.svg" alt="Documentation"></a>
<br>
<a href="https://trendshift.io/repositories/13685" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13685" alt="trycua%2Fcua | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
</p>
</div>
## 选择你的路径
<div align="center">
<table>
<tr>
<td colspan="3" align="center">
<a href="#cua-drivers---background-computer-use-on-macos-and-windows-with-linux-pre-release">
<img src="img/card-cua-driver.gif" alt="Cua Drivers — 适用于任意智能体的后台计算机使用" width="790">
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="#cua---agent-ready-sandboxes-for-any-os">
<img src="img/card-cua-sandbox.gif" alt="Cua &amp; Cua Sandbox" width="246">
</a>
</td>
<td align="center">
<a href="#cua-bench---benchmarks--rl-environments">
<img src="img/card-cua-bench.gif" alt="Cua Bench" width="246">
</a>
</td>
<td align="center">
<a href="#lume---macos-virtualization">
<img src="img/card-cua-lume.gif" alt="Lume" width="246">
</a>
</td>
</tr>
</table>
<p>
<strong>正在构建自己的智能体？</strong> 从 <a href="#cua---agent-ready-sandboxes-for-any-os">Cua</a> 开始 ·
<strong>想让编码智能体拥有计算机？</strong> <a href="#cua-drivers---background-computer-use-on-macos-and-windows-with-linux-pre-release">Cua Drivers</a> ·
<strong>需要评测或训练模型？</strong> <a href="#cua-bench---benchmarks--rl-environments">Cua Bench</a> ·
<strong>需要 macOS 虚拟机？</strong> <a href="#lume---macos-virtualization">Lume</a>
</p>
</div>
---
## Cua Drivers - 在 macOS、Windows 和 Linux 上后台使用计算机
在**后台**驱动原生桌面应用。智能体可点击、输入并验证，而不会抢走光标或焦点。在 macOS、Windows 和 Linux 上使用同一套 CLI 与 MCP 服务器，可从 Claude Code、Cursor、Codex、OpenClaw 及自定义客户端接入。Linux 支持 X11 以及针对合成器（compositor）的 Wayland 路径，但对原始后台输入有明确限制。
**macOS / Linux**
```sh
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"
```
**Windows (PowerShell)**
```powershell
irm https://cua.ai/driver/install.ps1 | iex
```
然后将其作为 MCP 服务器接入 Claude Code，你的智能体即可在后台驱动桌面：
```bash
claude mcp add --transport stdio cua-driver -- cua-driver mcp
```
完整工具参考、架构说明及可选的智能体技能包见：[`libs/cua-driver/README.md`](libs/cua-driver/README.md)。
---
## Cua - 适用于任意操作系统的智能体就绪沙箱
构建能查看屏幕、点击按钮并自主完成任务的智能体。一套 API 适用于任意虚拟机或容器镜像——云端或本地均可。
```sh
pip install cua
```
```python
# Requires Python 3.11 or later
from cua import Sandbox, Image
# Same API regardless of OS or runtime
async with Sandbox.ephemeral(Image.linux()) as sb: # or .macos() .windows() .android()
result = await sb.shell.run("echo hello")
screenshot = await sb.screenshot()
await sb.mouse.click(100, 200)
await sb.keyboard.type("Hello from Cua!")
await sb.mobile.gesture((100, 500), (100, 200)) # multi-touch gestures
```
| | Linux 容器 | Linux 虚拟机 | macOS | Windows | Android | BYOI（.qcow2、.iso） |
| ------------------ | --------------- | -------- | ----- | ------- | ------- | ------------------- |
| **云端（cua.ai）** | ✅ | ✅ | ✅ | ✅ | ✅ | 🔜 即将推出 |
| **本地（QEMU）** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
**[快速开始](https://cua.ai/docs/cua/guide/get-started/set-up-sandbox)** | **[示例](https://cua.ai/docs/cua/examples)** | **[API 参考](https://cua.ai/docs/cua/reference/agent-sdk)**
---
## Cua-Bench - 基准测试与强化学习（RL）环境
在 OSWorld、ScreenSpot、Windows Arena 及自定义任务上评测计算机使用智能体。导出轨迹用于训练。
```bash
# Clone, install, and create base image
git clone https://github.com/trycua/cua && cd cua/cua-bench
uv tool install -e . && cb image create linux-docker
# Run benchmark with agent
cb run dataset datasets/cua-bench-basic --agent cua-agent --max-parallel 4
```
**[快速开始](https://cua.ai/docs/cuabench/guide/getting-started/first-steps)** | **[与我们合作](https://cuabench.ai/)** | **[注册表](https://cuabench.ai/registry)** | **[CLI 参考](https://cua.ai/docs/cuabench/reference/cli-reference)**
---
## Lume - macOS 虚拟化
使用 Apple 的 Virtualization.Framework，在 Apple Silicon 上创建和管理 macOS/Linux 虚拟机，性能接近原生。
```bash
# Install Lume
/bin/bash -c "$(curl -fsSL https://cua.ai/lume/install.sh)"
# Create and start a vanilla macOS VM from an Apple restore image
curl -L "$(lume ipsw | tail -n 1)" -o ~/Downloads/macos-tahoe.ipsw
lume create macos-tahoe --ipsw ~/Downloads/macos-tahoe.ipsw --unattended tahoe
lume run macos-tahoe
```
`--unattended` 选项会离线准备已安装的客户机。内置的
`sequoia` 与 `tahoe` 预设会创建 `lume` 用户、启用 SSH、配置
自动登录，并禁用休眠与屏幕锁定。默认凭据为
`lume` / `lume`。
Tahoe 流程已通过端到端（E2E）验证。Sequoia 在首次显示启动时可能仍会打开设置助理（Setup Assistant）的无障碍步骤；详见 [issue #2155](https://github.com/trycua/cua/issues/2155).
**[快速开始](https://cua.ai/docs/lume)** | **[常见问题](https://cua.ai/docs/lume/guide/getting-started/faq)** | **[CLI 参考](https://cua.ai/docs/lume/reference/cli-reference)**
---
## 软件包
| 软件包 | 说明 |
| -------------------------------------------------------------------- | ----------------------------------------------------------- |
| [cua-driver](libs/cua-driver/README.md) | 适用于 macOS、Windows 和 Linux 的后台计算机使用智能体 |
| [cua-agent](https://cua.ai/docs/cua/reference/agent-sdk) | 用于计算机使用任务的 AI 智能体框架 |
| [cua-sandbox](https://cua.ai/docs/cua/reference/sandbox-sdk) | 用于创建和控制沙箱的 SDK |
| [cua-computer-server](https://cua.ai/docs/cua/reference/sandbox-sdk) | 沙箱中 UI 交互与代码执行的驱动 |
| [cua-bench](https://cua.ai/docs/cuabench) | 计算机使用的基准测试与 RL 环境 |
| [lume](https://cua.ai/docs/lume) | Apple Silicon 上的 macOS/Linux 虚拟机管理 |
| [lumier](https://cua.ai/docs/lume/guide/advanced/lumier) | Lume 虚拟机的 Docker 兼容接口 |
## 资源
- [文档](https://cua.ai/docs) — 指南、示例与 API 参考
- [博客](https://cua.ai/blog) — 教程、更新与研究
- [Discord](https://discord.com/invite/mVnXXpdE85) — 社区支持与讨论
- [GitHub Issues](https://github.com/trycua/cua/issues) — 错误报告与功能请求
## 贡献
我们欢迎贡献！详情请参阅 [贡献指南](CONTRIBUTING.md)。
## 许可证
MIT 许可证 — 详情请参阅 [LICENSE](LICENSE.md)。
第三方组件有各自的许可证：
- [Kasm](libs/kasm/LICENSE) (MIT)
- [OmniParser](https://github.com/microsoft/OmniParser/blob/master/LICENSE) (CC-BY-4.0)
- 可选的 `cua-agent[omni]` 包含 ultralytics（AGPL-3.0）
## 商标
Apple、macOS、Ubuntu、Canonical 与 Microsoft 均为其各自所有者的商标。本项目与上述公司无任何关联，亦未获其认可。
---
<div align="center">
感谢所有 [GitHub Sponsors](https://github.com/sponsors/trycua)!
<img width="300" alt="coderabbit-cli" src="https://github.com/user-attachments/assets/23a98e38-7897-4043-8ef7-eb990520dccc" />
</div>
在新工单中引用 查看 Git Blame 复制永久链接