PowerShell w Maguyva: grafy kodu dla skryptów i modułów

Gdzie PowerShell sprawia kłopot powierzchownym narzędziom AI

Twoje funkcje i wbudowane cmdlety mają ten sam styl nazewnictwa. Get-Invoice i Get-ChildItem wyglądają tak samo, więc narzędzie, które odrzuca „wbudowane” polecenia według czasownika, wyrzuca też twoje funkcje. Skrypty mieszają ponadto w jednym pliku kod na poziomie modułu, funkcje, klasy i bloki skryptu, przez co trudno stwierdzić, do której funkcji należy dana linia.

Maguyva zachowuje oba rodzaje wywołań i przypisuje każde z nich do funkcji, w której się znajduje.

Co Maguyva wyodrębnia w PowerShell

Maguyva obejmuje pliki .ps1, .psm1 i .psd1. Funkcje i metody klas są wyodrębniane jako elementy wywoływalne, a klasy i typy wyliczeniowe jako typy. Śledzone są parametry skryptów i metod, a odczyty i zapisy wewnątrz funkcji są przypisywane do tej funkcji, a nie do modułu.

Wywołania cmdletów zostają w grafie. PowerShell nie stosuje filtra biblioteki standardowej, którego używa większość języków, więc Write-Host, Get-ChildItem i Restart-Service pojawiają się jako krawędzie wywołań obok twoich własnych funkcji Get-* i Set-*. Agent może zapytać, które skrypty restartują usługę albo które funkcje piszą do konsoli, i dostać odpowiedź opartą na strukturze.

Dla PowerShell żaden typ relacji nie jest oznaczony jako nie mający zastosowania, więc graf zapisuje też dziedziczenie klas i implementację interfejsów, tworzenie instancji, przepływ sterowania oraz odczyty i zapisy.

Przykładowe prompty dla agentów

• „Kto wywołuje Invoke-Backup i z których zaplanowanych skryptów?” (find_symbol, potem dependency_search incoming)
• „Które funkcje wywołują Restart-Service?” (dependency_search)
• „Prześledź, co robi Deploy-Site od początku do końca.” (get_task_context)

Znane ograniczenia

• Ponieważ wywołania cmdletów są zachowywane, bardzo popularne, takie jak Write-Host i Select-Object, mają ogromną liczbę krawędzi przychodzących. Gdy chcesz skupionego grafu wywołań, zacznij od własnej funkcji.
• Import-Module i dot-sourcing to zwykłe polecenia, więc preset imports w structural_search niczego nie wybiera. Do ich wypisania użyj text_pattern_search.

Kolejne kroki

Podłącz repozytorium za pomocą szybkiego startu, a potem sprawdź macierz obsługi na stronie zgodności. W przypadku kodu .NET wywoływanego przez twoje skrypty przeczytaj przewodnik po C#.