Cua 是什么:给 Agent 使用的电脑、驱动和评测
Cua 源码导读:Python Driver 到 Fleet 目标
从 wrapper 与 fleet 模块阅读一条受限路径,不冒充完整仓库审计。
Cua 源码导读:Python Driver 到 Fleet 目标知识学习CN编辑简报更新 2026-09-29
你将学会
- 找到 Python 接口
- 识别 Fleet 交接点
- 记录有限的调用轨迹
开始前需要
- 可丢弃目标和获准执行的任务
- 理解宿主与客机状态的区别
为一个小型桌面任务保存观察、动作、策略和最终状态。
先看结论
- Python 包装层不能证明原生行为。
- Fleet 选择必须指向具体客机。
- 未审阅分支应保持明确。
找到 Python 接口
固定源码包含 cua_driver/wrapper.py 和 fleet.py。先从 wrapper 的公开方法读起,记下参数、返回对象和错误如何进入运行时接口。
Python 方法名不能证明所有平台的真实行为。原生实现与传输适配器可能有不同的权限和支持范围,Driver README 只提供阅读这些层的上下文。
识别 Fleet 交接点
fleet 模块可作为云端目标选择的源码入口。在断定 Driver 动作作用于哪台客机前,先记录 claim 或连接如何表示。
沙箱文档明确指出:建立 Fleet 池不会自动在客机安装 Driver。实际使用时要追踪集成路径与客机服务契约。
记录有限的调用轨迹
写下提交、方法签名、目标标识、策略模式和观察结果。若调用进入 Rust 或托管服务,应标记未审阅分支,不要凭空补足内部实现。
本文只看源码与文档,没有给运行中的桌面加追踪,也未测量 IPC 延迟。这些需要单独的受控试验。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
打开 wrapper.py 定位一个公开方法。
- 2
在 fleet.py 追踪目标选择。
- 3
标明仍需运行验证的传输与原生分支。
可复制示例
text
调用:Driver 方法
检查:参数 -> 目标 -> 策略 -> 传输
观察:动作后的截图或应用状态常见问题
本文审计了所有 Cua 包吗?
没有,仅阅读部分 Driver 与沙箱文件。
包装方法返回就证明操作成功吗?
需要从目标应用状态确认请求效果。
资料来源
- Cua / libs/cua-driver/README.md来源核查 2026-09-29
- Cua / libs/cua-driver/python/src/cua_driver/wrapper.py来源核查 2026-09-29
- Cua / libs/cua-driver/python/src/cua_driver/fleet.py来源核查 2026-09-29
- Cua / docs/content/docs/concepts/how-permission-policies-work.mdx来源核查 2026-09-29