计算机使用

计算机使用能力

通过辅助功能树与截图理解任意 macOS 界面,再用后台键鼠完成操作。

计算机使用(CU)让 Agent 操作没有 API 的应用 —— 只要有界面,它就能读、能点。

工具一览

计算机使用以 mcp__cu__* 工具的形式挂给 Agent。KimiCU 连上后共 11 个。

工具作用
list_apps列出正在运行的应用(名称、bundle id、pid)
get_app_state截图与可访问性树,可只取其一;返回带索引的节点
click按节点索引或截图坐标点击;不移动真实指针
drag从一点拖到另一点
drag_paths一次调用投递多条鼠标路径,用于绘制与连续手势
scroll按页或按行滚动,也可滚到指定节点
type_text输入 Unicode 文本,可先清空再输入,可带回车提交
set_value直接设置控件值(原生控件走 AXValue,Web 控件走后台替换)
press_key按键或组合键(cmd+a、return 这类写法)
select_text在文本元素里选中一段文本,或定位光标
perform_secondary_action触发元素的次要 AX 动作,例如弹出上下文菜单

为什么按控件而不是坐标

定位基于控件本身,所以窗口挪了位置、换了分辨率也不失效。索引来自最近一次 get_app_state,这也是为什么先读状态再操作。

两种「眼睛」

手段提供什么
辅助功能树控件的结构、角色与文本
截图视觉信息,补齐树里读不到的内容

两者结合,既能拿到「这是个按钮」,也能看到「它现在长什么样」。

按控件而不是坐标

定位基于控件本身而不是硬编码坐标,所以窗口挪了位置、换了分辨率也不失效。这比「点 (120, 480)」稳得多。

后台输入,不抢前台

操作在后台投递:不需要把窗口抢到前台,也不碰你的鼠标指针。你可以继续用电脑做别的事。

权限准备

首次使用需要在「系统设置 → 隐私与安全性」里给 DSH 授予:

  • 辅助功能(读取控件树、投递输入)
  • 屏幕录制(截图)

危险动作先确认

发送、删除、购买、发布这类不可逆操作,会先说明再做。

下一步