命令參考

觀察桌面

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。