Podręcznik: polecenia, szczegóły, problemy

Instalacja jeszcze trwa. W macOS pobieranie narzędzi Apple (Command Line Tools) może zająć do 20 minut. Jeśli terminal zakończył pracę błędem, wystarczy ponownie skopiować wiersz w aplikacji i jeszcze raz go wkleić. Okno oczekiwania można zamknąć; niczego nie blokuje.

Chrome może zapytać: „Dostęp do innych aplikacji i usług na tym urządzeniu · Blokuj / Zezwól”. Po wybraniu Zezwól Strom sam łączy się z badaniem; bez tego Strom do niego nie dotrze. Edge i Firefox w teście nie pytały. Badanie działa na tym samym komputerze; nic nie wychodzi na zewnątrz.

Gdy przy pytaniu wybrano Blokuj, przeglądarka odcina Strom od badania. Na dostęp można zezwolić później:

1. Ikona po lewej stronie adresu strony.
2. Ustawienia witryny → Aplikacje na urządzeniu (w starszych wersjach Dostęp do sieci lokalnej); w Brave Localhost access.
3. Zezwól, potem Spróbuj ponownie w aplikacji.

Safari nie pozwala stronie internetowej rozmawiać z programem na tym samym komputerze, więc nie dociera do badania. Badanie zainstalowane z aplikacji Strom w Safari przejmuje drzewo przez plik, a gdy jest gotowe, otwiera je w Chrome, Edge lub Firefoksie; od tej chwili z drzewem pracuje się tam. Drugą drogą jest eksport GEDCOM (Safari i plik).

Wiersz z aplikacji jest ważny przez 24 godziny. Jeśli instalacja w tym czasie się zakończyła, wystarczy uruchomić badanie (strom). W przeciwnym razie Nowe polecenie w aplikacji podaje świeży wiersz; wcześniejsza instalacja zostaje bez zmian, nic nie jest usuwane.

• Telefon w tej samej sieci Wi-Fi co komputer; sieć dla gości ani dane komórkowe nie wystarczą.
• Jeśli zapora Maca jest włączona, może pojawić się okno „Zezwolić na połączenia przychodzące dla node?” → Zezwól. Jeśli wcześniej wybrano Odmów: Ustawienia systemowe → Sieć → Zapora → Opcje.
• Kod jest ważny 10 minut i dla jednego telefonu; inny telefon potrzebuje nowego kodu.
• Po zmianie adresu komputera telefony wymagają ponownego sparowania.
• Komputer włączony i badanie uruchomione; w terminalu strom phone on.
• Komunikat Ta wersja badania nie łączy telefonu: badanie wymaga aktualizacji.
• Sparowane telefony → Odłącz (można Cofnij); Wyłącz połączenie wyłącza stronę telefonu.

Pomaga nowe okno terminala – stare nie zna jeszcze nowej zmiennej PATH. Albo strom uruchamia się pełną ścieżką, którą instalator wypisał na końcu.

Przy wyszarzonej pozycji aplikacja pokazuje powód i odnośnik Otwórz badanie ↗. Najczęściej: brak agenta na komputerze, agent nie jest zalogowany, subskrypcja agenta osiągnęła limit albo badanie nie działa. Odczytuje agent, z którym pracuje badanie; Archiwum Strom, bez AI, dokumentów nie odczytuje.

W Safari, na telefonie i przy drzewie bez badania pozycja w ogóle się nie wyświetla.

Zwykle chodzi o połączenie z internetem; ten sam wiersz można po prostu uruchomić ponownie. W pracy firmowy serwer proxy lub zapora mogą blokować GitHub albo nodejs.org – pomaga inna sieć.

Coś poszło nie tak po drodze. Wystarczy uruchomić ten sam wiersz ponownie; instalator jeszcze raz wszystko pobiera i sprawdza.

Wiersz z kroku 2 w oknie Win + R zezwala instalatorowi tylko na to jedno uruchomienie i nie zmienia żadnego ustawienia komputera. Jeśli komunikat pojawia się w PowerShell, pomaga ten sam wiersz w oknie Win + R.

Nic z tego, co jest pobierane, nie jest naszym programem: tylko oficjalny, podpisany Node.js i kod Strom Research jako czytelny JavaScript. Pomóc może administrator komputera.

