視窗客戶區幾何

window_capture.get_window_geometry 回傳視窗的*外框*邊界框(供截圖),但沒有*客戶區*矩形、沒有框邊內縮運算、 也沒有客戶區→螢幕的點對應。RPA 需要「不論標題列高度 / 邊框,在此視窗客戶區的 (x, y) 點擊」——這是視窗相對 點擊的基礎。本功能加入客戶區矩形、純框邊內縮與客戶區轉螢幕輔助函式,以及一次呼叫的 client_point。

frame_insets / client_to_screen 是純幾何(可無頭測試);只有 get_client_rect 的預設讀取器觸及 Win32 (GetClientRect + ClientToScreen),且可注入。不匯入 PySide6。

無頭 API

from je_auto_control import (get_client_rect, client_point, frame_insets,
                             client_to_screen)

# 從視窗內容原點(非標題列)往內 20px、往下 30px 點擊。
point = client_point("Calculator", 20, 30)
if point:
    click(*point)

rect = get_client_rect("Calculator")               # (x, y, width, height)
insets = frame_insets(get_window_geometry("Calculator"), rect)  # 邊框大小

get_client_rect 以螢幕座標原點回傳客戶區的 (x, y, width, height)``(或 ``None);``client_point`` 把客戶區 區域內的點對應到螢幕,讓點擊不論視窗外框都落在內容上。frame_insets 由外框與客戶區矩形回傳 {left, top, right, bottom} 邊框 / 標題列厚度,``client_to_screen`` 則是底層的純位移。

執行器命令

AC_get_client_rect``(``title → {found, rect})與 AC_client_point``(``title / x / y → {found, point})。它們以 MCP 工具 ac_get_client_rect / ac_client_point 以及 Script Builder 中 Window 分類下的命令提供。