CUA AI 操作¶
CUA（Computer Use Agent）可以根据自然语言任务读取当前 KVM 画面，并执行鼠标、键盘等操作。适合打开软件、点击按钮、输入内容等交互式任务。任务通过控制台右上角工具栏的 AI 面板运行，面板会显示连接状态、思考过程、截图和已执行动作。
初步版本
CUA 仍在持续迭代，模型能力、兼容性和执行稳定性取决于所使用的模型与 API 服务。
使用前确认
CUA 会直接控制被控机的鼠标和键盘。涉及删除文件、格式化磁盘、修改系统配置或提交表单的任务，请先确认提示词准确，并在可以观察执行过程的环境中使用。
配置项¶
打开 AI → 设置，可配置以下项目：
| 项目 | 说明 | 默认值 |
|---|---|---|
| 启用 AI 操作 | 允许从 AI 面板启动任务 | 关闭 |
| 模型 | 发给兼容接口的模型名称 | gpt-5.5 |
| API URL | 必须是完整的 HTTP(S) 接口地址，并包含 /responses 或 /chat/completions |
https://api.openai.com/v1/responses |
| API Key | 调用模型的密钥 | 未配置 |
API Key 可以在设置页保存，也可以通过环境变量 ONE_KVM_CUA_API_KEY 或 OPENAI_API_KEY 提供；环境变量优先于配置文件。API URL 也支持通过 ONE_KVM_CUA_BASE_URL 或 ONE_KVM_OPENAI_BASE_URL 覆盖。
使用方法¶
- 打开 KVM 控制台，点击顶部工具栏中的 AI。
- 在 设置 中启用 AI 操作，填写模型、API URL 和 API Key，点击 保存。
- 在输入框中描述任务；按
Ctrl+Enter（macOS 也可用⌘+Enter）发送。 - CUA 会循环获取当前画面、请求模型决定下一步，并执行支持的鼠标、键盘、滚动、拖拽、等待和截图动作。
- 任务运行中点击 停止 可中断；点击 清空 可清除当前执行记录。
未配置 API Key 或 AI 操作未启用时，不能开始任务。
