权限与故障排查

屏幕录制

screenshot 路径使用 ScreenCaptureKit。请把“屏幕录制”权限授予实际启动 nano-use 的终端或智能体宿主进程。截图为空或不可用时，应把它视为观察失败，不能据此判断桌面为空。

辅助功能

click、right_click、double_click、drag、type、keypress 和 scroll 会发送本地输入事件。依赖这些操作前，请给启动进程授予“辅助功能”权限。

坐标与显示器

指针和滚动命令会根据包住所有活动显示器矩形的一个轴对齐外接矩形检查坐标。位于该矩形之外的点会在事件发送前失败；但源码不会逐个检查真实显示器，因此显示器之间的空隙也可能通过检查。多显示器布局可能包含非零或负原点，应从当前观察推导坐标并确认目标显示器，不要假设单个屏幕从零开始。

命令错误

type 和 keypress 拒绝空值。keypress 会拒绝未知主键，或包含多个主键的组合。截图编码、事件构造、输出写入和显示器发现也可能返回本地错误。

恢复顺序

1. 重新运行 nano-use --help，确认正在调用的二进制文件。
2. 检查启动进程的“屏幕录制”或“辅助功能”权限。
3. 推导坐标前重新获取一次观察。
4. 只重试最小的预期操作，并检查它的结果。