Przejdź do treści
Palladin.ioDokumentacja
EN
Dokumentacja/Dla programistów

Referencja CLI

Komendy integracji i parametry, które zmieniają ich zachowanie.

1.025.10.2026Markdown ↗

Inject do przeglądarki działa obecnie tylko na macOS, przez rozszerzenie Palladin. Dostępność CLI na Linux nie oznacza obsługi Inject.

Składnia

palladin [--id <profile>] <command> [options]
palladin <command> --help

--id wybiera profil dla danego wywołania. W automatyzacji podawaj go jawnie. Nawiasy ostrokątne oznaczają wartości do zastąpienia; nie są częścią polecenia.

Konfiguracja i diagnostyka

Komenda Działanie
--version Wersja uruchomionego CLI.
doctor Diagnostyka runtime bez otwarcia tożsamości.
init Utworzenie domyślnego profilu, jeśli nie istnieje.
pair-agent --host <origin> --setup-descriptor '<descriptor>' Połączenie przez zatwierdzenie w przeglądarce.
connect --host <origin> Alternatywne połączenie z maskowanym promptem API key.
status Status rejestracji wybranego Agenta.
pair Parowanie aktywnych sejfów i przypięcie potwierdzonych kluczy podpisujących.
agents list Lista lokalnych aliasów.
agents create <name> Nowa, odrębna tożsamość.
agents rename <old> <new> Zmiana aliasu bez przenoszenia sekretów.
mcp serve Serwer MCP przez stdio.

connect --api-key-stdin przyjmuje klucz ze standardowego wejścia. Nie używaj jawnego klucza w poleceniu shell, historii ani rozmowie. Zalecamy parowanie przez panel web.

Wyszukiwanie

palladin --id <profile> search '<query>' --json --page-size 10

Fraza ma co najmniej dwa znaki po usunięciu skrajnych spacji. --cursor kontynuuje wynik poprzedniej strony; --page-size przyjmuje 1–100. Widoczność metadanych nie nadaje prawa do odczytu sekretu.

Użycie danych

Komenda Najważniejsze parametry
get <vault-id> <entry-id> --reason, --field lub --field-id; zwraca dane w jawnej postaci.
exec <vault-id> <entry-id> -- <program> <args> --reason, powtarzalne --env NAME=FIELD; nie interpoluj sekretów do argumentów.
exec <vault-id> <script-entry-id> Wykonanie Script; --parameters-stdin dla obiektu parametrów.
inject <vault-id> <entry-id> --provider extension, --target-tab-id, --page-url.
report-stale <vault-id> <entry-id> --code login_rejected, auth_failed lub manual.

Dla get, exec i inject: --wait 2m ogranicza oczekiwanie na zgodę (maksymalnie 5 minut), --no-wait wraca od razu, --poll-interval 10s ustawia odstęp między sprawdzeniami statusu, --progress plain|json|none wybiera komunikaty postępu. Inject odrzuca CDP, własne selektory pól, --no-submit, --fill-only, --field, --field-id i --verbose. Używaj kanału rozszerzenia.

Przeglądarka

browser status sprawdza kanał. browser install wymaga obsługiwanego pakietu rozszerzenia i kanału integracji. Tab ID i URL służą do wyboru celu; runtime i rozszerzenie nadal niezależnie sprawdzają pochodzenie i dokument.

Podawaj --target-tab-id razem z --page-url albo pomiń oba. Eksperymentalne formularze na stronach wymagają jawnego celu.

Operacje usuwające

disconnect --purge --confirm usuwa wybraną lokalną tożsamość. purge --confirm usuwa wszystkie lokalne profile. Nie są to kroki diagnostyczne; wymagają świadomej decyzji użytkownika. Usunięcie lokalnej tożsamości nie zastępuje cofnięcia dostępu po stronie organizacji.