§ rù©jvãóþ—dZddlmZmZddlmZddlmZmZm Z m Z Gd„de¦«Z Gd„de e¦«Z dd e d e d e fd „ZGd„de¦«ZeGd„d¦«¦«ZeGd„d¦«¦«ZdS)uæThÆ° viện dùng chung định nghÄ©a cấu trúc dữ liệu vật phẩm (Item Data Models) cho AutoPOE2. Cung cấp các lá»›p enum và dataclass đại diện cho vật phẩm, Ä‘á»™ hiếm (Rarity) và các thuá»™c tính bổ trợ (Affixes), đóng vai trò Hợp đồng dữ liệu duy nhất (Single Source of Truth) kết nối các phân hệ Pickit Filter, Item Inspector và Tooltip Overlay. Tuân thủ nghiêm ngặt chuẩn tài liệu Google Docstrings theo Rule 16. é)Ú dataclassÚfield)ÚEnum)ÚAnyÚDictÚListÚOptionalcó"—eZdZdZdZdZdZdZdS)Ú ItemRarityuDÄá»™ hiếm tiêu chuẩn của vật phẩm trong Path of Exile 2.ÚNORMALÚMAGICÚRAREÚUNIQUEN)Ú__name__Ú __module__Ú __qualname__Ú__doc__r r rr©óú-C:\Projects\AutoPOE2\src\common\item_types.pyr r s(€€€€€ØNÐNà €FØ €EØ €DØ €F€F€Frr cóB—eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdS)ÚPoe2ItemCategoryuWPhân loại danh mục vật phẩm đặc trÆ°ng trong Path of Exile 2 (Doc 63 SSoT).ÚGoldÚCurrencyÚWaystonezPrecursor TabletzUncut Skill GemzUncut Support GemzUncut Spirit GemÚRunez Soul CoreÚCharmÚ EquipmentÚUnknownN)rrrrÚGOLDÚCURRENCYÚWAYSTONEÚPRECURSOR_TABLETÚUNCUT_SKILL_GEMÚUNCUT_SUPPORT_GEMÚUNCUT_SPIRIT_GEMÚRUNEÚ SOUL_COREÚCHARMÚ EQUIPMENTÚUNKNOWNrrrrrsS€€€€€ØaÐaà €DØ€HØ€HØ)ÐØ'€OØ+ÐØ)ÐØ €DØ€IØ €EØ€IØ€G€G€GrrÚÚnameÚ item_classÚreturncó8‡—| ¦«Š| ¦«}d‰vr tjSd‰vsd|vr tjSd‰vsd|vr tjSd‰vr tjSd‰vr tjSd‰vr tjSd‰vr tjSd‰vr tj Sd ‰vr tj Stˆfd „d D¦«¦«r tj Stˆfd „d D¦«¦«r tj StjS)uPPhân loại danh mục vật phẩm POE2 dá»±a trên tên hoặc class chuá»—i.ÚgoldÚwaystoneÚtabletz uncut skillz uncut supportz uncut spiritz soul coreÚruneÚcharmc3ó •K—|]}|‰vV—Œ dS©Nr©Ú.0ÚkÚlowers €rú z)classify_poe2_category..?s?øèè€ð pð p˜!ˆ1ˆ:ð pð pð pð pð pð pr)ÚarmourÚcuirassÚplateÚgarbÚrobeÚdoubletÚvestÚbootsÚglovesÚhelmetÚshieldÚstaffÚbowÚswordÚaxeÚmaceÚ quarterstaffÚcrossbowÚfistsÚringÚamuletÚbeltc3ó •K—|]}|‰vV—Œ dSr7rr8s €rr<z)classify_poe2_category..As?øèè€ð jð j˜!ˆ1ˆ:ð jð jð jð jð jð jr)ÚorbÚscrollÚshardÚbaubleÚprismÚscrapÚ whetstoneÚmirrorÚdivineÚexaltÚannulÚomenÚ distilledÚessence)r;rr r"r#r$r%r&r(r'r)Úanyr*r!r+)r-r.Ú class_lowerr;s @rÚclassify_poe2_categoryrd(sˆø€à JŠJ‰LŒL€EØ×"Ò"Ñ$Ô$€Kà €€ÝÔ$Ð$ØUÐИj¨KÐ7Ð7ÝÔ(Ð(Ø5ÐИH¨ Ð3Ð3ÝÔ0Ð0ؘÐÐÝÔ/Ð/ؘ%ÐÐÝÔ1Ð1ؘÐÐÝÔ0Ð0ØeÐÐÝÔ)Ð)Ø €€ÝÔ$Ð$Ø%ÐÐÝÔ%Ð%Ý ð pð pð pð pð oð pñ pô pñpôpð*ÝÔ)Ð)Ý ð jð jð jð jð ið jñ jô jñjôjð)ÝÔ(Ð(Ý Ô #Ð#rcó"—eZdZdZdZdZdZdZdS)Ú AffixTypeuBPhân loại vị trí của dòng thuá»™c tính trên trang bị.ÚPREFIXÚSUFFIXÚIMPLICITr+N)rrrrrgrhrir+rrrrfrfFs(€€€€€ØLÐLà €FØ €FØ€HØ€G€G€Grrfcó¶—eZdZUdZeed<ejZeed<dZ e e ed<dZ eed<dZ eed<ee¬ ¦«Zeeed <d Zeed <d Zeed <dS)Ú AffixDatau†Dữ liệu chi tiết vá» má»™t dòng thuá»™c tính bổ trợ (Mod / Affix) trên vật phẩm. Attributes: text: Chuá»—i văn bản hiển thị nguyên gốc của thuá»™c tính (ví dụ: '+42 to maximum Life'). affix_type: Loại thuá»™c tính (PREFIX, SUFFIX, IMPLICIT, UNKNOWN). tier: Bậc của thuá»™c tính nếu được game công bố qua phím Alt (T1, T2, ...), hoặc None. name: Tên danh xÆ°ng của mod (ví dụ: 'Athlete's', 'of the Rainbow'). category: Nhóm phân loại nghiệp vụ (ví dụ: 'life', 'elemental_res', 'phys_dmg'). values: Danh sách các giá trị số bóc tách được từ dòng chữ. is_crafted: True nếu là dòng được thêm vào từ bàn chế tạo (Crafting Bench). is_fractured: True nếu là dòng thuá»™c tính cố định không thể tẩy (Fractured Mod). ÚtextÚ affix_typeNÚtierr,r-Úcategory©Údefault_factoryÚvaluesFÚ is_craftedÚ is_fractured)rrrrÚstrÚ__annotations__rfr+rmrnr Úintr-rorÚlistrrrÚfloatrsÚboolrtrrrrkrkOs¬€€€€€€ð ð ð €I€IIØ%Ô-€J Ð-Ð-Ñ-Ø€Dˆ(3Œ-ÐÐÑØ€Dˆ#€N€NNØ€HˆcÐÐÑؘ%°Ð5Ñ5Ô5€FˆDŒKÐ5Ð5Ñ5Ø€JÐÐÑØ€L$ÐÐÑÐÐrrkcóî—eZdZUdZdZeed<dZeed<dZeed<e j Z e ed<dZ e ed<dZe ed <d Zeed <dZe ed <dZe ed <dZe ed<dZe ed<dZe ed<ee¬¦«Zeeed<ee¬¦«Zeeed<ee¬¦«Zeeefed<dZ eed<e!defd„¦«Z"e!defd„¦«Z#e!defd„¦«Z$e!defd„¦«Z%e!de fd„¦«Z&dS)ÚItemDatau Mô hình dữ liệu hoàn chỉnh của má»™t vật phẩm trong hệ thống AutoPOE2. Äược sá»­ dụng xuyên suốt bởi các phân hệ Sàng lá»c nhặt đồ (Pickit), Äánh giá chuyên sâu (Inspector) và Hiển thị há»— trợ trá»±c quan (Tooltip Overlay HUD). Attributes: name: Tên riêng của vật phẩm (thÆ°á»ng có trên đồ Rare / Unique). base_type: Phôi cÆ¡ sở của vật phẩm (ví dụ: 'Expert Vaal Cuirass', 'Spiked Fists'). item_class: Phân loại danh mục game (ví dụ: 'Body Armours', 'Gloves', 'Waystones'). rarity: Äá»™ hiếm của vật phẩm (NORMAL, MAGIC, RARE, UNIQUE). item_level: Cấp Ä‘á»™ vật phẩm (iLvl). quality: Chỉ số chất lượng (+0% đến +20%). identified: True nếu vật phẩm đã được giám định, False nếu còn Unidentified. sockets: Số lượng lá»— ngá»c trên trang bị. open_prefixes: Số lượng vị trí Prefix còn trống có thể chế thêm. open_suffixes: Số lượng vị trí Suffix còn trống có thể chế thêm. max_prefixes: Giá»›i hạn Prefix tối Ä‘a cho loại phôi này (mặc định 3 cho đồ Rare). max_suffixes: Giá»›i hạn Suffix tối Ä‘a cho loại phôi này (mặc định 3 cho đồ Rare). implicits: Danh sách các dòng thuá»™c tính ẩn mặc định (Implicit Mods). explicits: Danh sách các dòng thuá»™c tính mở rá»™ng (Explicit Mods). properties: Bản đồ lÆ°u trữ các chỉ số thuá»™c tính cÆ¡ sở (Armour, Evasion, Physical Damage, v.v.). raw_text: Toàn bá»™ văn bản thô Ä‘á»c từ clipboard khi nhấn Ctrl+C vào vật phẩm in-game. Example: >>> item = ItemData(base_type="Expert Vaal Cuirass", rarity=ItemRarity.RARE, item_level=82) >>> print(f"Äồ: {item.base_type}, Rare={item.is_rare}") r,r-Ú base_typer.ÚrarityrÚ item_levelÚqualityTÚ identifiedÚsocketsÚ open_prefixesÚ open_suffixeséÚ max_prefixesÚ max_suffixesrpÚ implicitsÚ explicitsÚ propertiesÚraw_textr/có,—|jtjkS)uIKiểm tra vật phẩm có phải là đồ trắng (Normal) hay không.)r~r r ©Úselfs rÚ is_normalzItemData.is_normal—ó€ðŒ{jÔ/Ò/Ð/rcó,—|jtjkS)uEKiểm tra vật phẩm có phải là đồ xanh (Magic) hay không.)r~r r rs rÚis_magiczItemData.is_magicœs€ðŒ{jÔ.Ò.Ð.rcó,—|jtjkS)uEKiểm tra vật phẩm có phải là đồ vàng (Rare) hay không.)r~r rrs rÚis_rarezItemData.is_rare¡s€ðŒ{jœoÒ-Ð-rcó,—|jtjkS)uEKiểm tra vật phẩm có phải là đồ cam (Unique) hay không.)r~r rrs rÚ is_uniquezItemData.is_unique¦rrcó*—t|j¦«S)uETổng số dòng thuá»™c tính explicit hiện có trên trang bị.)Úlenr‰rs rÚtotal_affixes_countzItemData.total_affixes_count«s€õ4”>Ñ"Ô"Ð"rN)'rrrrr-rurvr}r.r r r~rrwr€rrzr‚rƒr„r†r‡rrxrˆrrkr‰ÚdictrŠrrr‹Úpropertyrr’r”r–r™rrrr|r|hs€€€€€€ððð8€Dˆ#€N€NNØ€IˆsÐÐÑØ€JÐÐÑØ#Ô*€FˆJÐ*Ð*Ñ*Ø€JÐÐÑØ€GˆSÐÐÑØ€JÐÐÑØ€GˆSÐÐÑØ€M3ÐÐÑØ€M3ÐÐÑØ€L#ÐÐÑØ€L#ÐÐÑØ!& °tÐ!<Ñ!<Ô!<€IˆtIŒÐ<Ð<Ñ<Ø!& °tÐ!<Ñ!<Ô!<€IˆtIŒÐ<Ð<Ñ<Ø!& °tÐ!<Ñ!<Ô!<€JS˜#X”Ð<Ð<Ñ<Ø€HˆcÐÐÑà ð0˜4ð0ð0ð0ñ„Xð0ðð/˜$ð/ð/ð/ñ„Xð/ðð.˜ð.ð.ð.ñ„Xð.ðð0˜4ð0ð0ð0ñ„Xð0ðð# Sð#ð#ð#ñ„Xð#ð#ð#rr|N)r,)rÚ dataclassesrrÚenumrÚtypingrrrr r rurrdrfrkr|rrrúrŸsŠðððð)Ð(Ð(Ð(Ð(Ð(Ð(Ð(ØÐÐÐÐÐØ,Ð,Ð,Ð,Ð,Ð,Ð,Ð,Ð,Ð,Ð,Ð,ðððððñôððððððs˜Dñôðð"$ð$ ð$°#ð$Ð?Oð$ð$ð$ð$ð<ððððñôðð ðððððñôñ „ðð0 ðE#ðE#ðE#ðE#ðE#ñE#ôE#ñ „ðE#ðE#ðE#r