diff --git a/README.md b/README.md index fd7d0ed..fe167ca 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/trycua/cua) · [上游 README](https://github.com/trycua/cua/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 +
@@ -7,7 +13,7 @@ -

Build, benchmark, and deploy agents that use computers

+

构建、评测并部署使用计算机的智能体（agent）

cua.ai @@ -20,14 +26,14 @@

-## Choose Your Path +## 选择你的路径
@@ -50,18 +56,18 @@
- Cua Drivers — background computer-use for any agent + Cua Drivers — 适用于任意智能体的后台计算机使用

- Building your own agent? Start with Cua · - Giving a coding agent a computer? Cua Drivers · - Evaluating or training models? Cua Bench · - Need macOS VMs? Lume + 正在构建自己的智能体？ 从 Cua 开始 · + 想让编码智能体拥有计算机？ Cua Drivers · + 需要评测或训练模型？ Cua Bench · + 需要 macOS 虚拟机？ Lume

--- -## Cua Drivers - Background computer-use on macOS, Windows, and Linux +## Cua Drivers - 在 macOS、Windows 和 Linux 上后台使用计算机 -Drive native desktop apps **in the background**. Agents click, type, and verify without stealing the cursor or focus. Use the same CLI and MCP server on macOS, Windows, and Linux from Claude Code, Cursor, Codex, OpenClaw, and custom clients. Linux supports X11 and compositor-specific Wayland routes with explicit limits for raw background input. +在**后台**驱动原生桌面应用。智能体可点击、输入并验证，而不会抢走光标或焦点。在 macOS、Windows 和 Linux 上使用同一套 CLI 与 MCP 服务器，可从 Claude Code、Cursor、Codex、OpenClaw 及自定义客户端接入。Linux 支持 X11 以及针对合成器（compositor）的 Wayland 路径，但对原始后台输入有明确限制。 **macOS / Linux** @@ -75,19 +81,19 @@ Drive native desktop apps **in the background**. Agents click, type, and verify irm https://cua.ai/driver/install.ps1 | iex ``` -Then wire it into Claude Code as an MCP server and your agent can drive the desktop in the background: +然后将其作为 MCP 服务器接入 Claude Code，你的智能体即可在后台驱动桌面： ```bash claude mcp add --transport stdio cua-driver -- cua-driver mcp ``` -Full tool reference, architecture notes, and the optional agent skill pack live here: [`libs/cua-driver/README.md`](libs/cua-driver/README.md). +完整工具参考、架构说明及可选的智能体技能包见：[`libs/cua-driver/README.md`](libs/cua-driver/README.md)。 --- -## Cua - Agent-Ready Sandboxes for Any OS +## Cua - 适用于任意操作系统的智能体就绪沙箱 -Build agents that see screens, click buttons, and complete tasks autonomously. One API for any VM or container image — cloud or local. +构建能查看屏幕、点击按钮并自主完成任务的智能体。一套 API 适用于任意虚拟机或容器镜像——云端或本地均可。 ```sh pip install cua @@ -106,18 +112,18 @@ async with Sandbox.ephemeral(Image.linux()) as sb: # or .macos() .windows() .a await sb.mobile.gesture((100, 500), (100, 200)) # multi-touch gestures ``` -| | Linux container | Linux VM | macOS | Windows | Android | BYOI (.qcow2, .iso) | +| | Linux 容器 | Linux 虚拟机 | macOS | Windows | Android | BYOI（.qcow2、.iso） | | ------------------ | --------------- | -------- | ----- | ------- | ------- | ------------------- | -| **Cloud (cua.ai)** | ✅ | ✅ | ✅ | ✅ | ✅ | 🔜 soon | -| **Local (QEMU)** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | +| **云端（cua.ai）** | ✅ | ✅ | ✅ | ✅ | ✅ | 🔜 即将推出 | +| **本地（QEMU）** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | -**[Get Started](https://cua.ai/docs/cua/guide/get-started/set-up-sandbox)** | **[Examples](https://cua.ai/docs/cua/examples)** | **[API Reference](https://cua.ai/docs/cua/reference/agent-sdk)** +**[快速开始](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 - Benchmarks & RL Environments +## Cua-Bench - 基准测试与强化学习（RL）环境 -Evaluate computer-use agents on OSWorld, ScreenSpot, Windows Arena, and custom tasks. Export trajectories for training. +在 OSWorld、ScreenSpot、Windows Arena 及自定义任务上评测计算机使用智能体。导出轨迹用于训练。 ```bash # Clone, install, and create base image @@ -128,13 +134,13 @@ uv tool install -e . && cb image create linux-docker cb run dataset datasets/cua-bench-basic --agent cua-agent --max-parallel 4 ``` -**[Get Started](https://cua.ai/docs/cuabench/guide/getting-started/first-steps)** | **[Partner With Us](https://cuabench.ai/)** | **[Registry](https://cuabench.ai/registry)** | **[CLI Reference](https://cua.ai/docs/cuabench/reference/cli-reference)** +**[快速开始](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 Virtualization +## Lume - macOS 虚拟化 -Create and manage macOS/Linux VMs with near-native performance on Apple Silicon using Apple's Virtualization.Framework. +使用 Apple 的 Virtualization.Framework，在 Apple Silicon 上创建和管理 macOS/Linux 虚拟机，性能接近原生。 ```bash # Install Lume @@ -146,60 +152,59 @@ lume create macos-tahoe --ipsw ~/Downloads/macos-tahoe.ipsw --unattended tahoe lume run macos-tahoe ``` -The `--unattended` option prepares the installed guest offline. The built-in -`sequoia` and `tahoe` presets create the `lume` user, enable SSH, configure -autologin, and disable sleep and screen locking. The default credentials are -`lume` / `lume`. +`--unattended` 选项会离线准备已安装的客户机。内置的 +`sequoia` 与 `tahoe` 预设会创建 `lume` 用户、启用 SSH、配置 +自动登录，并禁用休眠与屏幕锁定。默认凭据为 +`lume` / `lume`。 -The Tahoe flow is E2E verified. Sequoia may still open the Accessibility step -of Setup Assistant on its first display boot; see [issue #2155](https://github.com/trycua/cua/issues/2155). +Tahoe 流程已通过端到端（E2E）验证。Sequoia 在首次显示启动时可能仍会打开设置助理（Setup Assistant）的无障碍步骤；详见 [issue #2155](https://github.com/trycua/cua/issues/2155). -**[Get Started](https://cua.ai/docs/lume)** | **[FAQ](https://cua.ai/docs/lume/guide/getting-started/faq)** | **[CLI Reference](https://cua.ai/docs/lume/reference/cli-reference)** +**[快速开始](https://cua.ai/docs/lume)** | **[常见问题](https://cua.ai/docs/lume/guide/getting-started/faq)** | **[CLI 参考](https://cua.ai/docs/lume/reference/cli-reference)** --- -## Packages +## 软件包 -| Package | Description | +| 软件包 | 说明 | | -------------------------------------------------------------------- | ----------------------------------------------------------- | -| [cua-driver](libs/cua-driver/README.md) | Background computer-use agent for macOS, Windows, and Linux | -| [cua-agent](https://cua.ai/docs/cua/reference/agent-sdk) | AI agent framework for computer-use tasks | -| [cua-sandbox](https://cua.ai/docs/cua/reference/sandbox-sdk) | SDK for creating and controlling sandboxes | -| [cua-computer-server](https://cua.ai/docs/cua/reference/sandbox-sdk) | Driver for UI interactions and code execution in sandboxes | -| [cua-bench](https://cua.ai/docs/cuabench) | Benchmarks and RL environments for computer-use | -| [lume](https://cua.ai/docs/lume) | macOS/Linux VM management on Apple Silicon | -| [lumier](https://cua.ai/docs/lume/guide/advanced/lumier) | Docker-compatible interface for Lume VMs | +| [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 兼容接口 | -## Resources +## 资源 -- [Documentation](https://cua.ai/docs) — Guides, examples, and API reference -- [Blog](https://cua.ai/blog) — Tutorials, updates, and research -- [Discord](https://discord.com/invite/mVnXXpdE85) — Community support and discussions -- [GitHub Issues](https://github.com/trycua/cua/issues) — Bug reports and feature requests +- [文档](https://cua.ai/docs) — 指南、示例与 API 参考 +- [博客](https://cua.ai/blog) — 教程、更新与研究 +- [Discord](https://discord.com/invite/mVnXXpdE85) — 社区支持与讨论 +- [GitHub Issues](https://github.com/trycua/cua/issues) — 错误报告与功能请求 -## Contributing +## 贡献 -We welcome contributions! See our [Contributing Guidelines](CONTRIBUTING.md) for details. +我们欢迎贡献！详情请参阅 [贡献指南](CONTRIBUTING.md)。 -## License +## 许可证 -MIT License — see [LICENSE](LICENSE.md) for details. +MIT 许可证 — 详情请参阅 [LICENSE](LICENSE.md)。 -Third-party components have their own licenses: +第三方组件有各自的许可证： - [Kasm](libs/kasm/LICENSE) (MIT) - [OmniParser](https://github.com/microsoft/OmniParser/blob/master/LICENSE) (CC-BY-4.0) -- Optional `cua-agent[omni]` includes ultralytics (AGPL-3.0) +- 可选的 `cua-agent[omni]` 包含 ultralytics（AGPL-3.0） -## Trademarks +## 商标 -Apple, macOS, Ubuntu, Canonical, and Microsoft are trademarks of their respective owners. This project is not affiliated with or endorsed by these companies. +Apple、macOS、Ubuntu、Canonical 与 Microsoft 均为其各自所有者的商标。本项目与上述公司无任何关联，亦未获其认可。 ---
-Thank you to all our [GitHub Sponsors](https://github.com/sponsors/trycua)! +感谢所有 [GitHub Sponsors](https://github.com/sponsors/trycua)! coderabbit-cli