=j1UdZddlmZddlZddlZddlZddlZddlZddlm Z m Z m Z ddl Z ddl Z ddlZddlZddlZddlZddlmZmZdaded<d d ZGd d ZdS)u1 Poe2VisualTool Item Hover Watcher (Passive Win32 Mouse & Clipboard Listener) Theo dõi vị trí con trỏ chuột thụ động ở tần số 40Hz (25ms) qua Win32 API. Focus Interlock: Chỉ kích hoạt khi cửa sổ game PathOfExile.exe (hoặc Poe2VisualTool.exe) đang Active. Hover Dwell Tracker: Khi chuột đứng yên <= 5px trong >= 180ms: - Gửi xung Ctrl+C an toàn qua keybd_event. - Đọc clipboard thụ động qua win32clipboard. - Phân tích và gọi callback on_item_inspected(report, cursor_x, cursor_y). - Debounce bằng MD5 hash tránh spam phím lặp lại vô nghĩa. Mouse Move Trigger: Khi chuột di chuyển > 8px, gọi callback on_cursor_moved() để tắt tooltip tức thì (0ms). 100% Zero-Disk, Zero-Memory-Write, Zero-Ban risk. Bối cảnh: 13/09/2026 (Rule 2) ) annotationsN)CallableOptionalTuple)ItemInspectionReport inspect_itemz Optional[int]_global_default_deskreturnboolcJtjdkrdS ddl}|jj}|ddd}|r|||dddd}|r&||t|a dSn#t$rYnwxYwdS) uZĐảm bảo luồng chạy gắn vào interactive desktop 'default' của người dùng.ntFrNWinSta0iDefaultT) osnamectypeswindlluser32OpenWindowStationWSetProcessWindowStation OpenDesktopWSetThreadDesktopintr Exception)rrhwinstahdesks >c:\Projects\Poe2VisualTool\src\assistant\item_hover_watcher.pyattach_to_default_desktopr$s w$u   %++IujII  4  * *7 3 3 3##Iq%DD    # #E * * *#&u:: 4       5sAA>c|j5d|_dddn #1swxYwY|jr=|jr&|jdd|_dSdSdS)uDừng luồng giám sát.FNg?)timeout)r5r1r2is_alivejoinrFs rstopzItemHoverWatcher.stoprs Z " "!DM " " " " " " " " " " " " " " " < DL1133 L  c  * * *DLLL    s   c|jSN)r1rFs r is_runningzItemHoverWatcher.is_runningzs }r=Tuple[int, int]ch|j|jS tjS#t$rYdSwxYw)uILấy tọa độ chuột hiện tại (hỗ trợ mock khi chạy test).N)rr)r8win32gui GetCursorPosrrFs rget_cursor_poszItemHoverWatcher.get_cursor_pos~sJ  ,( ( (** *   66 s # 11c |j|jS|jsdS tj}|sdStj|pd}tj|pd}d|vrdSd|vrdS|jD]C}|dd}||vrdSDtj |\}}|dkrdS|tj krdStj|}| t! fd |jDS#t"$rYdSwxYw) uPFocus Interlock: Kiểm tra cửa sổ foreground có phải client POE2 không.NTFr/poez path of exilez.exerc3DK|]}|vVdSrM)lower).0p proc_names r z:ItemHoverWatcher.is_game_window_focused..s0NN!qwwyyI-NNNNNNr=)r:r,rQGetForegroundWindow GetWindowText GetClassNamerWr*replace win32processGetWindowThreadProcessIdrgetpidpsutilProcessranyr) r;hwndtitlecls_namerY name_no_ext_pidprocrZs @ris_game_window_focusedz'ItemHoverWatcher.is_game_window_focuseds  ,( (* 4 /11D u*4006BE,T228bH((((t%++--//t+  ii33 $$&&%++--77448":4@@FAsaxxubikk!!t>#&&D ))++INNNNt7MNNNNN N   55 s7E*AE*5E* AE*E*7E*AE** E87E8c|jrdS tjtjdddtjt ddddt jdtjt ddtjdtjtjdtjddS#t$rYdSwxYw)u5Gửi tổ hợp phím Ctrl+C an toàn qua Win32 API.NrCgQ?) r-win32api keybd_eventwin32con VK_CONTROLordtimesleepKEYEVENTF_KEYUPrrFs r send_ctrl_czItemHoverWatcher.send_ctrl_cs    F   !4aA > > >  S1a 3 3 3 Ju     S1h.F J J J  !4a9QST U U U U U    DD sB2B?? C  C 皙? timeout_sstrcR|j|jStj}tj|z |krj tj tjt jr6tjt j}|pd tj Stjt j rutjt j }t|tr*| ddtj S|pd tj S tj n#tj wxYwdS#t$rtjdYnwxYwtj|z |kjdS)u=Đọc nội dung văn bản từ Windows Clipboard an toàn.Nr/utf-8ignoreerrorsg{Gzt?)r9ru perf_counterwin32clipboard OpenClipboardIsClipboardFormatAvailablerrCF_UNICODETEXTGetClipboardDataCloseClipboardCF_TEXT isinstancebytesdecoderrv)r;rzstart_tdatas rread_clipboard_textz$ItemHoverWatcher.read_clipboard_texts  $ 0, ,#%%!!G+i77 ",... 4%@AXYY*->x?VWW#zr)#13333 (B8CSTT*->x?OPP%dE22I#';;wx;#H#H#13333 $zr)"13333 * #13333N13333r " " " 5!!!!! "!!G+i77"rsHE(?EE(&A'E E(!E%E(:E(E##E((F F cur_xrcur_ystatedictc|d}|d}|dd}|dd}||||f|d<||f|d<d|d<d|d<dStj||dz ||d z }tj||dz ||d z } | d krN|jr4d|_|jr& |n#t $rYnwxYwd|d<d|d<||f|d<n,|d kr||jd zz }||d<||jkr|sd |d<|r| tj d| } | rd| vsd| vrtj| dd} | |jkrO| |_t%| } | r7d |_|jr) || ||n"#t $rYnwxYwnd|d<d|d<||f|d<||f|d<dS)u Xử lý 1 nhịp thời gian của Hover Dwell Tracker. Tách biệt thành hàm riêng để có thể test đơn vị xác định (deterministic test). last_pos anchor_posdwell_accum_ms has_triggeredFNrg @g@g@@Tg{Gz? Item Class:Rarity:r}r~r)getmathhypotr6r%rr)r'rmrxrurvrhashlibmd5encode hexdigestr7rr#) r;rrrrrrr step_dist anchor_disttext text_hashreports r process_tickzItemHoverWatcher.process_ticks99Z((YY|,, #3S99 /599  z1!&E* #(%.E, &)E" #%*E/ " FJux{2EHQK4GHH jA!6 1 8MNN    " &+#',,....$&)E" #%*E/ "#(%.E,   #   d2V; ;N&4E" #!333M3)-o&..00-$$&&&Jt$$$3355D -$!6!6)t:K:K$+K GH 0U0U$V$V$`$`$b$b %(@@@7@D4%1$%7%7F%-6: 3#'#9!-%-(,(>(>vue(T(T(T(T+4%-%-%-(,%-'*E" #%*E/ "#(%.E, "ENjs$C44 DD H!! H.-H.c.tdddddd} tj|d<n#t$rYnwxYw|jrN|\}}|||| tj}||dkr||d<|r|}|rd|vsd|vrtj | d d  }||j krO||_ t|}|r7d |_|jr) ||||n#t$rYnwxYwn#t$rYnwxYwt#j|j|jLdSdS) u-Vòng lặp nền polling chuột mỗi 25ms.NrFr)rrrr last_clip_seqrrrr}r~rT)rrGetClipboardSequenceNumberrr1rSrrmrrrrrr7rr6r#rurvr))r;rrrcur_seqrrrs rrDzItemHoverWatcher._worker_loops !###!"    %3%N%P%PE/ " "    D m -..00LE5   eUE 2 2 2 (CEEeO444-4E/*2244 1#7799 1]d%:%:i4>O>O(/ DKKPXK4Y4Y(Z(Z(d(d(f(fI(D,DDD;D 8)5d););#)!1:>D$7'+'=%1)1,0,B,B65RW,X,X,X,X/8)1)1)1,0D)1     Jt+ , , ,5m - - - - -sC/ <<6CE"9EE" EE"EE"" E/.E/)NNr!r"NTF)r#r$r%r&r'r(r)r(r*r+r,r r-r )r r>r r )r rO)ry)rzr(r r{)rrrrrrr r>)__name__ __module__ __qualname____doc__r0r<rErKpropertyrNrSrmrxrrrDr=rr r 9s# !Y]8<$!&7;'+#55555<!!!!    X$$$$L    2H+H+H+H+T)-)-)-)-)-)-r=r r)r __future__rrrrr3rutypingrrrrcrprrrrQr`src.assistant.item_inspectorrrr __annotations__rr rr=rrs,   #"""""  ,,,,,,,,,, KKKKKKKK&******N-N-N-N-N-N-N-N-N-N-r=