PowerShell στο Maguyva: γράφοι κώδικα για σενάρια και αρθρώματα

Πού σκοντάφτουν τα επιφανειακά εργαλεία AI στο 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 διατηρούνται, πολύ συνηθισμένα cmdlet όπως Write-Host και Select-Object έχουν πολλές εισερχόμενες ακμές. Ξεκινήστε από τη δική σας συνάρτηση όταν θέλετε εστιασμένο γράφο κλήσεων.
• Το Import-Module και η φόρτωση σεναρίων με τελεία είναι συνηθισμένες εντολές, οπότε η προεπιλογή imports στο structural_search δεν επιλέγει τίποτα. Χρησιμοποιήστε το text_pattern_search για να τα καταγράψετε.

Επόμενα βήματα

Συνδέστε ένα αποθετήριο με τον γρήγορο οδηγό εκκίνησης και έπειτα δείτε τον πίνακα υποστήριξης στη σελίδα συμβατότητας. Για τον κώδικα .NET που καλούν τα σενάριά σας, διαβάστε τον οδηγό για τη C#.