權限與疑難排解

螢幕錄製

screenshot 路徑使用 ScreenCaptureKit。請將「螢幕錄製」權限授予實際啟動 nano-use 的終端機或智慧體宿主程序。截圖為空或無法取得時，應將它視為觀察失敗，不能據此判斷桌面為空。

輔助使用

click、right_click、double_click、drag、type、keypress 與 scroll 會送出本機輸入事件。依賴這些操作前，請給啟動程序授予「輔助使用」權限。

座標與顯示器

游標與捲動命令會根據包住所有作用中顯示器矩形的一個軸對齊外接矩形檢查座標。位於該矩形之外的點會在事件送出前失敗；但原始碼不會逐一檢查實際顯示器，因此顯示器之間的空隙也可能通過檢查。多顯示器配置可能包含非零或負原點，應從目前觀察推導座標並確認目標顯示器，不要假設單一螢幕從零開始。

命令錯誤

type 與 keypress 拒絕空值。keypress 會拒絕未知主鍵，或包含多個主鍵的組合。截圖編碼、事件建構、輸出寫入與顯示器探索也可能回傳本機錯誤。

復原順序

1. 重新執行 nano-use --help，確認正在呼叫的二進位檔案。
2. 檢查啟動程序的「螢幕錄製」或「輔助使用」權限。
3. 推導座標前重新取得一次觀察。
4. 只重試最小的預期操作，並檢查它的結果。