Przeglądaj skrzynkę

Ten poradnik pokazuje, jak pracować ze skrzynką: jedną powierzchnią, która zbiera wszystko, co Cię blokuje lub wprost prosi o Ciebie — oczekujące zatwierdzenia agentów, nieudane synchronizacje zgłoszeń i każdy pull request, w którym występujesz jako recenzent lub autor.

Otwórz skrzynkę

1. Kliknij Skrzynka na pasku bocznym. Jej plakietka zlicza oczekujące zatwierdzenia agentów, nieudane synchronizacje i otwarte PR-y czekające na Twoją recenzję.
2. Albo naciśnij ⌘K i uruchom polecenie nawigacji Skrzynka.
3. Albo przejdź bezpośrednio linkiem do /workspaces/<workspace-id>/inbox.

Wpis na pasku bocznym zawsze pokazuje liczbę na żywo, więc widzisz, jak praca do przejrzenia narasta, nawet nie otwierając strony.

Odczytaj istotność na pierwszy rzut oka

Czytaj od góry do dołu; skrzynka jest już uporządkowana według pilności:

1. Przypięty pasek Wymaga Twojej uwagi leży nad sekcjami PR-ów. Każda karta niesie chip istotności. Zarejestrowane źródła (agent zatrzymany na prośbie o potwierdzenie, synchronizacja zgłoszeń, której lustrzana kopia u dostawcy jest nieaktualna) emitują Zablokowane.
2. W obrębie paska najpierw pojawia się najwyższa istotność; przy remisie wygrywa pozycja oczekująca najdłużej.
3. Poniżej paska PR-y są grupowane w stałe sekcje cyklu recenzji — Czeka na Twoją recenzję, Zwrócone do Ciebie, Zatwierdzone, Szkice, Oczekujące na recenzentów, Scalane i ostatnio scalone, Oczekujące na autora. Górne sekcje to rzeczy, których potrzebujesz Ty; pozostałe pokazują, na jakim etapie są Twoje PR-y. Czeka na Twoją recenzję obejmuje PR-y, które wciąż proszą o zespół, do którego należysz, w tych forge, które je obsługują (GitHub usuwa zespół, gdy recenzję wykona dowolny członek zespołu).

Pozycja trafia do skrzynki tylko wtedy, gdy coś blokuje albo wprost prosi o Ciebie. Pusty pasek i pusta lista sekcji pokazują Jesteś na bieżąco tylko wtedy, gdy ta pustka jest wiarygodna.

Jedna skrzynka dla wszystkich forge

Jeśli obszar roboczy obejmuje repozytoria na więcej niż jednym hoście kodu, skrzynka scala je w jeden strumień — pull request z GitHuba i pull request z Bitbucket leżą w tej samej sekcji, uporządkowane według czasu, a nie pogrupowane według dostawcy. Rozróżnia je meta repo #number w wierszu.

„Twoje” rozstrzyga się osobno na każdym forge, bo na każdym jesteś innym kontem. Pull request liczy się jako Twój albo jako proszący o Twoją recenzję tylko wtedy, gdy pasuje do Twojej tożsamości na tym forge, na którym to repozytorium faktycznie się znajduje.

Forge, który nie działa albo nie jest połączony, nic nie wnosi i zostawia resztę skrzynki nietkniętą — jedno zerwane połączenie nigdy nie opróżnia całej listy. Pusty stan podaje zastrzeżenie zamiast Jesteś na bieżąco, gdy logowanie do każdego forge pozostaje nierozwiązane (Nie udało się potwierdzić Twojego konta GitHub — komunikat wciąż wymienia GitHuba), gdy githubstatus.com zgłasza incydent albo gdy instalacja GitHub App obejmująca powiązane repozytoria jest zawieszona.

Wyczyść pasek uwagi

Każda karta paska ma jedną następną akcję:

1. Jeśli karta to oczekujące potwierdzenie agenta, kliknij Recenzuj — trafiasz do przestrzeni tego agenta z jego oczekującym potwierdzeniem. Zatwierdź lub odrzuć je tam (zobacz Czatuj z agentem).
2. Jeśli karta mówi Nie udało się zsynchronizować dla danego dostawcy, kliknij Otwórz — trafiasz do Ustawienia → Obszar roboczy → Ogólne, gdzie karta Stan synchronizacji pokazuje ostatnią synchronizację każdego połączenia, serię kolejnych niepowodzeń i ostatni wynik. W skrzynce pojawia się tylko ostatnie niepowodzenie dla danego dostawcy, więc udana synchronizacja usuwa kartę.
3. Karty znikają samodzielnie, gdy tylko leżący u ich podstaw stan się rozwiąże (agent dostanie odpowiedź, synchronizacja wróci do zdrowia) — nie ma nic do ręcznego odrzucania.

To potwierdzenia na jedną turę, nie zatwierdzenia zarządcze

Karta „zatwierdzenia agenta” to działający agent, który zatrzymuje się, aby poprosić o zgodę na jedną akcję, we własnej rozmowie. To coś innego niż zarządczy rekord Approval, który agenci tworzą narzędziami MCP do zatwierdzeń — te nie mają w aplikacji żadnego ekranu dla człowieka i nigdy tu się nie pojawiają.

