Context7

Integracja z platformą Context7 dostarcza Speedwave aktualną, autorytatywną dokumentację techniczną dla bibliotek programistycznych, frameworków i specyfikacji API, eliminując ryzyko posługiwania się nieaktualnymi założeniami modelu. Usługa działa od razu po włączeniu w trybie anonimowym, bez konieczności dodatkowej konfiguracji.

Architektura i model wykonawczy

Context7 działa w odizolowanym kontenerze workera, który komunikuje się z adresem https://context7.com/api/v2. Domyślnie worker operuje bez poświadczeń. Jeśli zostanie skonfigurowany opcjonalny klucz API, jest on zapisywany w ~/.speedwave/tokens/<projekt>/context7/api_key i montowany do kontenera workera w trybie tylko do odczytu pod ścieżką /tokens/api_key.

Pobieranie dokumentacji realizowane jest w dwóch etapach:

1. resolveLibraryId: Przyjmuje nazwę docelowej biblioteki (np. “react” lub “spring-boot”) oraz pytanie użytkownika, zwracając uporządkowaną listę dopasowanych identyfikatorów bibliotek.
2. queryDocs: Pobiera relewantne sekcje dokumentacji dla wybranego identyfikatora w ramach zadeklarowanego budżetu tokenów (domyślnie 5000, ograniczany do zakresu od 500 do 15 000 tokenów).

Wyszukiwanie anonimowe podlega limitowi około 200 zapytań dziennie na dany adres IP. Podanie klucza API Context7 (z prefiksem ctx7sk_) zwiększa dostępne limity. Błędy serwera zewnętrznego (5xx) wyzwalają wewnątrz workera automatyczne ponawianie zapytań z wykładniczym czasem oczekiwania (exponential backoff).

Zestawienie narzędzi

Narzędzie	Zakres działania
resolveLibraryId	Mapuje nazwy pakietów lub frameworków podane w języku naturalnym na identyfikatory bibliotek zgodne z Context7.
queryDocs	Pobiera wybrane fragmenty dokumentacji dla zidentyfikowanej biblioteki na podstawie parametrów zapytania.

Oba narzędzia działają wyłącznie w trybie odczytu i nie modyfikują plików w repozytorium projektu.

Konfiguracja

1. Otwórz projekt w aplikacji Desktop i włącz przełącznik Context7. Integracja działa natychmiast w trybie anonimowym.
2. (Opcjonalnie) Wygeneruj klucz API w panelu context7.com/dashboard i wklej go w ustawieniach integracji, aby odblokować wyższe limity zapytań.

Ogólne zasady zarządzania integracjami opisano w przewodniku Podłączanie integracji.

Bezpieczeństwo i transfer danych

Zapytania do Context7 przesyłają do API Context7 wyłącznie treść szukanego hasła oraz nazwę docelowej biblioteki. Żaden prywatny kod źródłowy, pliki projektu ani poświadczenia innych usług nie opuszczają lokalnego środowiska. Szczegóły dotyczące izolacji poświadczeń i prywatności znajdziesz w rozdziałach Zarządzanie poświadczeniami oraz Dane i prywatność.