mikrus-files

mikrus-files

Przesyła pliki między komputerem lokalnym a serwerem Mikrus przez SCP.

Użycie

Import-Module "$env:CLAUDE_PLUGIN_ROOT/lib/mikrus.psm1" -Force

# Wysłanie pliku na serwer
Send-MikrusFile -Local 'C:\dane\backup.zip' -Remote '/root/backup.zip'

# Pobranie pliku z serwera
Get-MikrusFile -Remote '/root/log.txt' -Local 'C:\dane\log.txt'

# Katalog (rekurencyjnie)
Send-MikrusFile -Local 'C:\projekt' -Remote '/root/projekt' -Recurse

Aby podejrzeć komendę bez wykonania — -DryRun.

Limit czasu (duże transfery)

Send-MikrusFile i Get-MikrusFile mają twardy limit czasu na cały proces scp (domyślnie 180 s). Po przekroczeniu transfer jest ubijany, a wynik ma ExitCode = 124 i TimedOut = $true — zamiast wisieć w nieskończoność przy zawieszonym połączeniu. Dla dużych plików/katalogów podaj większy -TimeoutSec:

Send-MikrusFile -Local 'C:\dane\backup.zip' -Remote '/root/backup.zip' -TimeoutSec 1200

Domyślne wartości limitów można nadpisać w ~/.mikrus/config.json (pole commandTimeout i opcje połączenia — patrz skill mikrus-terminal).

Zasady

• Sprawdzaj ExitCode zwracanego obiektu; przy ≠ 0 pokaż Output. ExitCode = 124 (TimedOut) = przekroczony limit czasu → zwiększ -TimeoutSec (duży plik) lub sprawdź połączenie.
• Dla katalogów zawsze -Recurse.
• Alternatywa dla dużych/ręcznych transferów: panel Mikrus → katalog /drop (pliki do 100 MB). Wspomnij o niej, gdy SCP zawiedzie lub plik jest duży.
• Brak konfiguracji → odeślij do skilla mikrus-setup.