Przejdź do głównej zawartości

Widżety

Widżet to zapisana strona, którą otwierasz w panelu obok terminala jednym stuknięciem: aplikacja, którą agent uruchomił na swoim porcie, albo plik HTML z dysku. Nie musisz za każdym razem wpisywać adresu.

Widżety są domyślnie włączone. W Ustawienia → Komponenty → Widżety możesz je wyłączyć dla wszystkich urządzeń. Przycisk Widżety i Zapisz jako widżet wtedy znikają, a polecenia agenta oraz API zwracają „Widżety są wyłączone w Ustawieniach”. Zapisane widżety pozostają i wracają po włączeniu dodatku. Port zapisany wyłącznie w widżecie przestaje być dostępny przez podgląd.

W nagłówku terminala jest przycisk Widżety (ikona panelu po prawej). Stuknij go, a zobaczysz listę zapisanych widżetów: najpierw te z tego workspace’u, potem te dostępne wszędzie na tym serwerze, a na końcu widżety Wszędzie z innych serwerów. Przy tych ostatnich zobaczysz mały podpis z nazwą serwera. Otwierają się na serwerze, na którym zostały zapisane. Stuknięcie nazwy otwiera widżet w panelu. Na samym końcu listy jest Nowy widżet….

Przycisk Widżety jest też w nagłówku listy serwerów i listy workspace’ów serwera, na telefonie i komputerze. Na listach pokazuje tylko widżety Wszędzie: najpierw z wybranego serwera (na liście serwerów z pierwszego serwera lokalnego), potem z pozostałych serwerów z podpisem ich nazwy. Nowy widżet utworzony z listy ma zakres Wszędzie. Po stuknięciu widżet portu, pliku HTML albo linku HTTPS otwiera się w pełnoekranowym panelu z przyciskiem wstecz, na telefonie i komputerze. Przycisk wstecz zamyka panel i wraca do tej samej listy.

Szybki tunel z adresem trycloudflare.com nie udostępnia podglądu portów. Pliki HTML pozostają dostępne w panelu przez adres aplikacji.

Podgląd strony z portu działa przez Tailscale, na tym Macu albo przez dostęp przez couchterm.app, także dla usług uruchomionych poza terminalem, jeśli podgląd jest włączony i port nie należy do couchterma ani Whispera. Gdy podgląd nie jest osiągalny, widżety z portem są wyszarzone, a stuknięcie pokazuje komunikat „Tylko przez Tailscale” zamiast panelu. Przy nazwach widżetów portu i linków z adresem kończącym się na .ts.net jest małe logo Tailscale.

Link HTTPS do usługi z adresem kończącym się na .ts.net, zapisany na lokalnym serwerze, otwiera się przez serwer podglądu couchterma, jeśli podgląd jest włączony i osiągalny. Link zapisany na serwerze SSH panel otwiera bezpośrednio. Dzięki temu możesz korzystać z usługi w tailnecie także przez dostęp przez couchterm.app. Podgląd używa wtedy tego samego adresu couchterma na porcie :8443. Gdy podgląd jest wyłączony albo nieosiągalny, panel próbuje otworzyć link bezpośrednio. Zarchiwizowany widżet nie udostępnia usługi przez podgląd.

Gdy strona portu nie potwierdzi wczytania, panel pokaże nad ramką komunikat z prośbą o sprawdzenie, czy serwer na tym porcie odpowiada. Komunikat zniknie, gdy strona potwierdzi wczytanie.

Wybierz Nowy widżet…. Formularz ma pola:

  • Nazwa: do 40 znaków;
  • Adres: port albo plik HTML, na przykład localhost:5173/camera, :5173 albo /sciezka/do/pliku.html (ścieżka musi kończyć się na .html). Port musi być z zakresu 1 do 65535. Możesz też podać adres https://example.com: do 500 znaków, bez loginu i hasła. Taki link otwiera się w panelu. Jeśli strona nie pozwala pokazać się w panelu, zobaczysz komunikat i przycisk Otwórz w przeglądarce;
  • Zakres: Tylko w tym workspace (domyślnie) albo Wszędzie;
  • Kamera i mikrofon: pole wyboru, widoczne tylko dla adresu z portem. Zaznacz je, gdy strona ma korzystać z kamery lub mikrofonu.

