Lua v Maguyva: grafy kódu pro hry, pluginy a OpenResty

Kde Lua podráží povrchní AI nástroje

Lua nemá klíčové slovo pro třídy. Objekty jsou tabulky, metody jsou funkce v nich uložené a dědičnost je volání setmetatable. Modul je cokoli, co vrátí require. Struktura je skutečná, ale žije v konvencích, kterým textové vyhledávání nerozumí.

Maguyva tyto konvence čte jako strukturu, takže se agent může zeptat, kdo volá metodu nebo které tabulky rozšiřují základ, a dostane přímou odpověď.

Co Maguyva v Lua extrahuje

Maguyva pokrývá soubory .lua. Extrahují se deklarace funkcí, definice local function a funkční výrazy a metody s dvojtečkou jako function Account:deposit() se přiřazují tabulce, které patří, tedy Account. Řetězce metod se sledují volání po volání a volání na self zůstávají vázaná na obklopující objekt.

Konvence Lua se převádějí na relace takto:

• require, dofile a loadfile zaznamenávají importy.
• Volání setmetatable na úrovni modulu zaznamenává dědičnost.
• ClassName:new(), ClassName.new() a setmetatable({...}, ClassName) se počítají jako vytvoření instance.
• error() zaznamenává vyhození chyby a pcall a xpcall její zachycení.

Graf zaznamenává také čtení a zápisy a tok řízení.

Ukázkové prompty pro agenty

• „Kdo volá Inventory:addItem a z kterých skriptů?“ (find_symbol, pak dependency_search incoming)
• „Které moduly načítají util.http přes require?“ (dependency_search)
• „Vysleduj, co se stane, když hráč utrpí zranění.“ (get_task_context)

Známá omezení

• Asi 150 názvů se z relací odfiltruje: standardní knihovna Lua (string, table, math, io, os, coroutine, debug a utf8) a k tomu API Neovimu vim.* a API OpenResty ngx.*. Volání těchto API nejsou hranami grafu, proto je hledejte pomocí text_pattern_search.
• Protože moduly a třídy vznikají z běžných volání a tabulek, presety classes a imports v structural_search pro Lua nic nevyberou. Použijte místo nich find_symbol nebo text_pattern_search.
• Lua nemá rozhraní ani typové anotace, proto jsou relace implementace rozhraní a odkazů na typy označeny jako nepoužitelné.

Další kroky

Připojte repozitář podle rychlého startu a pak si prohlédněte matici podpory na stránce kompatibility. U enginů, které vkládají Lua do nativního kódu, si přečtěte i průvodce jazykem C.