PowerShell v Maguyva: grafy kódu pro skripty a moduly

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

Vaše funkce i vestavěné cmdlety používají stejný styl pojmenování. Get-Invoice a Get-ChildItem vypadají stejně, takže nástroj, který podle slovesa vyřadí „vestavěné“ příkazy, zahodí i vaše vlastní funkce. Skripty navíc v jednom souboru míchají kód na úrovni modulu, funkce, třídy a bloky skriptu, takže je těžké poznat, ke které funkci řádek patří.

Maguyva ponechává oba druhy volání a každé přiřadí funkci, ve které se nachází.

Co Maguyva v PowerShell extrahuje

Maguyva pokrývá soubory .ps1, .psm1 a .psd1. Funkce a metody tříd se extrahují jako volatelné prvky, třídy a výčty jako typy. Sledují se parametry skriptů i metod a čtení a zápisy uvnitř funkce se přiřazují této funkci, nikoli modulu.

Volání cmdletů v grafu zůstávají. PowerShell nepoužívá filtr standardní knihovny, který má většina jazyků, takže Write-Host, Get-ChildItem a Restart-Service se zobrazují jako hrany volání vedle vašich vlastních funkcí Get-* a Set-*. Agent se může zeptat, které skripty restartují službu nebo které funkce zapisují do konzole, a dostane strukturní odpověď.

Pro PowerShell není žádný typ relace označen jako nepoužitelný, takže graf zaznamenává také dědičnost tříd a implementaci rozhraní, vytváření instancí, tok řízení a čtení a zápisy.

Ukázkové prompty pro agenty

• „Kdo volá Invoke-Backup a ze kterých plánovaných skriptů?“ (find_symbol, pak dependency_search incoming)
• „Které funkce volají Restart-Service?“ (dependency_search)
• „Vysleduj, co Deploy-Site dělá od začátku do konce.“ (get_task_context)

Známá omezení

• Protože se volání cmdletů zachovávají, velmi běžné cmdlety jako Write-Host a Select-Object mají obrovské množství příchozích hran. Když chcete zaměřený graf volání, začněte od vlastní funkce.
• Import-Module a dot-sourcing jsou běžné příkazy, takže preset imports v structural_search nic nevybere. K jejich výpisu použijte text_pattern_search.

Další kroky

Připojte repozitář podle rychlého startu a pak si prohlédněte matici podpory na stránce kompatibility. Pro kód .NET, který vaše skripty volají, si přečtěte průvodce jazykem C#.