Wybierz Zapisz. W terminalu widżet portu, pliku HTML albo linku HTTPS zapisze się i od razu otworzy w panelu. Na liście zapisze się bez otwierania okna. Otworzysz go z przycisku Widżety.

Gdy w panelu masz otwartą stronę z portu albo plik HTML, w pasku panelu jest przycisk Zapisz jako widżet. Formularz nie pyta wtedy o adres, tylko o Nazwę, Zakres i Kamera i mikrofon.

Na telefonie formularz zapisu i arkusz zgody na otwarcie agenta pojawiają się nad pełnoekranowym panelem. Możesz z nich korzystać bez zamykania panelu.

Na liście widżetów kliknij pozycję prawym przyciskiem myszy albo przytrzymaj ją palcem. Pojawi się małe menu z opcjami Zmień i Usuń. Zmień otwiera ten sam formularz co przy tworzeniu. Usuń pyta o potwierdzenie („Usunąć widżet …?”), a usunięcia nie da się cofnąć.

Otwórz Ustawienia → Widżety. Sekcja jest widoczna przy włączonym dodatku. Dla każdego serwera zobaczysz nazwy, rodzaje i zakresy widżetów oraz przycisk Nowy widżet. Zmień otwiera formularz, a Usuń wymaga potwierdzenia w arkuszu.

Archiwizuj ukrywa widżet w menu i blokuje jego otwieranie, także przez agenta. Port zapisany tylko w tym widżecie traci dostęp do podglądu. Widżet pozostaje w zwiniętej grupie Zarchiwizowane. Rozwiń ją i wybierz Przywróć, aby ponownie udostępnić widżet.

couchtermctl widget add NAZWA --url https://example.com zapisuje link HTTPS, a --server ID wybiera serwer z konfiguracji dla add, rm i list; --open nie łączy się z --url ani --server, a open nie przyjmuje --server i działa na serwerze bieżącego terminala.

Agent pracujący w couchtermie dodaje i otwiera widżety poleceniem couchtermctl widget (opcje add, rm, open, list). Może ustawić port albo plik, zakres i poprosić o kamerę i mikrofon. Opis poleceń jest w pliku skills/couchterm/reference.md w repozytorium.

  • Na komputerze widżet portu albo pliku otwarty przez agenta od razu pokazuje się w panelu. Link HTTPS sygnalizuje powiadomienie i kropka przy Widżety. Stuknij jego nazwę w menu, aby otworzyć go w panelu.
  • Na telefonie panelu nie otwieramy bez Twojej wiedzy: pojawia się powiadomienie „Agent otworzył widżet: …”, a na przycisku Widżety świeci niebieska kropka. Po stuknięciu przycisku ten widżet jest na górze listy.

Widżet z pliku HTML może poprosić o otwarcie agenta. Zobaczysz nazwę widżetu, nazwę agenta i pełne polecenie. Dopiero Otwórz tworzy nowy terminal z agentem w tym samym workspace i przechodzi do niego, na telefonie i komputerze. Anuluj zamyka prośbę bez uruchamiania agenta.

Polecenie musi mieć od 1 do 2000 znaków po usunięciu spacji na początku i końcu. Widżet może wskazać skonfigurowanego agenta, a bez wskazania używany jest ostatnio wybrany, domyślnie Claude. Couchterm pokazuje jedną prośbę naraz i przyjmuje najwyżej jedną na 3 sekundy. Widżety z portu nie mogą wysyłać takich próśb.

Przeglądarka pozwala na kamerę i mikrofon tylko na stronach przez https. Gdy otworzysz couchterm zwykłym adresem http, panel z takim widżetem pokaże ostrzeżenie: „Kamera i mikrofon działają tylko przez https. Otwórz couchterm adresem Tailscale.” Otwórz wtedy couchterm adresem https z Tailscale.

Kamerę i mikrofon włącza użytkownik w panelu: widżet, który o nie prosi (np. dodany przez agenta), pokazuje nad ramką pasek z przyciskiem Zezwól, i dopiero po jego kliknięciu ramka dostaje te uprawnienia.

Plik HTML z dysku nie dostaje dostępu do kamery i mikrofonu, dlatego przy nim pola Kamera i mikrofon nie ma.

Więcej o panelu, w którym widżet się otwiera, jest na stronie Terminal.