Podręcznik Użytkownika: Fabryka Lekcji v5.3

Czym jest to narzędzie?

To program, który zamienia Twoje materiały lekcyjne (PDF, Word, notatki) w interaktywną grę dla uczniów. Gra działa w przeglądarce internetowej, nie wymaga logowania ani instalowania aplikacji.

Cały system składa się z dwóch plików:

GENERATOR (generator.html) – To Twoje centrum dowodzenia. Tu tworzysz grę. Tego pliku nie dajesz uczniom.
GRA (Gra_Temat.html) – To plik wynikowy, który tworzy generator. Ten plik wysyłasz uczniom.

CZĘŚĆ 1: Klucze do „Mózgu” (API)

Aby program mógł układać pytania i oceniać uczniów, musi połączyć się ze Sztuczną Inteligencją. Potrzebujesz do tego specjalnego hasła zwanego Kluczem API.

Możesz wybrać opcję darmową (Google) lub płatną/tanią (DeepSeek).

OPCJA A: Google Gemini (Darmowa, Polecana na start)

Wejdź na stronę: aistudio.google.com
Zaloguj się swoim kontem Google (Gmail).
Wskazówka: Najlepiej użyj do tego celu nowego, osobnego konta Google, założonego specjalnie dla tej aplikacji.
Kliknij niebieski przycisk "Get API key" (po lewej stronie lub na środku).
Kliknij "Create API key" (Stwórz klucz API).
System może zapytać o projekt – wybierz "Create API key in new project".
Pojawi się długi ciąg znaków (np. AIzaSyD...). Skopiuj go i zapisz w bezpiecznym miejscu (np. w notatniku).
- Koszt: 0 zł.
- Limity: Bardzo duże, wystarczą na każdą lekcję.

OPCJA B: DeepSeek (Płatna, Wyższa inteligencja)

Użyj tej opcji, jeśli zależy Ci na bardzo precyzyjnym sprawdzaniu zadań otwartych ("Sędzia").

Wejdź na stronę: platform.deepseek.com
Zarejestruj się (możesz użyć konta Google).
Wejdź w zakładkę "Top up" (Doładowanie - ikonka portfela).
Wpłać np. 2 USD lub 5 USD (ok. 10-20 zł).
- UWAGA PRZY PŁATNOŚCI: Jeśli formularz nie przyjmuje Twojego numeru telefonu/kodu pocztowego, zmień flagę kraju (prefix) z USA (+1) na Poland (+48). Wtedy błąd zniknie.
Po wpłacie wejdź w zakładkę "API Keys".
Kliknij "Create API Key".
Ważne: Skopiuj klucz (sk-...) od razu! System pokazuje go tylko raz.

CZĘŚĆ 2: Uruchomienie Generatora

Skoro masz już kod (ten długi tekst HTML, który przygotowaliśmy wcześniej), musisz zrobić z niego działający program.

Otwórz systemowy Notatnik (Windows) lub TextEdit (Mac).
Wklej do niego cały kod wersji v5.3.
Wybierz w menu: Plik -> Zapisz jako...
W polu "Nazwa pliku" wpisz: generator.html (końcówka .html jest kluczowa!).
W polu "Kodowanie" (na dole okienka) wybierz: UTF-8 (żeby były polskie znaki).
Kliknij Zapisz.
Na pulpicie pojawi się plik z ikoną Twojej przeglądarki (Chrome/Edge). Kliknij go dwa razy.
Gotowe! Widzisz panel sterowania.

CZĘŚĆ 3: Tworzenie Gry (Krok po kroku)

Otwórz swój plik generator.html.

1 Wybór Silnika i Klucz

Na górze wybierz z listy model:
- Dla darmowej pracy wybierz: Google Gemini.
- Dla super-precyzji wybierz: DeepSeek.
Wklej odpowiedni Klucz API w polu poniżej.

2 Wczytanie Materiału

Kliknij pomarańczowy przycisk "Dodaj pliki".
Wybierz z dysku pliki PDF, Word lub tekstowe (maksymalnie 3 sztuki).
Program przetworzy je na tekst. Zobaczysz nazwy plików na liście.
- Nowość: Obok nazwy pliku zobaczysz liczbę znaków.
- Błąd? Jeśli wgrałeś zły plik, kliknij czerwony krzyżyk (X) obok niego, aby go usunąć.

3 Konfiguracja Gry

Temat Lekcji: Wpisz tytuł (np. "Bitwa pod Grunwaldem").
Wybór Zadań: Masz listę gier (Milionerzy, Sędzia, Detektyw itd.).
- Zaznacz "ptaszkiem", które gry chcesz mieć.
- W polu obok wpisz liczbę pytań (np. wpisz 5 przy Milionerach, a 0 przy Wisielcu, jeśli go nie chcesz).
Osobowość Sędziego: Wybierz, w jakim stylu AI ma oceniać uczniów (np. "Wyrozumiały Mentor" lub "Surowy Egzaminator").

4 Wygląd Gry (Nowość!)

