依顏色定位螢幕區域

color_stats 只*描述*區域的主要 / 平均顏色,``assert_pixel`` 檢查單一點及容差——兩者都不*定位*彩色區域。 當唯一訊號是顏色時(狀態燈、進度條填充、紅色錯誤橫幅),模板比對很脆弱。本功能將接近目標 RGB(在容差內)的 像素遮罩起來,並回傳相連區塊的邊界框。

遮罩與相連元件分析在可注入的 haystack 影像(ndarray / 路徑 / PIL)上執行,因此可在無真實螢幕下對合成陣列 做單元測試。OpenCV + NumPy 透過專案的 je_open_cv 相依引入。不匯入 PySide6。

無頭 API

from je_auto_control import find_color_region, find_color_regions

pill = find_color_region([0, 200, 0], tolerance=25)      # 綠色狀態藥丸
if pill:
    click(*pill["center"])

for banner in find_color_regions([200, 0, 0], min_area=500):
    print(banner["x"], banner["y"], banner["area"])      # 每個紅色區塊

find_color_regions 為每個在 tolerance``(各通道)內接近 ``rgb 且至少 min_area 像素的區塊回傳 {x, y, width, height, area, center},由大到小;``find_color_region`` 僅回傳最大的(或 None)。 haystack 預設為對選用 region 的螢幕擷取。

執行器命令

AC_find_color_region 接受 rgb``(JSON ``[r, g, b] 陣列)以及 tolerance / min_area / region, 並回傳 {count, regions, best}。它以 MCP 工具 ac_find_color_region 以及 Script Builder 中 Image 分類下的命令提供。