PowerShell в Maguyva: графы кода для скриптов и модулей

Где PowerShell сбивает с толку поверхностные ИИ-инструменты

Ваши функции и встроенные командлеты используют один стиль именования. Get-Invoice и Get-ChildItem выглядят одинаково, поэтому инструмент, отбрасывающий «встроенные» команды по глаголу, отбрасывает и ваши функции. Кроме того, скрипты смешивают код уровня модуля, функции, классы и блоки скриптов в одном файле, и трудно понять, какой функции принадлежит строка.

Maguyva сохраняет оба вида вызовов и приписывает каждый вызов функции, внутри которой он находится.

Что Maguyva извлекает из кода PowerShell

Maguyva охватывает файлы .ps1, .psm1 и .psd1. Функции и методы классов извлекаются как вызываемые объекты, а классы и перечисления как типы. Параметры скриптов и методов отслеживаются, а чтение и запись внутри функции приписываются этой функции, а не модулю.

Вызовы командлетов остаются в графе. 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)

Известные ограничения

• Поскольку вызовы командлетов сохраняются, у очень распространённых командлетов, таких как Write-Host и Select-Object, много входящих рёбер. Когда нужен сфокусированный граф вызовов, начинайте с собственной функции.
• Import-Module и подключение скриптов через точку являются обычными командами, поэтому пресет imports в structural_search ничего не выбирает. Чтобы перечислить их, используйте text_pattern_search.

Следующие шаги

Подключите репозиторий по быстрому старту, затем изучите матрицу поддержки на странице совместимости. Для кода .NET, который вызывают ваши скрипты, прочитайте руководство по C#.