Alokacja zasobów i wydajność
Speedwave uruchamia Claude Code oraz workery integracji w odrębnych środowiskach kontenerowych, regulując zużycie pamięci RAM i czasu procesora za pomocą precyzyjnych limitów zasobowych.
Weryfikacja parametrów sprzętowych
Dział zatytułowany „Weryfikacja parametrów sprzętowych”- Upewnij się, że stacja robocza posiada co najmniej 16 GiB fizycznej pamięci RAM. W systemie macOS Speedwave sprawdza dostępność pamięci przy starcie i wyświetla ostrzeżenie diagnostyczne w przypadku małych zasobów.
- Zapoznaj się z poniższymi tabelami limitów pamięci i CPU, aby zaplanować obciążenie przy wielu aktywnych integracjach.
Limity zasobów wynikają z architektury bezpieczeństwa aplikacji i nie podlegają modyfikacji w pliku config.json. Ewentualne ręczne zmiany w plikach compose wchodzą w życie dopiero po zrestartowaniu kontenerów.
Limity pamięci w poszczególnych kontenerach
Dział zatytułowany „Limity pamięci w poszczególnych kontenerach”Wartości limitów pamięci stanowią górne ograniczenie (ceiling), a nie stałą rezerwację: bezczynny kontener zużywa znikome ilości pamięci niezależnie od przyznanego limitu.
| Kontener | Limit pamięci |
|---|---|
| Środowisko Claude Code | 6 GiB |
| Tool Gateway (Hub MCP) | 512 MiB |
| Proxy LLM | 128 MiB |
| Standardowe workery (Slack, GitLab, SharePoint) | 128 MiB |
| Worker GitHub | 256 MiB |
| Worker dokumentów Office | 1 GiB |
| Worker przeglądarki Playwright | 2 GiB (oraz 2 GiB pamięci współdzielonej /dev/shm) |
Wybrane workery otrzymują zwiększone limity, aby sprostać wymagającym zadaniom:
- Worker GitHub (256 MiB): Umożliwia buforowanie dużych struktur JSON przy analizie złożonych repozytoriów.
- Worker Office (1 GiB): Obsługuje silnik konwersji dokumentów w tle.
- Worker Playwright (2 GiB): Zarządza pulą procesów Chromium w trybie headless.
Limity kontenerów obowiązują wyłącznie przy aktywnych integracjach. Teoretyczna suma limitów może przewyższać pamięć maszyny wirtualnej, ponieważ większość procesów działa znacznie poniżej swoich progów maksymalnych.
Przydział czasu procesora (CPU)
Dział zatytułowany „Przydział czasu procesora (CPU)”Limity CPU określają proporcje czasu procesora we wspólnej puli wątków, chroniąc środowisko przed wyczerpaniem zasobów przez pojedynczy kontener:
| Kontener | Przydział CPU |
|---|---|
| Środowisko Claude Code | Do 2 rdzeni CPU |
| Worker przeglądarki Playwright | Do 2 rdzeni CPU |
| Tool Gateway (Hub MCP) | Do 1 rdzenia CPU |
| Worker dokumentów Office | Do 1 rdzenia CPU |
| Proxy LLM | Do 0,5 rdzenia CPU |
| Standardowe workery integracji | Do 0,5 rdzenia CPU |
Rozmiar i skalowanie maszyny wirtualnej
Dział zatytułowany „Rozmiar i skalowanie maszyny wirtualnej”W systemie macOS Speedwave tworzy maszynę wirtualną Lima dopasowaną do specyfikacji sprzętowej: przydziela połowę fizycznej pamięci RAM (od 8 GiB do 32 GiB) oraz połowę dostępnych rdzeni CPU (od 4 do 8):
| Parametry hosta | Pamięć RAM maszyny VM | vCPU maszyny VM |
|---|---|---|
| 16 GiB RAM / 8 rdzeni | 8 GiB | 4 |
| 32 GiB RAM / 16 rdzeni | 16 GiB | 8 |
| 64 GiB RAM / 24 rdzenie | 32 GiB | 8 |
Pamięć przydzielona maszynie wirtualnej pozostaje zaalokowana przez cały czas jej działania zgodnie ze specyfikacją Apple Virtualization Framework, a jej zwrot do systemu macOS następuje po zatrzymaniu maszyny wirtualnej.
W systemie Windows środowisko WSL2 zarządza pamięcią dynamicznie (domyślnie przydzielając 50% pamięci hosta). Limity kontenerów są egzekwowane w ramach tej puli.
Synchronizacja strefy czasowej
Dział zatytułowany „Synchronizacja strefy czasowej”Speedwave automatycznie wykrywa strefę czasową hosta i przekazuje ją do wnętrza kontenerów, dzięki czemu znaczniki czasu w komunikatach Claude odzwierciedlają czas lokalny (w razie niepowodzenia domyślnie przyjmowany jest czas UTC).
Wskazówki dotyczące wstępnej instalacji znajdziesz w rozdziale Instalacja Speedwave.