命令参考

观察桌面

screenshot 不需要位置参数。它把当前合并桌面的截图以 base64 PNG 的形式写到标准输出。

nano-use screenshot

指针操作

click x y 发送一次左键单击。right_click x y 发送一次右键单击。double_click x y 发送两次左键单击。这三个命令都会根据一个轴对齐外接矩形来校验坐标——这个矩形包住了所有活动显示器，但不会逐块判断，所以显示器之间的空隙也能通过校验。

drag x1 y1 x2 y2 校验两个端点，然后依次发送左键按下、拖动和左键松开事件。

nano-use click 320 240
nano-use right_click 320 240
nano-use double_click 320 240
nano-use drag 320 240 640 480

文本与按键操作

type text 把给定的非空字符串作为键盘事件发送。keypress keys 接受一个主键加可选的修饰键，用 + 连接，比如 cmd+return 或 shift+a。这个版本里可用的命名键包括方向键、导航键、两类删除键，以及 f1 到 f12。

nano-use type "有边界的文本"
nano-use keypress cmd+return

在指定位置滚动

scroll x y dy 先校验坐标并把光标移到该位置，然后用有符号整数 dy 发送一次像素单位的垂直滚动事件。

nano-use scroll -- 320 240 -480

这些都是位置参数，不是 flag。程序没有定义其他命令别名。

调用与结果约定

示例假设你已按"快速开始"设置了 PATH。没有的话，把 nano-use 换成 ./target/release/nano-use。输入示例会改变当前桌面状态，建议在焦点明确的临时文档里测试。

如果某个位置参数以 - 开头，在它前面加 --，比如 nano-use click -- -100 240 或 nano-use type -- "-draft"。不然解析器会把它当作选项处理。

坐标是浮点桌面坐标，dy 是有符号 32 位整数。修饰键包括 cmd/command、ctrl/control、alt/option、shift、fn/function，组合里只能有一个主键。字母键码按 US 键盘布局映射；想输入任意文本的话用 type。

输入命令成功时通常不产生 stdout 输出，需要再截一张图来验证效果。解析错误以退出码 2 结束，已处理的运行时错误以退出码 1 结束并在 stderr 输出信息。程序不会返回操作结果 JSON。