Co to jest Gluon v2?

Gluon v2 to zaawansowane narzędzie łączące Twoje lokalne projekty programistyczne z modelami AI takimi jak Claude, Gemini i AI Studio. W przeciwieństwie do tradycyjnych agentów AI, Gluon daje Ci pełną kontrolę nad kontekstem przekazywanym do modelu - wybierasz dokładnie które pliki, prompty systemowe i instrukcje mają być uwzględnione.

Architektura: Dwa Komponenty

Dlaczego Gluon?

• Precyzyjny kontekst: Wybierasz dokładnie które pliki trafiają do AI - żadnego automatycznego "dumpu" całego repozytorium.
• Oszczędność tokenów: Mniejszy kontekst = niższe koszty API i szybsze odpowiedzi.
• Kontrola nad AI: Używasz własnych promptów systemowych i instrukcji - AI zachowuje się dokładnie tak, jak chcesz.
• Multi-projekt: Pracuj z wieloma projektami jednocześnie, bez przełączania kontekstu.

🖥️ Aplikacja Desktopowa

Aplikacja desktopowa to "silnik" Gluon - działa w tle na systemie Windows i zarządza wszystkimi projektami, plikami oraz komunikacją z rozszerzeniem Chrome.

📄 Licencja i Aktualizacje

Gluon v2 to produkt z jednorazowym zakupem - bez subskrypcji. Po zakupie otrzymujesz:

• ✅ Dożywotni dostęp do aplikacji desktopowej i rozszerzenia Chrome
• ✅ Wszystkie przyszłe aktualizacje (bezpłatnie)
• ✅ Wsparcie techniczne poprzez Discord
• ✅ 30-dniową gwarancję zwrotu pieniędzy

➕ Dodawanie Projektu

Aby rozpocząć pracę z Gluon, musisz dodać co najmniej jeden projekt w aplikacji desktopowej. Projekt to folder zawierający kod, który chcesz udostępnić dla AI.

Krok po kroku:

1. Otwórz aplikację desktopową Gluon v2
2. Przejdź do zakładki "Projects"
3. Kliknij przycisk "Add Project" lub "+" (jeśli nie masz jeszcze żadnego projektu)
4. Wybierz folder główny projektu (np. C:\Users\YourName\Projects\my-app)
5. Projekt pojawi się na liście i będzie dostępny w rozszerzeniu Chrome

⚙️ Ustawienia Projektu

Po dodaniu projektu możesz skonfigurować, które pliki i foldery mają być uwzględniane w kontekście AI. To kluczowa funkcja pozwalająca zredukować "szum" i skupić AI na tym co naprawdę ważne.

🚫 Wykluczenia (Exclusions)

Wykluczenia pozwalają na pominięcie całych folderów podczas skanowania projektu. Typowe wykluczenia to:

• node_modules - zależności npm/yarn (zazwyczaj tysiące plików)
• .git - historia repozytorium Git
• build, dist, target - artefakty budowania
• venv, .venv - wirtualne środowiska Python
• __pycache__, .pytest_cache - cache Python

📋 Dozwolone Rozszerzenia

Możesz określić whitelist rozszerzeń plików, które mają być widoczne w drzewie plików. Jeśli lista jest pusta, wszystkie pliki (poza wykluczeniami) będą widoczne.

Przykładowe konfiguracje:

🌍 Środowiska i Prompty Systemowe

Środowisko (Environment) to predefiniowany zestaw promptów systemowych, który określa "osobowość" i zachowanie AI. Możesz tworzyć różne środowiska dla różnych typów zadań.

Domyślne środowiska:

🧩 Rozszerzenie Chrome

Rozszerzenie Chrome to interfejs użytkownika Gluon - panel boczny w przeglądarce umożliwiający interakcję z projektami, wybór plików i bezpośrednią komunikację z AI. Rozszerzenie łączy się z aplikacją desktopową przez WebSocket i działa w serwisach Claude.ai, Gemini oraz AI Studio.

📁 Selektor Projektów

Selektor projektów znajduje się na górze panelu bocznego i umożliwia przełączanie między projektami dodanymi w aplikacji desktopowej.

Jak używać:

1. Kliknij dropdown "Select Project"
2. Wybierz projekt z listy (wyświetlana jest nazwa folderu)
3. Drzewo plików automatycznie załaduje strukturę wybranego projektu
4. Wszystkie funkcje (Auto Select, Context Save) będą działać w kontekście tego projektu

🌐 Wybór Środowiska

Środowisko definiuje, jak AI będzie się zachowywać - określa prompty systemowe, które będą automatycznie dołączane do każdej konwersacji.

Jak to działa:

• Wybór środowiska: Kliknij dropdown i wybierz środowisko (np. "Frontend Specialist")
• Automatyczne prompty: Wszystkie prompty systemowe z tego środowiska zostaną dołączone na początku konwersacji
• Zmiana środowiska: Możesz zmienić środowisko w każdej chwili - nowe prompty będą użyte w następnej konwersacji