Możesz zmienić szatę graficzną, aby dopasować ją do tematu lekcji.
Gotowe style: Wybierz z listy motyw, np. "Cyberpunk" (Informatyka), "Stary Pergamin" (Historia) czy "Mroczny Detektyw".
✨ AI Designer (Własny styl):
- Wybierz opcję "Własny (Opisz styl)" na końcu listy.
- W polu tekstowym opisz klimat, np. "Starożytny Egipt, złoto i piasek" lub "Laboratorium chemiczne, neonowa zieleń".
- Sztuczna Inteligencja sama dobierze kolory gry do Twojego opisu!

5 Generowanie

Kliknij duży, zielony przycisk GENERUJ GRĘ.
Poczekaj. Może to potrwać od 10 do 60 sekund.
Gdy skończy, na dole pojawi się zielony pasek.

6 Pobieranie

Kliknij przycisk POBIERZ na zielonym pasku.
Na Twój komputer pobierze się nowy plik, np. Gra_Bitwa_pod_Grunwaldem.html.

CZĘŚĆ 4: Jak grać?

To jest najważniejszy moment. Masz plik Gra_... .html.

Sprawdź sam: Kliknij ten plik dwa razy. Gra otworzy się w przeglądarce. Zobaczysz kolory i style, które wybrałeś w generatorze.
Wyślij uczniom:
- Możesz wysłać ten plik przez Teams / Librus / Vulcan.
- Możesz wysłać go mailem.
- Uczeń musi go pobrać i otworzyć na swoim komputerze lub telefonie.
Wymagania:
- Uczeń musi mieć internet (gra łączy się z AI, by sprawdzać odpowiedzi).
- Uczeń nie musi mieć żadnego konta ani klucza. Twój klucz jest "zaszyty" w środku tego pliku.

Rozwiązywanie problemów (FAQ)

Q: Jak mam opisać własną szatę graficzną gry?

Kontekst: "AI Designer" wbudowany w generator to inteligentny mechanizm, który potrafi zamienić Twój opis słowny na konkretne kody kolorów (HEX).

Wskazówki (Co wpisać?):

Określ Tło: np. "ciemne", "jasne", "drewniane", "kosmiczne".
Określ Kolor wiodący: np. "złoty", "neonowy róż", "militarna zieleń".
Określ Nastrój: np. "mroczny", "wesoły", "sterylny", "stary".

Przykłady łączenia tematów:

Historia: "Stary pergamin, brązowy atrament, klimat średniowiecza."
Biologia: "Las równikowy, dużo zieleni, organiczne kształty, brąz."
Informatyka: "Matrix, czarne tło, spadające zielone znaki, czcionka komputerowa."

Wzorcowy Prompt:

Klimat: Stacja Kosmiczna.
Tło: Głęboki granat, prawie czarny (#0b0c10).
Elementy: Szare, metaliczne panele z niebieskimi, świecącymi obramowaniami.
Tekst: Biały, wyraźny. Akcenty: Ostrzegawczy pomarańczowy.
Styl nowoczesny i techniczny.

Q: Czy warto płacić te 5 USD za DeepSeek? Na ile to wystarczy?

A: Zdecydowanie warto. DeepSeek V3 jest niezwykle tani i precyzyjny.

Wpłacone 5 USD (ok. 20 zł) wystarczy Ci orientacyjnie na:

Wygenerowanie ok. 1000 kompletnych gier, LUB
Obsłużenie ok. 20 000 odpowiedz uczniów przez Sędziego.

To bezpieczny system "Pre-paid" (jak telefon na kartę). Gdy środki się skończą, klucz po prostu przestaje działać. Nie ma ryzyka naliczenia gigantycznego rachunku.

Q: Przycisk "Generuj" jest szary i nie działa.

A: Sprawdź, czy na pewno wkleiłeś Klucz API i czy dodałeś chociaż jeden plik z materiałem.

Q: W grze przy zadaniu "Sędzia" wyskakuje błąd "Quota exceeded" lub błąd sieci.

A: Jeśli używasz darmowego Gemini, mogłeś zużyć limit zapytań na minutę (jeśli np. 30 uczniów naraz kliknęło "Sprawdź"). Odczekaj chwilę.

A: Jeśli używasz DeepSeek, mogły skończyć się środki na Twoim koncie (te 5 USD).

Q: Czy uczniowie mogą ukraść mój klucz z pliku gry?

A: Teoretycznie tak, jeśli uczeń jest programistą i zajrzy w kod źródłowy pliku ("Zbadaj element").

Dla Gemini: To nie problem, bo klucz jest darmowy.
Dla DeepSeek: Dlatego używamy wirtualnej karty z limitem 25 zł. W najgorszym razie stracisz końcówkę tej kwoty. Ryzyko jest minimalne.

Q: Czy mogę usunąć plik generatora?

A: Nie usuwaj go! To Twoje narzędzie pracy. Pliki gier (Gra_...html) są jednorazowe, ale generator służy do tworzenia kolejnych.