لغة PowerShell في Maguyva: رسوم بيانية للشيفرة في النصوص والوحدات

أين تُربك PowerShell أدوات الذكاء الاصطناعي السطحية

تتبع دوالّك وأوامر cmdlet المدمجة أسلوب التسمية نفسه. يبدو Get-Invoice وGet-ChildItem متشابهين، لذا فإن الأداة التي تستبعد “المدمج” بحسب الفعل ترمي دوالّك أنت أيضًا. كما تمزج النصوص شيفرة مستوى الوحدة والدوال والفئات وكتل النصوص في ملف واحد، فيصعب معرفة الدالة التي ينتمي إليها سطر ما.

يحتفظ Maguyva بنوعي الاستدعاء معًا، وينسب كل استدعاء إلى الدالة التي يقع فيها.

ما الذي يستخرجه Maguyva من PowerShell

يغطي Maguyva ملفات .ps1 و.psm1 و.psd1. تُستخرج الدوال وتوابع الفئات بوصفها كيانات قابلة للاستدعاء، والفئات والتعدادات بوصفها أنواعًا. وتُتتبّع معاملات النصوص والتوابع، وتُنسب القراءة والكتابة داخل الدالة إلى تلك الدالة لا إلى الوحدة.

تبقى استدعاءات cmdlet في الرسم البياني. لا تطبّق PowerShell مرشّح المكتبة القياسية الذي تستخدمه معظم اللغات، لذا تظهر Write-Host وGet-ChildItem وRestart-Service بوصفها حواف استدعاء بجانب دوال Get-* وSet-* الخاصة بك. ويستطيع الوكيل أن يسأل أي النصوص تعيد تشغيل خدمة، أو أي الدوال تكتب إلى وحدة التحكم، فيحصل على إجابة قائمة على البنية.

لا يوجد في PowerShell نوع علاقة معلَّم بأنه غير قابل للتطبيق، لذا يسجّل الرسم البياني أيضًا وراثة الفئات وتنفيذ الواجهات وإنشاء النُسخ وتدفق التحكم والقراءة والكتابة.

أمثلة على مطالبات الوكلاء

• “من يستدعي Invoke-Backup، ومن أي نصوص مجدولة؟” (find_symbol ثم dependency_search في الاتجاه الوارد)
• “ما الدوال التي تستدعي Restart-Service؟” (dependency_search)
• “تتبّع ما يفعله Deploy-Site من البداية إلى النهاية.” (get_task_context)

القيود المعروفة

• لأن استدعاءات cmdlet تبقى، فإن الشائعة جدًا منها مثل Write-Host وSelect-Object لها عدد كبير من الحواف الواردة. ابدأ من دالتك أنت عندما تريد رسم استدعاءات مركّزًا.
• Import-Module والتحميل بالنقطة أوامر عادية، لذا لا يختار الإعداد المسبق imports في structural_search شيئًا. استخدم text_pattern_search لسردها.

الخطوات التالية

اربط مستودعًا عبر دليل البدء السريع، ثم راجع مصفوفة الدعم في صفحة التوافق. ولشيفرة .NET التي تستدعيها نصوصك، اقرأ دليل لغة C#.