⚡ Quick Task

Quick Task to pole tekstowe do szybkiego wprowadzania instrukcji dla AI. To Twój główny sposób komunikacji z modelem - tutaj wpisujesz zadania, pytania i komendy.

Co się dzieje po wysłaniu zadania:

1. Tekst z Quick Task jest łączony z wybranymi plikami z drzewa
2. Dodawane są prompty systemowe z wybranego środowiska
3. Całość jest wklejana do pola input w Claude/Gemini/AI Studio
4. Możesz jeszcze edytować wklejony tekst przed wysłaniem do AI

🌳 Drzewo Plików

Drzewo plików wyświetla strukturę wybranego projektu i pozwala na precyzyjne wybieranie plików do dołączenia do kontekstu AI. To jedna z najważniejszych funkcji Gluon - decydujesz dokładnie co AI "widzi".

Funkcje drzewa plików:

• Multi-select: Zaznacz wiele plików jednocześnie (Ctrl+Click, Shift+Click)
• Expand/collapse: Rozwijaj i zwijaj foldery klikając strzałkę
• Ikony typów plików: Różne ikony dla .js, .py, .json, etc.
• Licznik: Na dole widoczna liczba zaznaczonych plików
• Clear selection: Przycisk do odznaczenia wszystkich plików

💾 Zapisane Konteksty (Context Saves)

Context Save to zapisany "snapshot" zaznaczonych plików i konfiguracji. Możesz szybko wczytać wcześniej zapisany kontekst zamiast ponownie zaznaczać te same pliki.

Kiedy używać Context Saves:

• Powtarzające się zadania: "Frontend Forms", "API Endpoints", "Authentication Flow"
• Code review: Zapisz zestaw plików do review przed każdym merge'm
• Onboarding: Przygotuj context saves dla nowych członków zespołu - "Project Overview", "Core Architecture"
• Debugging: "Payment System Bug" z wszystkimi powiązanymi plikami

Jak utworzyć Context Save:

1. Zaznacz pliki w drzewie plików
2. Kliknij "Save Context" w sekcji funkcji
3. Podaj nazwę (np. "User Profile Module")
4. Context Save pojawi się w sekcji "Saved Contexts"
5. Kliknij nazwę aby wczytać - pliki zostaną automatycznie zaznaczone

⭐ Funkcje Kluczowe

Gluon oferuje trzy zaawansowane funkcje, które automatyzują i usprawniają pracę z AI. Każda z nich rozwiązuje konkretny problem w workflow programistycznym.

🎯 Auto Select

Czym jest Auto Select?

Auto Select to funkcja automatycznego wyboru plików na podstawie Twojego zadania. Wpisujesz zadanie (np. "napraw błąd w loginie"), a AI analizuje wszystkie pliki w projekcie i automatycznie zaznacza te, które są najbardziej istotne dla tego konkretnego zadania.

Dlaczego używać Auto Select?

Jak używać Auto Select?

1. Upewnij się, że masz wybrany projekt
2. W sekcji "Features" kliknij "Auto Select"
3. W oknie dialogowym wpisz opis zadania - bądź jak najbardziej konkretny
4. Kliknij "Analyze" - AI przeanalizuje wszystkie pliki w projekcie
5. Po chwili zobaczysz automatycznie zaznaczone pliki w drzewie
6. Możesz ręcznie dodać lub usunąć pliki przed wysłaniem do AI

Przykład

📋 Context Save (Funkcja)

Czym jest Context Save?

Context Save to zaawansowana funkcja współpracy z AI w trybie wieloetapowym. Pozwala AI "zapamiętać" kontekst poprzedniej odpowiedzi i przekazać go automatycznie do następnego promptu - eliminując konieczność kopiowania długich fragmentów kodu między konwersacjami.

Dlaczego używać Context Save?

Jak używać Context Save?

1. W Quick Task zaznacz checkbox "Context Save"
2. Wyślij zadanie do AI normalnie (np. "napisz funkcję do parsowania JSON")
3. AI w odpowiedzi dołączy specjalny znacznik @gluon:response z kodem
4. Gluon automatycznie zapisze tę odpowiedź jako Context Save
5. W następnym zadaniu napisz: "dodaj error handling do poprzedniej funkcji"
6. Gluon automatycznie dołączy zapisany kontekst - AI będzie wiedziało o której funkcji mówisz

Przykład przepływu pracy

✍️ Prompt Generator

Czym jest Prompt Generator?

Prompt Generator to najbardziej zaawansowana funkcja Gluon - pozwala AI wygenerować strukturyzowaną odpowiedź w formacie JSON, która zawiera nie tylko kod, ale też pliki do aktualizacji, reasoning (wyjaśnienie myślenia AI) i opcjonalny "handoff" (przekazanie kontekstu do następnego zadania).

Dlaczego używać Prompt Generator?

Jak używać Prompt Generator?

