Maguyva में Lua: गेम, प्लगइन और OpenResty के लिए कोड ग्राफ़

Lua सतही AI टूल को कहाँ उलझाती है

Lua में क्लास के लिए कोई कीवर्ड नहीं है। ऑब्जेक्ट टेबल हैं, मेथड उनमें रखे फ़ंक्शन हैं, और इनहेरिटेंस एक setmetatable कॉल है। मॉड्यूल वही है जो require लौटाता है। संरचना असली है, पर वह ऐसी परिपाटियों में रहती है जिन्हें टेक्स्ट सर्च नहीं समझता।

Maguyva इन परिपाटियों को संरचना के रूप में पढ़ता है, ताकि एजेंट पूछ सके कि किसी मेथड को कौन कॉल करता है या कौन-सी टेबल किसी बेस को बढ़ाती हैं, और सीधा जवाब पा सके।

Maguyva, Lua से क्या निकालता है

Maguyva .lua फ़ाइलों को कवर करता है। फ़ंक्शन डिक्लेरेशन, local function परिभाषाएँ और फ़ंक्शन एक्सप्रेशन निकाले जाते हैं, और function Account:deposit() जैसे कोलन मेथड अपनी मालिक टेबल Account से जोड़े जाते हैं। मेथड श्रृंखलाएँ एक-एक कॉल करके ट्रेस की जाती हैं, और self पर किए गए कॉल अपने घेरने वाले ऑब्जेक्ट से बँधे रहते हैं।

Lua की परिपाटियाँ इस तरह संबंध बनती हैं:

• require, dofile और loadfile इम्पोर्ट दर्ज करते हैं।
• मॉड्यूल स्तर पर setmetatable कॉल इनहेरिटेंस दर्ज करता है।
• ClassName:new(), ClassName.new() और setmetatable({...}, ClassName) इंस्टैंशिएशन गिने जाते हैं।
• error() थ्रो दर्ज करता है, और pcall तथा xpcall कैच दर्ज करते हैं।

ग्राफ़ रीड और राइट तथा कंट्रोल फ़्लो भी दर्ज करता है।

एजेंट प्रॉम्प्ट के उदाहरण

• “Inventory:addItem को कौन कॉल करता है, और किन स्क्रिप्ट से?” (find_symbol, फिर dependency_search इनकमिंग)
• “कौन-से मॉड्यूल util.http को require से लोड करते हैं?” (dependency_search)
• “ट्रेस करो कि खिलाड़ी को चोट लगने पर क्या होता है।” (get_task_context)

ज्ञात सीमाएँ

• लगभग 150 नाम संबंधों से फ़िल्टर किए जाते हैं: Lua स्टैंडर्ड लाइब्रेरी (string, table, math, io, os, coroutine, debug और utf8) के साथ Neovim का vim.* और OpenResty का ngx.* API। इन API के कॉल ग्राफ़ एज नहीं हैं; उन्हें ढूँढने के लिए text_pattern_search इस्तेमाल करें।
• क्योंकि मॉड्यूल और क्लास सामान्य कॉल और टेबल से बनते हैं, structural_search में classes और imports प्रीसेट Lua के लिए कुछ भी नहीं चुनते। इसकी जगह find_symbol या text_pattern_search इस्तेमाल करें।
• Lua में इंटरफ़ेस या टाइप एनोटेशन नहीं हैं, इसलिए इंटरफ़ेस-कार्यान्वयन और टाइप-रेफ़रेंस संबंध लागू नहीं के रूप में चिह्नित हैं।

अगले कदम

क्विकस्टार्ट से रिपॉज़िटरी जोड़ें, फिर सपोर्ट मैट्रिक्स कम्पैटिबिलिटी पेज पर देखें। नेटिव कोड में Lua को एम्बेड करने वाले इंजन के लिए C गाइड भी पढ़ें।