QuickTerminal - Przewodnik

Pierwsze kroki

1. Uruchom aplikację — trafiasz na ekran główny z zapisanymi sesjami i przyciskiem do rozpoczęcia nowego połączenia.
2. Uruchom lokalną powłokę — dotknij Local Shell, aby natychmiast otworzyć sesję terminala na swoim urządzeniu.
3. Utwórz sesję zdalną — dotknij New Session, wybierz protokół (SSH, Telnet, Mosh, Serial, AWS SSM lub GCP IAP) i wprowadź szczegóły połączenia.
4. Zapisz sesję — nadaj jej nazwę i przypisz do grupy. Łącz się ponownie jednym dotknięciem w dowolnym momencie.
5. Odkryj Command Palette — naciśnij Ctrl + Shift + P, aby uzyskać dostęp do każdej akcji z jednej przeszukiwalnej listy.

Przegląd interfejsu

Pasek boczny

Zwijany pasek boczny organizuje Twój obszar roboczy:

• Sesje — wszystkie zapisane sesje pogrupowane według projektu lub środowiska
• SFTP — otwórz graficzną przeglądarkę plików dla aktywnego połączenia
• Snippets — Twoja zapisana biblioteka poleceń
• AI Agent — uruchom panel asystenta AI
• Ustawienia / Pomoc — na dole paska bocznego

Obszar terminala

Centralny obszar roboczy pokazuje:

• Aktywny terminal z pełnym wejściem i wyjściem
• Pasek kart do przełączania między wieloma otwartymi sesjami
• Pasek stanu na dole pokazujący stan połączenia, protokół i licznik sesji
• Opcjonalny widok podzielonych paneli do uruchamiania wielu terminali obok siebie

Command Palette

Naciśnij Ctrl + Shift + P, aby otworzyć Command Palette. Wpisuj, aby filtrować akcje, a następnie naciśnij Enter, aby wykonać. Każda funkcja w QuickTerminal jest dostępna przez palette.

Lokalna powłoka

QuickTerminal zawiera w pełni zintegrowaną lokalną powłokę do uruchamiania poleceń na Twoim urządzeniu.

• Wykrywanie powłoki — automatycznie wykrywa i używa Twojej domyślnej powłoki (bash, zsh, fish, PowerShell)
• Śledzenie katalogu roboczego — pasek stanu zawsze pokazuje Twój bieżący katalog
• Historia poleceń — trwała historia między sesjami, przeszukiwalna za pomocą Ctrl + R
• Zmienne środowiskowe — automatycznie dziedziczy Twój profil i środowisko powłoki

$ echo "Welcome to QuickTerminal"
Welcome to QuickTerminal
$ ssh user@server.example.com
# Or create a saved session for one-tap reconnection

Połączenia SSH

SSH to podstawowy protokół bezpiecznego dostępu zdalnego. QuickTerminal obsługuje wszystkie nowoczesne funkcje SSH.

Uwierzytelnianie

• Hasło — wprowadź poświadczenia podczas łączenia lub zapisz je bezpiecznie w sesji
• Oparte na kluczu — używaj kluczy RSA, Ed25519 lub ECDSA. Importuj z pliku lub generuj nowe pary kluczy
• Agent forwarding — przekieruj lokalnego SSH agenta do zdalnego hosta dla bezproblemowego dostępu multi-hop
• Keyboard-interactive — obsługuje uwierzytelnianie dwuskładnikowe i prompty typu challenge-response

Port Forwarding

• Przekierowanie lokalne — tuneluj zdalny port do swojej lokalnej maszyny
• Przekierowanie zdalne — udostępnij lokalną usługę zdalnemu hostowi
• Przekierowanie dynamiczne — utwórz proxy SOCKS przez tunel SSH

Konfiguracja sesji

# Example session fields
Host:       server.example.com
Port:       22
Username:   deploy
Auth:       Key (Ed25519)
Forwarding: Local 8080 → remote 80

Inne protokoły

Telnet

Skonfiguruj host i port. Połączenia Telnet nie są szyfrowane; używaj tylko w zaufanych sieciach lub dla sprzętu, który tego wymaga.

Mosh

Wymaga zainstalowanego serwera Mosh na zdalnym hoście. QuickTerminal automatycznie obsługuje początkowy handshake SSH i konfigurację sesji UDP. Idealne dla warunków sieci mobilnej lub niestabilnej.

Serial

Wybierz port szeregowy, prędkość transmisji (9600, 19200, 38400, 57600, 115200 itd.), bity danych, bity stopu, parzystość i kontrolę przepływu. Terminal wyświetla surowe dane szeregowe i obsługuje wysyłanie sygnałów break.

AWS SSM

Uwierzytelnij się za pomocą swoich poświadczeń AWS lub roli IAM. Wybierz docelową instancję po ID lub nazwie. QuickTerminal wywołuje wtyczkę sesji SSM, aby nawiązać połączenie.

GCP IAP

Uwierzytelnij się za pomocą swojego konta Google Cloud. Wybierz projekt, strefę i instancję. QuickTerminal tuneluje przez IAP, używając Twoich uprawnień IAM.

Przeglądarka SFTP

Wbudowana przeglądarka SFTP zapewnia graficznego menedżera plików dla dowolnego hosta połączonego przez SSH.

• Przeglądaj katalogi — nawiguj po zdalnym systemie plików za pomocą znanego widoku drzewa i listy
• Wysyłaj pliki — przeciągaj i upuszczaj pliki z lokalnej maszyny lub użyj przycisku upload
• Pobieraj pliki — wybierz pliki i pobierz je do lokalnego katalogu
• Edytuj zdalnie — otwórz pliki tekstowe we wbudowanym edytorze i zapisz bezpośrednio na serwer
• Uprawnienia — wyświetlaj i modyfikuj uprawnienia, własność i znaczniki czasu plików
• Wyszukiwanie — znajdź pliki po nazwie w drzewie bieżącego katalogu