1. W Quick Task zaznacz checkbox "Prompt Generator"
2. Wybierz typ szablonu (auto_select, context_handoff, lub prompt_handoff)
3. Wyślij zadanie - Gluon dołączy specjalny prompt instruujący AI jak formatować odpowiedź
4. AI wygeneruje odpowiedź w formacie JSON ze znacznikami @gluon:*
5. Gluon automatycznie wyświetli strukturyzowaną odpowiedź w czytelnej formie
6. Możesz skopiować kod, zobaczyć reasoning, lub kontynuować z handoff

Przykład odpowiedzi Prompt Generator

Co się stało w powyższym przykładzie:

• @gluon:reasoning: AI wyjaśniło dlaczego użyło Hooks i client-side pagination
• @gluon:files: Lista plików które trzeba utworzyć/zmodyfikować
• @gluon:response: Pełny kod komponentu
• @gluon:handoff: Sugestie co zrobić dalej (sorting, testy, filtrowanie)

📝 Szablony (Templates)

Szablony to predefiniowane struktury promptów, które instruują AI jak sformatować odpowiedź. Gdy używasz funkcji Prompt Generator, Gluon automatycznie dołącza odpowiedni szablon do Twojego zadania, dzięki czemu AI wie jakich znaczników używać.

🏗️ Struktura Szablonu

Każdy szablon definiuje jakie znaczniki (tags) AI powinno użyć w odpowiedzi. Znaczniki zaczynają się od @gluon: i określają różne sekcje odpowiedzi - kod, pliki, reasoning, handoff.

Trzy główne typy szablonów:

🔧 Pola JSON (Znaczniki @gluon:*)

🔍 Pola Wewnętrzne @gluon:handoff

Pole @gluon:handoff zawiera strukturę JSON z dodatkowymi polami, które różnią się w zależności od typu szablonu. Poniżej szczegółowy opis każdego pola.

📋 Pola dla Context Save:

✍️ Pola dla Prompt Generator:

💡 Przykłady Użycia Szablonów

Poniżej przedstawiamy praktyczne przykłady użycia różnych szablonów w rzeczywistych scenariuszach.

{
    "@gluon:response": "auto_select",
    "@gluon:reasoning": "Analizując zadanie zidentyfikowałem 4 kluczowe pliki: 
        PaymentProcessor obsługuje logikę płatności, AmountValidator waliduje kwoty, 
        paymentGateway integruje z zewnętrznym API, paymentLimits zawiera 
        konfigurację limitów.",
    "@gluon:files": {
        "@gluon:payment_system": [
            "src/payment/PaymentProcessor.js",
            "src/validation/AmountValidator.js",
            "src/api/paymentGateway.js",
            "src/config/paymentLimits.js"
            ]
    }
}

{
    "@gluon:response": "context_handoff",
    "@gluon:handoff": {
        "summary": "Zaimplementowano UI layer systemu notyfikacji. 
                NotificationCenter + NotificationItem działają z mock data.",
        "solved_problems": [
            "Problem: Jak zarządzać stanem wielu notyfikacji | Solution: useReducer 
                z actions (add, markRead, delete) | Files: useNotifications.js | 
                Rationale: Reducer pattern dla złożonego state"
            ],
        "current_problem": "UI gotowe, ale brak integracji z backend. 
            Następny krok: API endpoints.",
                "key_insights": "Component używa compound pattern. Wszystkie mutations 
            przez reducer. CSS modules dla izolacji stylów."
    },
    "@gluon:reasoning": "Używam compound component pattern - NotificationCenter 
        jako kontener, NotificationItem jako element listy. State management przez 
        useReducer dla złożonej logiki (mark as read, delete, filter).",
        "@gluon:files": {
            "@gluon:notification_project": [
            "src/components/NotificationCenter.jsx",
            "src/components/NotificationItem.jsx",
            "src/components/NotificationCenter.module.css",
            "src/hooks/useNotifications.js",
            "src/types/Notification.ts"
            ]
    }
}

{
    "@gluon:response": "prompt_handoff",
    "@gluon:handoff": {
        "task_description": "Funkcja utility formatCurrency do formatowania 
            kwot w PLN z separatorami tysięcy dla lepszej czytelności w UI.",
        "implementation_steps": [
            "Krok 1: Utwórz plik src/utils/currency.js",
            "Krok 2: Zaimplementuj formatCurrency używając Intl.NumberFormat",
            "Krok 3: Dodaj unit testy w src/utils/__tests__/currency.test.js"
            ],
        "technologies": "Intl.NumberFormat (native JS API) - zero dependencies",
        "architecture": "Pure function, brak side effects. Input: number, 
            Output: string. Używa native Intl API dla i18n support.",
        "code_context": "Function będzie używana w komponentach: ProductCard, 
            OrderSummary, InvoiceView"
            },
    "@gluon:reasoning": "Używam Intl.NumberFormat bo jest native, zero 
        dependencies, automatyczne formatowanie dla różnych locales.",
    "@gluon:files": {
        "@gluon:app": [
        "src/utils/currency.js"
        ]
    }
}