Arc OS Docs Open in app →

Arc OS — Przewodnik Użytkownika

Kompletny przewodnik po wszystkich funkcjach CRM Dashboard Arc OS. Ostatnia aktualizacja: 2026-05-04 (Phase 52.1)

Mapa funkcji w skrócie

graph LR
    Login[1. Logowanie + kod zaproszenia]
    Dash[2. Widok Wszystkich Projektów]
    Onb[3. Kreator Tworzenia Projektu]
    Work[4. Workspace + Workerzy]
    Time[5. Odtwarzanie Timeline]
    Iss[6. Redesign Issues]
    Skill[7. Skille + Sage]
    Wiki[8. Wiki + KG]
    NB[9. NotebookLM]
    Bill[10. Okres próbny + Billing]

    Login --> Dash --> Onb --> Work
    Work --> Time
    Work --> Iss
    Work --> Skill
    Work --> Wiki --> NB
    Dash --> Bill

Spis Treści

  1. Pierwsze Kroki
  2. Układ Pulpitu
  3. Workspace — Workerzy AI
  4. Załączniki Plików
  5. Foldery — Menedżer Plików
  6. Worker Studio — Niestandardowi Workerzy
  7. Issues
  8. Wiki
  9. Graf Wiedzy
  10. Ewolucja Skilów
  11. Roadmap
  12. Raporty
  13. Analityka
  14. NotebookLM — Pamięć Neuronalna
  15. Cloud PM — Czat Projektu
  16. Ustawienia Projektu
  17. Integracja z Telegram
  18. Motyw i Ustawienia
  19. Skróty Klawiaturowe
  20. Rozwiązywanie Problemów
  21. Timeline (Phase 47)
  22. Kredyty Próbne i Billing
  23. Dostęp Beta — Kody Zaproszenia

1. Pierwsze Kroki

Bramka beta (Phase 52.1): Rejestracja publiczna jest aktualnie tylko na zaproszenie. Potrzebujesz kodu zaproszenia w formacie arc-XXXX-XXXX, żeby założyć konto. Zobacz §23 Dostęp Beta, jak go zdobyć.

Przepływ Onboardingu — Storyboard

sequenceDiagram
    autonumber
    actor U as Ty
    participant L as Ekran Logowania
    participant E as Email
    participant W as Kreator Onboardingu
    participant M as Master Bot
    participant Wo as Workspace

    U->>L: wklej kod zaproszenia arc-XXXX-XXXX
    L->>L: walidacja formatu
    U->>L: wpisz email + hasło + imię
    L-->>E: wyślij link weryfikacyjny (TTL 24h)
    U->>E: kliknij link weryfikacyjny
    E->>L: przekieruj → zalogowany
    L->>W: pierwszy raz → kreator
    U->>W: nazwa projektu · wybierz blueprint · ustaw klucz Anthropic (opcjonalnie)
    W->>M: POST /api/crm/onboarding/setup
    M->>M: allocatePort() · utwórz katalogi · sklonuj blueprint · uruchom Child Bot
    M-->>W: projekt gotowy
    W->>Wo: przekieruj do /project/<name>
    U->>Wo: wyślij pierwszą wiadomość
    Wo-->>U: strumieniowanie tokenów przez SSE

Budżet czasu: cel ≤10 min od wklejenia kodu zaproszenia do pierwszej odpowiedzi AI. Kroki 1-5 ≈ 3 min, kroki 6-9 ≈ 2 min, pierwszy czat ≈ 1-5 min zależnie od klonowania blueprintu.

Logowanie

Arc OS obsługuje trzy metody uwierzytelniania:

