Skip to content

pl AI AGENTS

github-actions[bot] edited this page Nov 17, 2026 · 6 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Agenci AI na Twoim urządzeniu

Stale dostępny punkt końcowy SSH zamienia Twój telefon w coś, czym autonomiczny agent AI może sterować bezpośrednio. Każdy agent potrafiący obsłużyć powłokę lub połączenie SSH (Claude Code, aider, skrypt z LLM w pętli, Twoja własna automatyzacja) otrzymuje prawdziwą sesję roota na urządzeniu, przez sieć, bez przewodu USB i bez żadnej z ujawniających się flag debugowania ADB.

Ta strona rozwija ideę przedstawioną w pliku README.

Dlaczego SSH, a nie ADB, dla agentów

ADB sam się zdradza: adb_enabled i development_settings_enabled są czytelne dla wszystkich, połączenie jest rejestrowane i nie ma żadnego wspieranego sposobu, by ukryć, że debugowanie jest (lub było) włączone. Agent pracujący przez ADB zostawia na urządzeniu ślad, który może odczytać dowolna aplikacja lub SDK antyfraudowe. VD Dropbear jest prywatną alternatywą: zwykłym logowaniem SSH, z poświadczeniami, które kontrolujesz, i bannerem, który nie zdradza niczego.

Co może zrobić agent

W ramach jednego połączenia agent widzi zwykłą powłokę w stylu Linuksa i może:

  • odczytywać i edytować pliki, zmieniać ustawienia oraz zarządzać modułami, pakietami i usługami;
  • segregować logi, pobierać artefakty i uruchamiać diagnostykę lub analizę śledczą na żądanie;
  • przenosić i synchronizować pliki w obie strony przez scp / sftp / rsync: kopie zapasowe, migracje, provisioning;
  • sterować całą flotą zrootowanych urządzeń z jednego miejsca, przy czym każde jest dostępne za pomocą własnego klucza.

Ponieważ projekt został zbudowany tak, aby był przyjazny dla AI (udokumentowany plik konfiguracyjny, jawny kontrakt środowiska uruchomieniowego, przewidywalne ścieżki i status w zwykłym tekście) agent może sam odkryć, jak z niego korzystać, bez zgadywania.

Jak robić to bezpiecznie

To jest root, więc traktuj go jak roota:

  • przydziel agentowi jego własne poświadczenie, a nie swoje osobiste, i skieruj go na konto o niższych uprawnieniach (shell), jeśli chcesz ograniczyć jego zasięg;
  • ogranicz powiązania do sieci, którym ufasz: loopback lub VPN zamiast otwartego Internetu (zobacz Konfiguracja);
  • pozostaw uwierzytelnianie hasłem wyłączone; klucz można odwołać i nigdy się go nie wpisuje;
  • w każdej chwili możesz odwołać klucz lub zatrzymać demona z poziomu WebUI;
  • pamiętaj, że domyślne połączenie to pełna sesja roota. Daj agentowi tylko taki zasięg, jakiego potrzebuje.

Minimalna konfiguracja

  1. Wygeneruj parę kluczy przeznaczoną wyłącznie dla agenta.
  2. Dodaj jego klucz publiczny w WebUI (Authorized keys).
  3. Powiąż tylko z loopbackiem lub swoim VPN, na porcie innym niż domyślny.
  4. Skieruj konfigurację SSH agenta na urządzenie i pozwól mu pracować.

Przez USB, bez ADB: włącz tethering USB i przypnij do adresu USB dla połączenia tylko przez kabel, przydatne dla agenta na podłączonym laptopie. Zobacz przewodnik użytkownika.


Ta dokumentacja została wygenerowana za pomocą Claude (Anthropic) i jest utrzymywana przez VD171. Poprawki i ulepszenia są mile widziane; zobacz CONTRIBUTING.md.

Clone this wiki locally