Czy arc CLI jest bezpieczny w instalacji?
Ta strona precyzyjnie opisuje, czym jest plik binarny arc, co robi podczas
działania, co opuszcza Twój komputer i dokąd trafia oraz jak wyłączyć lub usunąć
każdy z tych elementów. Każde twierdzenie tutaj można zweryfikować w skryptach
instalacyjnych i w samym pliku binarnym.
Czym jest
arc to klient wiersza poleceń dla API Arc OS. Analizuje polecenie, wysyła
żądania HTTPS do API, wypisuje wynik i kończy działanie.
- Jeden samodzielny plik wykonywalny, skompilowany z jednego pliku źródłowego
(
clients/arc-cli.ts) za pomocą Bun. Bez drzewa zależności zainstalowanego w systemie. - Proces jednorazowy. Polecenie się wykonuje i kończy; nic nie utrzymuje się w
pamięci ani nie uruchamia usługi. Jedynym wyjątkiem jest
arc start, opisany poniżej. - Jeden cel sieciowy:
arc-os.co(lub adres serwera, który sam ustawisz). Plik binarny nie zawiera innego adresu wychodzącego, analityki ani telemetrii.
Instalacja
Skrypty instalacyjne pobierają gotowy plik binarny z naszego serwera i umieszczają go w PATH.
# macOS / Linux
curl -sSf https://arc-os.co/install.sh | bash
# Windows (PowerShell)
iwr https://arc-os.co/install.ps1 -useb | iex
Oba skrypty to zwykły tekst pod tymi adresami. Jeśli chcesz zobaczyć, co wykonują, otwórz je przed uruchomieniem. Przekazanie dowolnego skryptu do powłoki oznacza zaufanie do jego źródła; jeśli wolisz tego nie robić, pobierz plik binarny z adresu podanego w skrypcie, sprawdź go samodzielnie i przenieś ręcznie do PATH.
Zachowanie podczas działania
Polecenia na co dzień (arc issues, arc report i tak dalej) wykonują się i
kończą bez żadnych pozostałych procesów.
arc start uruchamia sesję roboczą z Claude i instaluje hooki sesji. To jedyne
zachowania działające w tle, a każde z nich ma wyłącznik:
| Zachowanie | Co wysyła | Wyzwalacz | Wyłączenie |
|---|---|---|---|
| Synchronizacja czatu | Wiadomości z sesji (limit rozmiaru na wiadomość) na Twoje konto Arc, aby aplikacja webowa mogła wyświetlić rozmowę. | Podczas sesji arc start. |
Używaj zwykłych poleceń zamiast arc start. |
| Synchronizacja czasu pracy | Czasy pracy, projekt, aktywny issue, tematy commitów. Bez treści rozmów. Najwyżej raz na 5 minut. | Podczas sesji arc start. |
ARC_DISABLE_AUTO_SYNC=1 |
| Powiadomienie Telegram | Krótkie powiadomienie "tura zakończona" lub "oczekuje na dane wejściowe", jeśli połączyłeś Telegram. | Podczas sesji arc start. |
CRM_DISABLE_TG_NOTIFY=1 |
| Automatyczna aktualizacja | Zaplanowane zadanie sprawdzające nowszą wersję przy logowaniu. Tylko Windows i tylko jeśli uruchomiłeś opcjonalny instalator Windows. Skrypty curl/iwr powyżej go nie konfigurują. | Logowanie, tylko instalator Windows. | Odinstalowanie je usuwa. |
Żadne z nich nie jest samodzielnym demonem. To hooki powiązane z sesją
arc start lub, w przypadku automatycznej aktualizacji, z instalatorem Windows,
na który się zgodziłeś. Po zakończeniu sesji nic nie działa dalej.
Synchronizacja czatu wysyła transkrypcję sesji na serwer. Jest to wymagane, aby
aplikacja webowa mogła pokazywać Twoje czaty; to funkcja produktu, a nie ukryty
kanał. Jeśli tego nie chcesz, nie używaj arc start.
Dane i miejsca docelowe
- Cały ruch idzie do
arc-os.co(lub skonfigurowanego przez Ciebie serwera) przez HTTPS. - Wysyłane: metadane pracy (synchronizacja czasu pracy) i wiadomości sesji
(synchronizacja czatu, tylko podczas
arc start). - Nieobecne w pliku binarnym: żadnych zewnętrznych punktów analityki, reklam ani telemetrii.
Dane uwierzytelniające
arc loginzapisuje Twój token w~/.arc/config.json, tworzonym z uprawnieniami tylko dla właściciela (plik 0600, katalog 0700).- Token jest przesyłany wyłącznie jako nagłówek
Authorization: Bearerdo skonfigurowanego serwera. Nigdy nie jest zapisywany w logach ani powiadomieniach; wyjście hooków jest czyszczone z tokenów, kluczy API i JWT przed wysłaniem. arc logoutlub usunięcie~/.arc/config.jsongo usuwa.
Zweryfikuj pobrany plik
Publikujemy sumę kontrolną SHA256 dla każdego pliku binarnego. Skrypty instalacyjne sprawdzają ją automatycznie i przerywają działanie w razie niezgodności. Aby zweryfikować plik ręcznie:
# Linux / macOS: porównaj plik z opublikowanym skrótem
curl -sSL https://arc-os.co/api/cli/download/linux-x64.sha256 # or darwin-arm64, darwin-x64
sha256sum arc # compare the hash to the line above (shasum -a 256 on macOS)
# Windows PowerShell
(Invoke-WebRequest https://arc-os.co/api/cli/download/windows-x64.sha256 -UseBasicParsing).Content
Get-FileHash .\arc.exe -Algorithm SHA256
Wszystkie skróty razem znajdują się pod adresem https://arc-os.co/api/cli/checksums.
Suma kontrolna potwierdza, że plik jest zgodny z tym, co serwuje nasz serwer, więc
wykrywa uszkodzone lub zmienione pobranie. Sama w sobie nie dowodzi jednak wydawcy;
to robi podpisywanie kodu (patrz niżej).
Weryfikacja i usunięcie
arc --version # wersja
which arc # lokalizacja instalacji (macOS/Linux)
where arc # lokalizacja instalacji (Windows)
Aby odinstalować, usuń plik binarny z PATH i usuń katalog ~/.arc.
W toku
- Podpis kodu. Plik binarny nie jest jeszcze podpisany kodem, więc Windows i macOS mogą przy pierwszym uruchomieniu pokazać ostrzeżenie „nieznany wydawca”. Podpisywanie jest zaplanowane, aby system operacyjny mógł bezpośrednio potwierdzić wydawcę. Do tego czasu opublikowane powyżej sumy kontrolne pozwalają Ci samodzielnie zweryfikować plik.
Jeśli cokolwiek tutaj nie zgadza się z tym, co zaobserwujesz, daj nam znać.