Stan synchronizacji jest tylko do odczytu

Karta dotyczy połączeń synchronizacji zgłoszeń; poza przyciskiem Synchronizuj teraz nie potrafi utworzyć, edytować ani połączyć ponownie żadnego z nich, a żaden inny ekran też tego nie potrafi. Bez skonfigurowanego połączenia pokazuje po prostu „Brak połączeń synchronizacji”, czyli to samo, co widzi świeży obszar roboczy.

Przefiltruj do tego, co blokuje

1. Naciśnij f (gdy żadne pole tekstowe nie ma fokusu), aby otworzyć menu filtrów, albo kliknij przycisk filtra na pasku narzędzi.
2. Wybierz dowolną kombinację statusu, autora, recenzentów, treści, właściciela lub nazwy repozytorium, okien dat albo szybkości recenzji. Liczniki faset w menu pokazują, do ilu pozycji w skrzynce pasuje każda opcja.
3. Aktywne filtry pojawiają się jako chipy na pasku nad listą; kliknij ✕ na chipie, aby usunąć to kryterium.
4. Użyj paska sekcji po lewej, aby przeskakiwać między sekcjami — każdy wpis pokazuje liczbę na żywo, a podświetlenie śledzi pozycję przewijania. Kliknij nagłówek sekcji, aby zwinąć sekcje, których nie przeglądasz (na przykład Szkice podczas czyszczenia recenzji).
5. Kliknij nagłówek kolumny (tytuł, zmiany lub zaktualizowano), aby posortować wszystkie sekcje; kliknij aktywną kolumnę ponownie, aby odwrócić kierunek. Przycisk opcji wyświetlania steruje widocznością szkiców, oknem ostatnio scalonych, właściwościami wiersza, kolejnością i grupowaniem (układ skrzynki zmienia wyłącznie grupowanie według autora).

Filtry w tym miejscu są niezależne od kolejki PR-ów — zawężanie skrzynki nigdy nie zmienia filtrów kolejki i odwrotnie.

Działaj na pozycji PR-a

1. Kliknij dowolny wiersz, aby otworzyć stronę szczegółów PR-a.
2. Jeśli PR jest w Czeka na Twoją recenzję, zrecenzuj go i prześlij swoją decyzję — zobacz Zrecenzuj i scal PR.
3. Jeśli PR jest w Zwrócone do Ciebie (poproszono o zmiany albo CI zawiodło), wypchnij poprawki ze swojego checkoutu lub przekaż dalszą pracę agentowi.
4. Jeśli PR jest w Zatwierdzone, scal go ze strony szczegółów.
5. Jeśli wolisz delegować recenzję zamiast robić ją samodzielnie, zobacz Wyślij agentów-recenzentów i Cykl życia wysyłania agentów.

Gdy tylko leżący u podstaw stan się zmieni (Twoja recenzja zostanie wysłana, PR się scali), klasyfikator automatycznie przenosi PR do jego nowej sekcji.

Cofnij omyłkową akcję

1. Naciśnij ⌘Z, aby cofnąć ostatnią akcję, ⌘⇧Z, aby ją ponowić.
2. Jeśli fokus ma pole tekstowe, ⌘Z edytuje tekst w tym polu — kliknij poza polem, aby cofnąć akcję na poziomie aplikacji.

Sprawdź skróty na miejscu

Naciśnij ? (gdy żadne pole tekstowe nie ma fokusu), aby otworzyć ściągawkę skrótów klawiszowych. Wymienia ona każde przypisanie aktywne na bieżącej trasie, w tym skrót filtra f w skrzynce. Pełna mapa znajduje się w dokumentacji referencyjnej skrótów klawiszowych.

Steruj nią z palety poleceń

1. Naciśnij ⌘K w dowolnym miejscu, aby otworzyć paletę poleceń.
2. Wpisz Skrzynka, aby przejść do tej strony, albo wpisz tytuł PR-a — paleta wylicza pasujące pull requesty i otwiera ten, który wybierzesz.
3. Gdy skrzynka jest otwarta, uruchom Skopiuj link do tej strony, aby skopiować ten URL do udostępnienia. Polecenie kopiuje bieżącą trasę, więc URL skrzynki to ono tylko wtedy, gdy jesteś na tej stronie.

Odświeżaj na żądanie

Skrzynka aktualizuje się na żywo, ale jeśli podejrzewasz nieaktualne dane, kliknij kontrolkę odświeżania na pasku narzędzi — wymusza ona natychmiastowe przejrzenie przez serwer każdego połączonego forge i ponownie pobiera nakładki scalonych i zrecenzowanych pozycji. Ikona wiruje, dopóki nie zakończą się wszystkie pobrania.

Powiązane poradniki

• Zrecenzuj i scal PR
• Czatuj z agentem
• Wyślij agentów-recenzentów

Powiązane koncepcje

• Cykl życia wysyłania agentów