Agenci AI

Agenci AI QuickTerminal pomagają w komponowaniu poleceń, analizie danych wyjściowych i automatyzacji zadań.

Co potrafią agenci AI

• Generowanie poleceń — opisz, czego chcesz, zwykłym językiem, a agent zasugeruje odpowiednie polecenie
• Wyjaśnianie wyniku — wklej lub prześlij potokiem wyjście terminala do agenta, aby uzyskać zrozumiały opis
• Diagnoza błędów — udostępnij komunikaty o błędach i uzyskaj proponowane rozwiązania z wyjaśnieniami
• Automatyzacja wieloetapowa — opisz przepływ pracy, a agent wygeneruje sekwencję poleceń
• Generowanie skryptów — poproś agenta o tworzenie skryptów powłoki dla powtarzalnych zadań

Używanie panelu agenta

1. Otwórz panel AI Agent z paska bocznego lub naciśnij Ctrl + Shift + A.
2. Wpisz swoje żądanie w naturalnym języku.
3. Przejrzyj sugerowane polecenie lub wyjaśnienie.
4. Kliknij Insert, aby wkleić polecenie do terminala, lub Copy, aby skopiować do schowka.

Snippety

Snippety pozwalają zapisywać, organizować i szybko wstawiać często używane polecenia.

Tworzenie snippetu

1. Otwórz panel Snippets z paska bocznego.
2. Dotknij New Snippet.
3. Wprowadź polecenie, nazwę i opcjonalny opis.
4. Użyj składni ${variable_name} dla szablonów z parametrami.
5. Zapisz w swojej bibliotece snippetów.

Zmienne szablonu

# Snippet with variables
$ ssh ${user}@${host} -p ${port:22}
# ${port:22} uses 22 as default if not specified

Gdy wstawiasz snippet z parametrami, QuickTerminal poprosi o wypełnienie każdej zmiennej przed wstawieniem końcowego polecenia.

Organizacja snippetów

• Przypisz tagi, aby grupować powiązane snippety (np. deployment, monitoring, database)
• Wyszukuj snippety po nazwie, zawartości lub tagu
• Przypnij najczęściej używane snippety dla szybkiego dostępu na górze listy

Command Palette

Command Palette to uniwersalny launcher akcji dostępny z dowolnego miejsca w QuickTerminal.

• Naciśnij Ctrl + Shift + P, aby otworzyć
• Wpisuj, aby filtrować akcje — fuzzy matching szybko znajduje to, czego potrzebujesz
• Akcje obejmują: tworzenie sesji, otwieranie SFTP, przełączanie ustawień, uruchamianie snippetów i więcej
• Ostatnio używane akcje pojawiają się na górze dla szybkiego powtórnego dostępu

# Example palette actions
New SSH Session
Open SFTP Browser
Insert Snippet...
Toggle Split Pane
Open AI Agent
Manage Execution Policies

Execution Policies

Execution Policies pozwalają zdefiniować zasady bezpieczeństwa, które chronią przed przypadkowymi lub destrukcyjnymi poleceniami.

Typy zasad

Konfigurowanie zasad

1. Przejdź do Settings > Execution Policies.
2. Dotknij New Policy.
3. Zdefiniuj pattern — prefiks polecenia, regex lub słowo kluczowe do dopasowania.
4. Wybierz akcję (block, confirm, sandbox lub log).
5. Ustaw zakres — zastosuj do wszystkich sesji, określonych grup lub pojedynczych sesji.

Ustawienia

Wygląd

• Motyw — tryby Jasny i Ciemny z wykrywaniem preferencji systemu
• Rodzina czcionek — wybierz preferowaną czcionkę o stałej szerokości dla terminala
• Rozmiar czcionki — regulowany rozmiar tekstu terminala
• Schemat kolorów — wybierz z wbudowanych palet kolorów terminala lub zaimportuj niestandardowe schematy

Terminal

• Bufor scrollback — skonfiguruj, ile wierszy historii ma być przechowywanych w pamięci
• Styl kursora — blok, podkreślenie lub pasek
• Zachowanie dzwonka — wizualny błysk, dźwięk systemowy lub wyciszenie
• Kopiowanie przy zaznaczeniu — automatycznie kopiuje podświetlony tekst do schowka

Połączenia

• Domyślny port SSH — ustaw niestandardowy domyślny port dla nowych sesji SSH
• Interwał Keep-alive — wysyłaj okresowe pakiety, aby zapobiec przekroczeniu limitu czasu połączenia
• Ponowne łączenie po rozłączeniu — automatycznie próbuj przywrócić zerwane połączenia

Execution Policies

• Zarządzaj regułami block, confirm, sandbox i log
• Włączaj lub wyłączaj zasady dla grupy sesji

Skróty klawiszowe

Porady i wskazówki

Rozwiązywanie problemów

Prywatność

• QuickTerminal nie wymaga konta ani logowania.
• Nie są zbierane żadne dane użytkowania, analytics ani telemetria.
• Wszystkie poświadczenia są szyfrowane przy użyciu natywnych keystore'ów platformy.
• Agenci AI działają całkowicie na urządzeniu — żadne dane nie są wysyłane do zewnętrznych serwerów.
• Historia sesji i snippety są przechowywane lokalnie na Twoim urządzeniu.
• Transfery SFTP są bezpośrednie między Twoim urządzeniem a zdalnym hostem.
• Aplikacja działa w pełni offline dla lokalnej powłoki i połączeń szeregowych.