Instalacja zatrzymała się z błędem, a okno zostaje otwarte, aby można było przeczytać jego ostatnie komunikaty. Enter je zamyka; potem ten sam wiersz można uruchomić ponownie.

Przy instalacji wierszem nie powinno się to zdarzyć. Gdyby macOS zablokował program: Ustawienia systemowe → Prywatność i ochrona → Otwórz mimo to.

Nowszy macOS może zatrzymać wklejanie do Terminala tym komunikatem. Apple radzi wklejać tylko polecenie, którego pochodzenie i cel są jasne. Wiersz instalacyjny z tej strony lub z aplikacji Strom instaluje Strom Research z GitHuba (ACiDekCZ/strom-research); przycisk Wklej mimo to go wkleja. Zablokowane wklejenie nie oznacza, że Mac doznał szkody. Więcej u Apple.

Codex dopisuje się do zmiennej PATH użytkownika; potem uruchamia się poleceniem codex w nowym oknie PowerShell. Okno uruchomione z Win + R zamyka się zaraz po instalacji.

Strom Research mówi agentowi, dlaczego tak jest i co pomaga. Zapisuje reguły dla Codexa do folderu badania (.codex/rules/strom.rules): strom uruchomiony samodzielnie działa wtedy poza piaskownicą Codexa. Codex je odczytuje, gdy działa w folderze badania, któremu ufa. Po aktualizacji zapisuje je pierwsze uruchomienie badania poleceniem strom. Gdy Codex mimo to zatrzymuje polecenie (w Windows czasem tylko z komunikatem „blocked by policy”), pomaga zatwierdzenie polecenia poza piaskownicą albo samodzielne uruchomienie strom. strom doctor próbuje zapisać do badania i informuje, gdy to nie działa.

Pliki wspólnego folderu nieprzeniesione na ten komputer oraz pliki badania w iCloud Drive jeszcze niepobrane: strom check mówi, ile ich jest, i wymienia pierwszy. Wspólny folder wraca w całości razem z folderem Strom z kopii zapasowej (jego podfolder shared); badanie w iCloud Drive pobiera się w Finderze albo wyjmuje jego folder z iCloud Drive. Nic nie jest usuwane i nic nie jest zapisywane w miejsce brakujących plików. Pełny dysk jest zgłaszany razem z folderem, który na nim leży.

Drzewo zapieczętowane na innym komputerze (albo bez ustawień programu strom na tym) można czytać; zapis to zgłasza i proponuje jeden krok, przejęcie na tym komputerze: strom seal adopt, proponowane też w menu badania, w kreatorze i w aplikacji Strom przyciskiem Przejmij na tym komputerze ↗. Przejęcie następuje tylko za zgodą człowieka, nigdy przez agenta. Drzewo, którego nie ma już w jego folderze, jest zgłaszane ze starym folderem; strom trees use <folder> dodaje nowy i żadne inne drzewo nie otwiera się w jego miejsce. Niepotrzebne drzewo znika z listy po strom trees forget, nic nie jest usuwane. Pusta aplikacja Strom (z wyczyszczonymi danymi przeglądarki), która prosi o nowe badanie, najpierw dostaje propozycję drzew, które już są na tym komputerze, aby jedno z nich otworzyć w aplikacji.

Archiwum wpuszcza automatyczne narzędzia tylko przez przeglądarkę człowieka albo jego warunki nie pozwalają na nic innego. Badanie mówi, jakiej księgi i jakich skanów potrzebuje, i zakłada dla nich folder; to, co się tam zapisze albo doda przyciskiem Dodaj skany w aplikacji Strom, przejmuje samo, a zadanie wraca do kolejki, gdy są już wszystkie. Przy archiwum, do którego dociera tylko przeglądarka człowieka, aplikacja mówi obok, z czym agent zapisałby je sam: Claude Code z rozszerzeniem Claude in Chrome i zgoda „przez przeglądarkę” dla tego archiwum (Zgoda…). Czy rozszerzenie jest, mówi strom doctor.

To w porządku: jego własne zabezpieczenia nie pozwalają mu instalować programów z internetu. Krok 2 to jeden wiersz w Win + R (Windows) lub w terminalu.

Pokazuje to strom w nowym terminalu: jeśli się uruchamia, instalacja jest w porządku. Jeśli nie, strom doctor mówi, czego brakuje, albo wiersz z kroku 2 można uruchomić ponownie, a jego ostatnie komunikaty mówią dlaczego.