Opcja A: Email i Hasło

  1. Otwórz CRM dashboard (https://arc-os.co lub http://<server>:18888).
  2. Kliknij Utwórz Konto na ekranie logowania.
  3. Wpisz swój email, nazwę wyświetlaną, hasło i kod zaproszenia (arc-XXXX-XXXX).
  4. Zweryfikuj email przez link wysłany na skrzynkę (TTL 24h).
  5. Zaloguj się emailem i hasłem.

Opcja B: OAuth (Google / GitHub)

  1. Otwórz ekran logowania CRM.
  2. Kliknij Kontynuuj z Google lub Kontynuuj z GitHub.
  3. Autoryzuj w oknie popup.
  4. Zostaniesz przekierowany z powrotem i zalogowany automatycznie.

Wszystkie metody generują token JWT (ważny 24 godziny) przechowywany w przeglądarce.

Pierwsze Kroki

Po zalogowaniu zobaczysz widok Wszystkie Projekty. Użyj selektora workspace w nagłówku, żeby przełączać się między projektami, lub kliknij Wszystkie Projekty, żeby zobaczyć globalny pulpit.

2. Układ Pulpitu

Górny Nagłówek

Element Opis
Menu hamburger Przełącz pasek boczny (lewa krawędź)
Selektor workspace Lista rozwijana do przełączania między projektami i globalnym widokiem "Wszystkie Projekty"
Wskaźnik połączenia Zielona kropka = połączono, czerwona = rozłączono
Przełącznik motywu Przełącz tryb jasny/ciemny
Menu użytkownika Profil, Ustawienia Konta, Wyloguj

Pasek Boczny

Zwijane menu nawigacyjne (kliknij hamburger, żeby przełączyć). Na telefonie: nakładkowa szuflada z tłem.

Strony globalne (widoczne z Wszystkich Projektów):

Strony projektowe (widoczne gdy wybrany jest projekt):

ContextRail (Panel Prawy, ≥1280px)

Panel 320px po prawej stronie pokazujący kontekst projektu obok aktywnej strony. Sekcje:

3. Workspace — Workerzy AI

Workspace to główny interfejs do interakcji z AI. Używa systemu Dynamic Worker, gdzie każdy worker to wyspecjalizowany agent AI.

Wbudowani Workerzy

Worker Typ Model Przeznaczenie
Consultant Czat Sonnet Analiza tylko do odczytu, doradztwo architektoniczne, propozycje specyfikacji
Developer Terminal Opus Pełna edycja kodu, operacje na plikach, komendy bash

Pasek Workerów

Na górze Workspace widoczne są pigułki workerów (przyciski):

Workerzy Czatu (Consultant)

Interfejs dymkowy w stylu czatu:

Workerzy Terminala (Developer)

Interfejs strumieniowania logów:

Selektor Modelu

W dolnym pasku narzędzi każdego panelu workera:

Szybkie Akcje (Dolny Pasek)

Przycisk Akcja
/btw Dodaj notatkę kontekstową — pyta o tekst, dołącza do następnej wiadomości
Pause Wstrzymaj bieżący subprocess Claude (SIGSTOP)
Stop Zabij bieżący subprocess Claude (SIGKILL)
Approve Last Wyślij /approve do developera dla ostatniej specyfikacji

4. Załączniki Plików

Możesz dołączać pliki do dowolnej wiadomości workera.

Jak Dołączyć

  1. Kliknij ikonę spinacza w obszarze wpisywania wiadomości, LUB
  2. Przeciągnij i upuść pliki na workspace, LUB
  3. Wklej obraz ze schowka

Obsługiwane Typy Plików

Typ Rozszerzenia Przetwarzanie
Tekst/Kod .txt, .md, .py, .js, .ts, .jsx, .tsx, .css, .html, .json, .yaml, .sh, .sql, .csv, .go, .rs, .java, .c, .cpp, .rb, .php itp. Odczytany jako tekst, treść wstrzyknięta do wiadomości
Obrazy .png, .jpg, .jpeg, .gif, .webp, .svg, .bmp Skompresowany do JPEG (maks. 1600px, 80% jakości), wyświetlany jako miniatura
PDF .pdf Odczytany jako base64, zapisany jako plik tymczasowy na serwerze, ścieżka wstrzyknięta do promptu

Chipy Załączników

Po dołączeniu pliki pojawiają się jako chipy nad polem wpisywania:

Limity Rozmiaru

5. Foldery — Menedżer Plików

Strona Foldery udostępnia pełną przeglądarkę plików dla katalogu projektu na serwerze.

Nawigacja

Akcje Paska Narzędzi

Akcja Opis
Prześlij Przesyłanie wielu plików (przycisk lub przeciągnij i upuść)
Nowy Folder Utwórz nowy katalog (wpisz nazwę)
Nowy Plik Utwórz plik z opcjonalną początkową zawartością
Dodaj Link Utwórz plik zakładki .link.md (URL + tekst)
Sklonuj Repo Sklonuj repozytorium Git (URL HTTPS, płytkie --depth 1)

Menu Kontekstowe (Prawy przycisk myszy)

Kliknij prawym przyciskiem myszy dowolny element, żeby uzyskać dodatkowe opcje:

Na plikach:

Na folderach:

Na pustej przestrzeni:

Panel Podglądu Pliku

Gdy klikniesz plik, otwiera się panel boczny pokazujący:

6. Worker Studio — Niestandardowi Workerzy

Możesz tworzyć niestandardowych workerów AI dostosowanych do potrzeb projektu.

Tworzenie Workera

  1. W Workspace kliknij ikonę zębatki (Worker Studio) na pasku workerów
  2. Kliknij + Nowy Worker
  3. Wypełnij konfigurację workera:
Pole Opis
Etykieta Nazwa wyświetlana (np. "QA Tester")
Ikona Ikona emoji na pigułce workera
Typ Czat (styl konwersacji) lub Terminal (strumieniowanie logów)
Model Model AI do użycia (Sonnet, Opus, Haiku)
Max Turns Maksymalna liczba tur subprocess Claude (1-50)
Narzędzia Które narzędzia worker może używać (Read, Edit, Bash itp.) lub "all"
Katalogi Fokus Katalogi, na których worker powinien się skupić
Prompt Systemowy Niestandardowe instrukcje systemowe dla workera
Zasoby Kontekstu Pliki/katalogi automatycznie ładowane jako kontekst

Prompty Systemowe Generowane przez AI

Kliknij Generuj z AI, żeby automatycznie utworzyć prompt systemowy na podstawie:

Token Bota Telegram

Każdy worker może mieć własny dedykowany bot Telegram:

  1. Edytuj workera w Worker Studio
  2. W sekcji Token Bota Telegram wklej token bota (z @BotFather)
  3. Kliknij Połącz
  4. Bot workera startuje automatycznie i obsługuje wiadomości niezależnie
  5. Żeby usunąć: kliknij Rozłącz

Umożliwia to boty Telegram per worker — np. bot Consultant z dostępem tylko do odczytu i bot Developer z pełnym dostępem.

Zarządzanie Workerami

7. Issues

Strona Issues to pełny tracker issues dla projektu.

Funkcje

Z CLI

Issues można też zarządzać przez ARC CLI:

arc issues                         # lista otwartych issues
arc issue create --title "Bug..." # utwórz nowe issue
arc issue log <id> "Naprawiono X" # dodaj wpis logu aktywności

8. Wiki

Strona Wiki to baza wiedzy projektu.

Funkcje

9. Graf Wiedzy

Strona Graf wizualizuje relacje między encjami projektu (issues, strony wiki, skille, fazy roadmap) jako interaktywny graf węzłów.

10. Ewolucja Skilów

Strona Ewolucja Skilów (zwana "Skille" w pasku bocznym projektu, "Rejestr Skilów" w globalnym pasku) udostępnia zaawansowane zarządzanie skilami.

Układ Dwupanelowy

Sage Worker

Sage to analizator skilów oparty na AI:

Forki Skilów

Forkuj globalny skill, żeby dostosować go do konkretnego projektu. Fork śledzi skill nadrzędny i może pobierać aktualizacje.

11. Roadmap

Strona Roadmap pokazuje plan rozwoju projektu podzielony na fazy.

12. Raporty

Strona Raporty pokazuje analitykę i raporty sesji.

13. Analityka

Strona Analityka (widok globalny) pokazuje ogólnosystemowy stan i metryki:

14. NotebookLM — Pamięć Neuronalna

Jeśli projekt ma połączone notebooki NotebookLM, pojawiają się one w stopce paska bocznego pod "Pamięć Neuronalna":

Globalna strona NotebookLM pokazuje wszystkie połączone notebooki we wszystkich projektach.

15. Cloud PM — Czat Projektu

Cloud PM to trwały czat projektu dostępny z Workspace:

16. Ustawienia Projektu

Strona Ustawienia Projektu (dostępna przez przycisk Ustawienia w pasku bocznym) udostępnia:

17. Integracja z Telegram

Bot Telegram to alternatywny interfejs komend. Wszystkie funkcje CRM Dashboard są też dostępne przez Telegram.

Komendy Master Bot

Komenda Opis
/status Przegląd systemu (stan wszystkich projektów)
/list Lista wszystkich zarejestrowanych projektów
/health Szczegółowe sprawdzenie stanu wszystkich botów
/watchdog Status watchdog i monitorowanie Child Botów
/new_project <name> Interaktywny kreator tworzenia projektu
/deploy Deploy aktualizacji na VPS
/emergency_stop Natychmiast zatrzymaj wszystkie Child Boty

Komendy Child Bot

Komenda Opis
/ping Sprawdzenie stanu bota
/thread Rozmiar historii wątku
/quality Raport metryk jakości skilów
/learnings Przeglądaj zakumulowane reguły korekcji
/specs Przeglądaj oczekujące specyfikacje
/approve <id> Zatwierdź specyfikację
/reject <id> [reason] Odrzuć specyfikację

Routing Wiadomości

Prefiks Kieruje do
/c <wiadomość> Worker Consultant
/d <wiadomość> Worker Developer
/w:<worker_id> <wiadomość> Niestandardowy worker po ID
(bez prefiksu) Aktywna rola (domyślnie: consultant)

Boty Telegram Per Worker

Każdy worker może mieć własny token bota Telegram (skonfigurowany w Worker Studio). Gdy worker ma własnego bota:

Przyciski Inline

Po każdej odpowiedzi bota pojawiają się przyciski inline:

18. Motyw i Ustawienia

Tryb Ciemny/Jasny

Kliknij przełącznik motywu w górnym nagłówku, żeby przełączać między jasnym a ciemnym motywem. Preferencja zapisywana w localStorage.

Ustawienia Konta

Kliknij awatar → Ustawienia Konta, żeby skonfigurować:

System Kolorów

Pulpit używa niestandardowych właściwości CSS dla spójnego motywowania:

Kolory Statusu

Kolor Znaczenie
Zielony Zdrowy / Sukces / Online
Żółty/Pomarańczowy Zdegradowany / Ostrzeżenie / Przetwarzanie
Czerwony Niedostępny / Błąd / Niepowodzenie
Fioletowy Myślenie / Szkic specyfikacji
Niebieski Wykonywanie / Aktywny

19. Skróty Klawiaturowe

Skrót Kontekst Akcja
Enter Pole wpisywania wiadomości Wyślij wiadomość
Shift+Enter Pole tekstowe czatu Nowa linia
Escape Dowolny modal Zamknij modal/nakładkę
Prawy przycisk myszy Przeglądarka plików Menu kontekstowe

20. Rozwiązywanie Problemów

"Utracono połączenie" / Czerwony wskaźnik

Pulpit utracił połączenie z serwerem. Sprawdź:

  1. Czy VPS działa? (ssh na serwer, sprawdź tmux ls)
  2. Czy nginx działa? (systemctl status nginx)
  3. Czy Master Bot działa? (curl http://<server>:19210/api/master/health)

"Unauthorized" / Pętla logowania

Twój token JWT wygasł (TTL 24h). Zaloguj się ponownie emailem/hasłem lub OAuth.

Panel Workera Nie Wyświetla Outputu

  1. Sprawdź, czy strumień SSE jest połączony (DevTools przeglądarki → Sieć → filtruj po EventStream)
  2. Worker mógł jeszcze nie wyprodukować outputu — najpierw wyślij wiadomość
  3. Spróbuj odświeżyć stronę (F5)

Przesyłanie Pliku Nie Działa

Bot Nie Odpowiada w Telegram

  1. Sprawdź stan bota: wyślij /ping
  2. Jeśli brak odpowiedzi, SSH na VPS i sprawdź tmux: tmux attach -t citadel-child
  3. Sprawdź logi: tail -50 /var/log/citadel/<project>/system-$(date +%Y-%m-%d).log
  4. Zrestartuj przez CRM: Ustawienia Projektu → Restart Bot, lub /deploy w Master Bot

Błędy CORS w Konsoli Przeglądarki

Domena pulpitu musi być w CRM_ALLOWED_ORIGINS. Domyślnie dozwolone:

invite_required 403 przy rejestracji (Phase 52.1)

Rejestracja publiczna jest ogrodzona. Albo:

plan_limit_reached 402 przy tworzeniu projektu/workera (Phase 51)

Twoje konto osiągnęło limit poziomu:

Uaktualnij przez Ustawienia → Billing (UI Stage 3 w trakcie). Na razie skontaktuj się z CEO.

21. Timeline (Phase 47)

Strona obserwabilności w stylu DAW, która pozwala odtwarzać sesję workera jak konsolę mikserską.

sequenceDiagram
    participant U as Ty
    participant W as Workspace
    participant T as Timeline
    participant DB as tabela timeline_events

    U->>W: wyślij wiadomość do Workera A
    W->>DB: dodaj zdarzenia (myśl · narzędzie · odpowiedź)
    U->>T: otwórz stronę Timeline
    T->>DB: zapytaj o zdarzenia pogrupowane po workerze
    T-->>U: renderuj tory + głowicę
    U->>T: przesuń głowicę / wycisz/solo tory

Funkcje

Kiedy Używać

22. Kredyty Próbne i Billing (Phases 50-51)

Arc OS używa API Anthropic w twoim imieniu dla workerów czatu/terminala. Bazowa platforma jest bezpłatna, ale koszty tokenów są przenoszone na twoje konto.

Kredyty Próbne (Phase 50)

Stripe Billing (Phase 51 — Stage 1 live, UI Stage 3 oczekujące)

Plan Cena Projekty Workerzy
Free $0 1 5
Min $4.99/mies. 5 LUB 25 (semantyka OR) semantyka OR
Max $11.99/mies. 20 LUB 150 semantyka OR
Beta ręcznie Nieskończoność Nieskończoność

Limity semantyki OR: "5 LUB 25" oznacza że możesz mieć ≤5 projektów LUB ≤25 workerów we wszystkich projektach — co osiągniesz pierwsze.

Używanie Własnego Klucza

Jeśli wolisz płacić Anthropic bezpośrednio:

  1. Zdobądź klucz API Anthropic z https://console.anthropic.com
  2. Ustawienia Konta → Klucze API → wklej klucz
  3. Lub użyj Local Bridge CLI, żeby uruchamiać workerów na własnej maszynie za darmo

Endpoint Statusu

GET /api/crm/billing/status zwraca:

23. Dostęp Beta — Kody Zaproszenia (Phase 52.1)

Arc OS jest w becie Friends & Family. Rejestracja publiczna jest zamknięta do czasu walidacji kryteriów sukcesu F&F.

Jak Zdobyć Zaproszenie

Format Kodu

arc-XXXX-XXXX — prefiks arc- + 8 znaków hex w dwóch grupach oddzielonych myślnikiem (pochodna crypto.randomBytes).

Używanie Kodu

  1. Przejdź do formularza rejestracji
  2. Wklej kod w pole Kod Zaproszenia (monospacjalne pole, walidacja po stronie klienta)
  3. Kod jest jednorazowo konsumowany przy udanej rejestracji — jeden kod per konto
  4. Jeśli kod jest już użyty lub unieważniony: 403 invite_required z linkiem do kanału feedback

Korzyści Founding Member

Admin: generowanie i unieważnianie kodów (tylko CEO)

arc invites generate --count 5            # wygeneruj 5 nowych kodów
arc invites list                          # pokaż aktywne kody + kto ich użył
arc invites revoke arc-AAAA-BBBB          # unieważnij wyciekły kod

Odpowiedniki REST: POST/GET/DELETE /api/crm/admin/invites (wymagana rola admin).

Utrzymywane przez Zespół Arc OS. Aktualizowane po każdym ukończeniu fazy.