Instructions to use botezx/flagtldr with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Grok
How to use botezx/flagtldr with Grok:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
|
Download docs/DECISIONS.md from botezx/flagtldr: direct link, hf CLI and curl.
- Browser
- Download file 25.3 kB
-
https://huggingface.co/botezx/flagtldr/resolve/main/docs/DECISIONS.md
- Command line
-
hf download hf://botezx/flagtldr/docs/DECISIONS.md
-
curl -L -o DECISIONS.md https://huggingface.co/botezx/flagtldr/resolve/main/docs/DECISIONS.md
25.3 kB
| # DECISIONS – otwarte pytania do botex-human | |
| Każde pytanie ma rekomendację (★). Zaznacz wybór, a ja zaktualizuję kod i dokumentację. | |
| ### D1. Jak wysyłać podsumowanie do Groka „na koncie X”? | |
| - ★ **a′)** **One-click (`grok-auto`), teraz domyślne.** Po Twoim kliknięciu rozszerzenie steruje Twoim Grokiem w ukrytej ramce | |
| `x.com/i/grok` albo w karcie w tle: wpisuje prompt, klika „Wyślij”, czeka i zbiera odpowiedź do panelu pod wpisem. Nie wywołuje | |
| API, nie używa tokenów, nie zdejmuje nagłówków. Ryzyko: szara strefa ToS (automatyzacja UI), umiarkowane/niskie. Selektory nie | |
| są jeszcze zweryfikowane na prawdziwym x.com. Przy błędzie przechodzi automatycznie do a). | |
| **Pytanie:** czy zostawić ukrytą ramkę jako domyślną, czy wolisz kartę w tle (widoczna w pasku kart przez kilka–kilkadziesiąt sekund)? | |
| - **a)** Handoff: schowek i otwarcie Groka w X. Oficjalne, bezpieczne, ale wymaga jednego Ctrl+V. *(fallback i opcja ręczna)* | |
| - b) xAI API przez OAuth subskrypcji (progrok lub wbudowany device-flow). Wymaga SuperGrok lub X Premium+. Wynik od razu w panelu. | |
| - c) Nieoficjalnie przez sesję X (`add_response.json`). W pełni automatyczne, ale łamie ToS (ryzyko dla konta) i może się zepsuć. | |
| - d) Klucz xAI API (płatne tokeny). | |
| - **Pytanie:** jaki plan masz na X / xAI (Premium, Premium+, SuperGrok)? | |
| ### D2. Skąd brać odpowiedzi w wątku? | |
| - ★ **a)** Tylko to, co X załadował w karcie (trzeba przewinąć). Zero dodatkowego ruchu. | |
| - b) Automatyczne przewijanie lub dociąganie przez wewnętrzne GraphQL (ryzyko ToS). | |
| - c) X API pay-per-use (~$0.005 za wpis, np. 200 odpowiedzi to ~$1). Masz konto developerskie? | |
| ### D3. Który basal i gdzie ma działać? | |
| - ★ **a)** `basal-omni-pico` na CPU na Twoim komputerze (`scripts/basal-serve.sh`). Zajmuje ~1.6 GB, ~0.3–0.5 s na wpis. | |
| - b) `basal-omni-1.0-mini` (GPU ~16 GB lub Mac z MLX). Lepsza jakość i obsługa obrazów (memy, zrzuty). | |
| - c) Serwer na tym boxie lub zdalnym, wystawiony rozszerzeniu (wymaga tunelu i autoryzacji). | |
| - **Pytanie:** jaki masz sprzęt (GPU, VRAM, Mac M-series)? | |
| ### D4. Uczenie klasyfikatora | |
| - ★ **a)** Faza 2: opis, rubryki i przykłady w prompcie, potem kalibracja `basal-calibrate` na ~70–300 Twoich etykietach (zbieranych kliknięciem „popraw etykietę”). | |
| - b) Dodatkowo głowica na embeddingach, trenowana w sekundy. Mogłaby działać w samej przeglądarce, bez serwisu. | |
| - c) Własne LoRA na basal (brak oficjalnego skryptu; większy projekt). | |
| - **Pytanie:** jakie klasyfikacje są dla Ciebie najważniejsze (np. merytoryczny / kontra / szum; boty; polityka; spam krypto)? Ile przykładów możesz dać na start? | |
| ### D5. Co robić z oznaczonymi wpisami? | |
| - Domyślnie: kolorowy pasek i plakietka; `szum` zwijany do jednej linii; `hide` dostępne, ale niedomyślne. | |
| - **Pytanie:** czy klasyfikować cały timeline (więcej obciążenia), czy tylko otwarte wątki? | |
| ### D6. Przeglądarki i telefon | |
| - ★ Chrome i Firefox na desktopie. Na Androida: Firefox (wymaga publikacji na AMO, może być prywatna lub niewystawiona). | |
| - **Pytanie:** na czym korzystasz z X (desktop, Android, iOS)? | |
| ### D7. Dystrybucja | |
| - ★ Na razie „załaduj rozpakowane” lub podpisany XPI (unlisted na AMO). | |
| - Później ewentualnie Chrome Web Store (unlisted). Czy publikować publicznie? | |
| ### D8. Język | |
| - UI i domyślny system prompt są po polsku. Czy podsumowanie zawsze po polsku, czy w języku wątku? | |
| ### D9. Ilość danych w promptcie | |
| - Domyślnie do 150 odpowiedzi (sortowanych po polubieniach) i 60 tys. znaków. Czy uwzględniać cytaty (quote posts)? | |
| - **Ustalone (v0.4.1, botex-human):** tylko **poddrzewo klikniętego wpisu** – wpis, odpowiedzi na niego i odpowiedzi na te odpowiedzi | |
| (rekurencyjnie); bez przodków i bez sąsiednich gałęzi. Przodkowie tylko jako oznaczony „kontekst nadrzędny” (ustawienie: | |
| brak / bezpośredni rodzic – domyślnie / do 3 / cały łańcuch). Drzewo z `in_reply_to_status_id_str` (TweetDetail), zapasowo | |
| kolejność w module `conversationthread-*`; bez GraphQL – układ strony (wszystko pod wpisem głównym strony i pod jego przodkami | |
| należy do ich poddrzewa; dla odpowiedzi niżej – tylko kolejne wpisy tego samego modułu do separatora X). | |
| Nagłówek panelu: „Poddrzewo wpisu: N odpowiedzi z K znanych” (K = liczniki odpowiedzi X dla wpisu i zebranych odpowiedzi). | |
| Ograniczenie: X ładuje głębsze gałęzie dopiero po „Pokaż więcej odpowiedzi” – czego nie załadował, tego nie mamy (widać to w N vs K). | |
| ### D10. Kraj konta autora i ukrywanie wg kraju/regionu (v0.4.0) – co ustaliliśmy, co do potwierdzenia | |
| - **Wszystko domyślnie wyłączone** (ustawienia → „3. Kraj konta autora”). *Zmienione w 0.5.0 (D18): funkcja domyślnie włączona na żądanie, automatyczne sprawdzanie nadal wyłączone.* | |
| - **Trzy stany, nigdy pomieszane:** *wg X* (flaga kraju albo zarys regionu, ⚠ gdy X sam ostrzega o VPN/proxy), | |
| *zadeklarowana* (📍 w przerywanej ramce – tekst z profilu, tylko informacyjnie), *nieznana* (brak danych; „?” opcjonalnie). | |
| Kraje mają **tylko flagę**, zarysy wyłącznie dla regionów; nieznany region → 🌐. | |
| - **Pasywnie (domyślnie):** dane, które X i tak pobrał – lokalizacja z profilu w każdym obiekcie `User` oraz pełne „Konto z”, | |
| gdy sam otworzysz czyjeś „Informacje o koncie”. Zero własnych zapytań. | |
| - **Aktywnie (opcja z ostrzeżeniem, ryzyko):** `AboutAccountQuery` wysyłane **z kontekstu strony x.com** (Twoja sesja, jak robi to | |
| sama strona), tylko dla autorów **widocznych** na ekranie, 1 naraz globalnie (wszystkie karty), domyślnie 6/min (1–30), | |
| cache 14 dni (1–30; „brak danych” max 3 dni), pauza do `x-rate-limit-reset` po 429 (oraz gdy `remaining ≤ 1`), | |
| stop: 401/403 → 60 min, 400/404/422 (zmienił się queryId) → 6 h, 3 błędy z rzędu → 30 min. Wznowienie w opcjach. | |
| Token `authorization` jest tylko podglądany z zapytań X i **nigdy nie opuszcza strony** (nie trafia do storage ani do tła); | |
| CSRF czytany z ciasteczka `ct0` w chwili zapytania. | |
| **Ryzyko:** nieudokumentowany endpoint, szara strefa regulaminu (automatyczne zapytania), możliwe limity, w skrajności | |
| ograniczenie konta. Dlatego to osobny przełącznik z czerwonym ostrzeżeniem i potwierdzeniem. | |
| - **Odrzucone:** ukryta karta/ramka z `/<handle>/about` (to samo zapytanie, więcej ruchu i ryzyka); zewnętrzne API (wyciek tego, kogo czytasz). | |
| - **Filtr:** lista krajów/regionów/„nieznana” z wyszukiwarką; tryb ukryj / zwiń z „Pokaż” / przyciemnij; zakres oś czasu / | |
| odpowiedzi (strony `/status/`) / oba; czarna albo biała lista. Region obejmuje swoje kraje (opcja) i pod-regiony | |
| („Azja” łapie „Azję Południową”, ale nie odwrotnie). **Nigdy nie ukrywamy na niepełnych danych:** konto niesprawdzone / | |
| w trakcie sprawdzania nie jest filtrowane (także w trybie białej listy); „nieznana” = X odpowiedział, że nie ma danych. | |
| Otwarty wpis (główny w wątku) nigdy nie jest ukrywany. Opcja: kraj zadeklarowany w profilu jako zastępstwo w filtrze (domyślnie wył.). | |
| - **Podsumowanie:** odpowiedzi ukryte/zwinięte filtrem nie trafiają do promptu (opcja, domyślnie tak); przyciemnione – trafiają. | |
| - **Raport diagnostyczny:** tylko liczniki (zapytania, trafienia cache, 429, stopy) i ustawienia (lista krajów jako liczba). | |
| - **v0.4.1:** domyślnie 12/min z tempem adaptacyjnym wg nagłówków X (zob. D11), przycisk „🌐 Sprawdź kraj” przy wpisie. | |
| - **Pytania do botex-human:** (1) czy domyślne 12/min (adaptacyjnie) i 14 dni są OK? (2) czy filtr ma działać też na cytatach/retweetach (teraz: autor wpisu)? | |
| (3) czy pokazywać źródło połączenia (np. „Android”, „Poland App Store”) w podpowiedzi – teraz tak, tylko w tooltipie. | |
| ### D11. v0.4.1 – kliknięcia, kolejka, pigułka, kotwiczenie (ustalone z botex-human) | |
| - **„🌐 Sprawdź kraj” przy wpisie:** domyślnie włączone (osobny przełącznik), także przy wyłączonym aktywnym sprawdzaniu; uwaga o ryzyku | |
| tylko przy pierwszym użyciu; widoczny też, gdy automat nie dotrze do autora w ~5 s (kolejka / budżet / pauza). | |
| - **Kliknięcie = od razu** (cel ~1 s): nie czeka na odstęp, nasz limit na minutę ani automatyczne pozycje; max 2 zapytania w locie. | |
| Opóźnia je tylko pauza X (429 / `remaining = 0` do resetu / stop po błędach) – z odliczaniem na przycisku; autor jest wtedy pierwszy w kolejce. | |
| - **Kolejka:** auto – wypada po 10 s poza ekranem lub po zniknięciu z DOM; kliknięte – po 2 min poza ekranem; limit 20 (ustawialny), | |
| najnowsze widoczne pierwsze. Liczniki odrzuceń w raporcie diagnostycznym. | |
| - **Pigułka kolejki + licznik na ikonie + presety 6/12/30**, tempo adaptacyjne (RESEARCH §8). | |
| - **Kotwiczenie:** „⚖ Podsumuj” jako osobny element w pasku akcji TEGO wpisu (grupa z przyciskami reply/retweet/like, której najbliższy | |
| `article` to ten wpis), z pominięciem ankiet (tekstowych i obrazkowych), kart, cytatów, zdjęć/karuzel; bez pozycjonowania absolutnego. | |
| Plakietka kraju – w `User-Name` tego wpisu, nie cytowanego (`src/lib/anchors.js`). | |
| ### D12. v0.4.2 – tryb Groka (ustalone z botex-human) | |
| - **Domyślnie Szybki (Fast)**; do wyboru Auto, Ekspert, „nie zmieniaj”. Wybór tylko przez UI (kliknięcie przełącznika w kompozytorze), | |
| bez parametrów URL (nie istnieją) i bez wewnętrznych API. | |
| - **Nigdy nie blokuje podsumowania:** brak przełącznika / tryb niedostępny / brak potwierdzenia → bieżący tryb + ostrzeżenie w panelu | |
| („nie udało się ustawić trybu Szybki” albo „…potwierdzić…”) + sekcja `mode` w diagnostyce (tylko ogólne klucze trybów). | |
| - **„Przywróć poprzedni tryb”** domyślnie włączone, best-effort (limit ~10 s, po odpowiedzi, przed zamknięciem ramki/karty) – | |
| X może zapamiętywać wybór także z ukrytej ramki. | |
| - **Próbne otwieranie menu** (ostatnia deska ratunku dla przycisku bez etykiety): najwyżej 3 przyciski `aria-haspopup` w formularzu | |
| kompozytora, każde menu zamykane Escape. Do usunięcia, jeśli raport z x.com pokaże stabilny selektor. | |
| - **API xAI:** domyślnie `grok-4.3` + `reasoning_effort: none` (szybki odpowiednik wycofanych `grok-4-fast`); `grok-4.7` jako opcja „ekspercka”. | |
| ### D13. v0.4.2 – „Grok sam czyta wątek”, panel, plakietka kraju, jedno wysłanie (ustalone z botex-human 23.10, 16:52–17:03) | |
| - **Domyślnie Grok czyta wątek sam** z linku do klikniętego wpisu; prompt tylko OPISUJE, które odpowiedzi brać (poddrzewo, wszystkie | |
| poziomy; rodzic tylko kontekst; pole „Jak wybierać odpowiedzi”) i prosi o „@autor + link”. Rozszerzenie nie zbiera i nie liczy | |
| odpowiedzi (nagłówek „Grok czyta wątek sam”). Odrzucony plan „numerowana lista + [spoza listy]”. Tryb „odpowiedzi z rozszerzenia” | |
| zostaje jako porównawczy (niedomyślny); dostawca „API zgodne z OpenAI” zawsze w nim działa (API nie czyta X). | |
| - **Filtr kraju w trybie Groka:** nie da się wyciąć odpowiedzi, których nie zbieramy – do promptu idzie lista kont ukrytych/zwiniętych | |
| przez filtr (max 50) z prośbą o pominięcie. Best-effort, niezweryfikowane. | |
| - **Panel:** stały kontrakt sekcji `## TEZA/ZA/PRZECIW/SZUM/OCENA/BRAKUJE`, tolerancyjny parser; subiektywne sekcje zwinięte i podpisane. | |
| - **Plakietka kraju:** stan autora (w kolejce + pozycja / sprawdzam / flaga / „Sprawdź kraj”) liczony centralnie dla autora i rozsyłany do | |
| innych kart x.com przez service worker (wiadomość `xa-geo-state`, ważna 90 s). | |
| - **Jedno wysłanie na zadanie:** token zadania; ramka może wysłać tylko, jeśli to ona przejęła zadanie, a przejście na kartę tylko gdy ramka | |
| nie przejęła zadania; drugie „wyślij” – odmowa. Po wpisaniu odczyt kompozytora; podwojenie → wyczyść i wpisz raz; między metodami | |
| wpisywania zawsze czyszczenie. Nadal tylko akcje UI z kliknięcia użytkownika, bez wewnętrznych API; nagłówki bezpieczeństwa bez zmian. | |
| ### D14. v0.4.3 – hybrydowe źródło odpowiedzi, poprawka „niezwiązanych odpowiedzi” (ustalone z botex-human 23.10, 17:02 FINAL, 17:27, 17:48) | |
| - **Domyślnie hybrydowo:** rozszerzenie dostarcza zweryfikowane poddrzewo (malejąco wg polubień, ten sam limit), a prompt zawiera link | |
| i zasady wyboru wygenerowane z ustawień – te same, których używa rozszerzenie – żeby Grok doczytał brakujące odpowiedzi i cytował | |
| „@autor + link”. „Jak wybierać odpowiedzi” domyślnie = te zasady. Opcje: „tylko Grok czyta wątek”, „tylko dostarczone odpowiedzi”. | |
| Stare domyślne „grok” (bez `replySourceV043`) → „hybrid”. | |
| - **Weryfikacja odpowiedzi:** tylko łańcuch `in_reply_to_status_id_str` do wpisu; DOM tylko na własnej stronie wpisu; przodkowie tylko | |
| z łańcucha wpisu; bez kontekstu z układu strony. Wolimy pokazać 0 dostarczonych (Grok doczyta z linku) niż jedną fałszywą. | |
| - **Podwójne wklejenie:** porównanie bez białych znaków; ostatnia kontrola tuż przed „Wyślij” po ustabilizowaniu się kompozytora | |
| (2 odczyty co 250 ms); podwójnie → wyczyść i wpisz raz; nadal podwójnie → przerwij z błędem (nigdy nie wysyłamy duplikatu). | |
| Nadal tylko akcje UI z kliknięcia użytkownika, bez wewnętrznych API; nagłówki bezpieczeństwa bez zmian. | |
| ### D15. v0.4.3 – dwie ścieżki odpowiedzi, argumenty wg ważności (ustalone z botex-human 23.10, 17:31, 17:35) | |
| - Jeden prompt systemowy, dwie ścieżki; pierwsza linia `## TRYB: TEZA` / `## TRYB: INFORMACJA`. Parser: znacznik wygrywa tylko, gdy | |
| pasują sekcje; inaczej wnioskowanie z sekcji; inaczej markdown. Ustawienie wymuszenia: auto / teza / informacja. | |
| - ZA/PRZECIW (i „Ciekawe odpowiedzi”) porządkuje Grok wg wagi merytorycznej, nie polubień; duplikaty łączy w jeden punkt z listą @autorów. | |
| Panel trzyma kolejność Groka, pokazuje top N (domyślnie 3, 0 = wszystkie) z „Pokaż wszystkie (N)” / „Zwiń”. | |
| ### D16. 0.5.0 – czas podsumowania i formatowanie sekcji rozwijanych (zlecenie botex-human 23.10) | |
| - **Oczekiwany czas = mediana** ostatnich ≤20 udanych przebiegów z najbardziej szczegółowego „kubełka” z ≥2 próbkami: ten sam tryb | |
| Groka + kontekst (ramka/karta/okno) → ten sam tryb → wszystkie; inaczej „brak danych”. Mediana zamiast średniej – odporna na pojedyncze | |
| zawieszenia. Pasek zatrzymuje się na 95 % do czasu wyniku (nie „kłamie”, że skończył). Błędy i przerwane przebiegi się nie liczą. | |
| - Zapis w `chrome.storage.local.summaryTiming` tylko `{ms, mode, ctx, at}` (maks. 60) – bez treści, autorów i ID; przycisk | |
| „Wyczyść statystyki czasu” w ustawieniach. | |
| - OCENA / BRAKUJE / SZUM / PYTANIA renderowane tym samym bezpiecznym rendererem markdown co karty ZA/PRZECIW (bez `innerHTML`), | |
| z odstępami i kolorami zależnymi od motywu. | |
| ### D17. 0.5.0 – nowa nazwa FlagTLDR (zlecenie botex-human 23.10) | |
| - Nazwa **FlagTLDR**, slug `flagtldr`. `manifest.name` „FlagTLDR – flagi krajów i TL;DR wątków na X” (43 znaki – `web-ext lint` ogranicza | |
| do 45, Chrome do 75), `short_name` „FlagTLDR”, opis 129/132 znaków. Raport diagnostyczny: `schema: "flagtldr-diag/1"`, `tool: "FlagTLDR"`. | |
| Przyszłe paczki: `dist/flagtldr-<wersja>-chrome.zip` (teraz nie budujemy). | |
| - **Klucze storage bez zmian** (`settings`, `xaGeo`, `xaGeoState`, `xaDiag`, `summaryTiming`, `geoClickAck`…) – nie miały prefiksu | |
| „x-addons”, więc zmiana nic by nie dała, a wymagałaby migracji. Bez zmian też: katalog repo `/workspace/x-addons`, wewnętrzne `XA.*`, klasy `xa-*`, kanały | |
| `xaddons-page-hook`/`xaddons-content`, pakiet `xaddons-classifier`. ID Firefoksa zmienione później na `flagtldr@botezx.local` (D22). | |
| - **Sprawdzenie kolizji nazwy (23.10.2026, wyszukiwarka):** nie znaleziono produktu ani rozszerzenia o nazwie „FlagTLDR”. Podobne: | |
| FlagTGL (feature flags, https://flagtgl.com/), newsletter TLDR (https://tldr.tech/), everytldr (https://everytldr.com/), | |
| Flaglio (https://www.flaglio.com/); GitHub: dgr4y/flagfilter (filtr flag 4chan, https://github.com/dgr4y/flagfilter), | |
| LiteObject/ai-tldr-chrome-extension, i365dev/community-tldr (w CWS). Indeks wyszukiwarki jest ograniczony – | |
| **przed publikacją sprawdzić ręcznie w Chrome Web Store i Edge Add-ons**. | |
| ### D18. 0.5.0 – kraj konta domyślnie włączony na żądanie (zlecenie botex-human 23.10) | |
| - `geoEnabled: true` domyślnie: przy autorach bez danych przycisk „🌐 Sprawdź kraj” (jedno zapytanie po kliknięciu), pamięć podręczna | |
| i dane pasywne pokazują się od razu. **Pasywnie** (jak dotąd, przy włączonej funkcji): `page-hook.js` czyta kopie odpowiedzi GraphQL, | |
| które X i tak pobrał (lokalizacja z profilu w obiektach User; pełne „Konto z”, gdy użytkownik sam otworzy „Informacje o koncie”) – | |
| bez własnych zapytań. `geoActiveLookup` („Sprawdzaj kraje automatycznie”) i filtr – nadal domyślnie wyłączone. | |
| - **Migracja istniejących ustawień:** zapisanego `false` nie da się odróżnić od świadomego wyboru, więc znacznik `geoDefaultsV2` | |
| (zapisywany przez ustawienia przy każdym „Zapisz”). Bez znacznika i gdy **cała** sekcja kraju ma stare wartości domyślne (pusta lista | |
| filtra) → `geoEnabled` przełączane na `true`; każda inna zmiana w sekcji = świadomy wybór, zostaje. `geoActiveLookup` migracja nigdy nie włącza. | |
| Znane ograniczenie: ktoś, kto włączył i znów wyłączył funkcję, nic więcej nie zmieniając, dostanie ją włączoną – ryzyko niskie | |
| (tryb na żądanie nie wysyła zapytań bez kliknięcia); można ją wyłączyć jednym kliknięciem. | |
| ### D19. 0.5.0 – przygotowanie do Chrome Web Store / Edge Add-ons (zlecenie botex-human 23.10) | |
| - Tylko Chromium; Firefox (AMO) i mobilne poza zakresem. Materiały: `docs/store/` (PRIVACY, PERMISSIONS z audytem A1–A14, LISTING, | |
| PUBLISHING, `assets/` ze skryptu `scripts/e2e/store-assets.mjs` – z makiety, fikcyjne konta). Nic nie zostało zgłoszone ani opłacone; | |
| manifest nie zmieniony w ramach audytu. | |
| - **Propozycje do wersji sklepowej (do decyzji):** flaga `--store` w `package-chrome.py` (bez hostów `127.0.0.1`/`localhost`, | |
| `background.scripts`, `gecko`), stała `STORE_BUILD` ukrywająca klasyfikator (poza „single purpose”), tryb diagnostyczny i pola debug; | |
| `api.x.ai` jako uprawnienie opcjonalne; rozważyć usunięcie `clipboardWrite`; dodać ikonę 16 px do `manifest.icons`; nowa ikona bez | |
| „X” (znak towarowy) z marginesem 16 px. | |
| - **Ryzyka recenzji:** hook fetch/XHR w świecie MAIN, stała `WEB_BEARER` + odczyt `ct0`, nieudokumentowany `AboutAccountQuery` i | |
| automatyzacja UI Groka (regulamin X) – mogą skutkować odrzuceniem lub późniejszym zgłoszeniem; opisane w PERMISSIONS.md A5–A7. | |
| ### D20. 0.5.0 – nowa ikona: liść (zlecenie botex-human 23.10: „nowoczesna, coś prostego, pięknego z natury”) | |
| - **Dlaczego:** stara ikona („X” z kropką na ciemnym kwadracie) przypominała logo X (znak towarowy X Corp.) i nie miała marginesu | |
| wymaganego przez Chrome Web Store (D19, audyt A12). | |
| - **Warianty** (ręcznie pisane SVG 96×96, 3–4 kształty, płaskie z lekkim gradientem; `docs/icon/variants/*.svg` + podglądy PNG 256 px, | |
| arkusz `docs/icon/comparison.png` – 16/32/48/128 px w rzeczywistej wielkości na jasnym i ciemnym tle): | |
| **A „Szczyt”** – białe góry i żółte słońce na niebieskim zaokrąglonym kwadracie; **B „Liść”** – biały liść z nerwem na zielonym kole; | |
| **C „Kropla”** – biała kropla wody na niebiesko-fioletowym kwadracie. | |
| - **Wybór: B „Liść”.** Najmocniejsza sylwetka w 16 px (jeden duży biały kształt po przekątnej, nerw widoczny od 32 px), zielone koło | |
| odcina się i od jasnego, i od ciemnego paska narzędzi (Chrome / Edge, motywy jasny i ciemny) oraz od niebieskich ikon X / Groka obok; | |
| nic nie przypomina litery „X”. A w 16 px zlewa się w „obrazek” (góry + słońce to też powszechna ikona galerii zdjęć, a dolna krawędź | |
| gór na białym tle się rozmywa); C jest czytelna, ale generyczna (kojarzy się z aplikacjami pogody / wody) i niebieska jak X. | |
| - **Wymiary:** `extension/icons/icon{16,32,48}.png` – pełne koło (bez marginesu, żeby w pasku narzędzi nie było za małe); | |
| `icon128.png` – grafika 96×96 wyśrodkowana, 16 px przezroczystego marginesu (wytyczne CWS „Supplying images”; ikona średnio-jasna, | |
| więc bez dodatkowej poświaty). `manifest.icons` 16/32/48/128 i `action.default_icon` 16/32/48. Test jednostkowy sprawdza rozmiary | |
| PNG i margines (bbox kanału alfa = 16…111). | |
| - **W UI:** logo (`icon48.png` w 32 px) w nagłówku ustawień + favicon; w nagłówkach nakładki postępu, panelu TL;DR i panelu tekstu | |
| zamiast „⚖” – mała ikona jako inline SVG (`LOGO_SVG` w content.js; bez `web_accessible_resources`, czyli bez nowych zasobów | |
| dostępnych dla stron). Przycisk „⚖ Podsumuj” zostaje (opisuje akcję, nie markę). | |
| - **Grafiki sklepu** renderowane z `docs/icon/flagtldr.svg` (`scripts/e2e/icon-assets.mjs`, wołane z `icon-render.mjs` i | |
| `store-assets.mjs`): `icon-128.png` (= icon128), `logo-300.png` (pełne koło, przezroczyste rogi), `promo-440x280.png` (ciemnozielone | |
| tło, żeby zielone koło się wyróżniało); zrzuty sklepu 2 i 3 odświeżone (nowe logo w nagłówku panelu). Wszystko powtarzalne: `node scripts/e2e/icon-render.mjs <chrome> b-lisc` (bez makiety). | |
| ### D21. Wydanie 0.5.0 (2026-10-23, po akceptacji ikony przez botex-human) | |
| - Zmiany „Unreleased” (D16–D20) wydane jako **0.5.0**: `manifest.json`, `package.json` (+ `package-lock.json`), przykładowy raport | |
| diagnostyczny. Paczka `dist/flagtldr-0.5.0-chrome.zip` (`scripts/package-chrome.py`), tag git `v0.5.0`. Nic nie zostało zgłoszone | |
| do sklepów (to osobna decyzja – PUBLISHING.md). | |
| - **Aktualizacja z 0.4.3 – co zostaje (sprawdzone, `scripts/e2e/release-check.mjs`, Chrome 156, tymczasowy profil):** cały stan | |
| (`settings`, pamięć krajów `xaGeo`/`xaGeoState`, `summaryTiming`, diagnostyka) jest w `chrome.storage.local`, przypisanym do ID | |
| rozszerzenia; manifest nie ma pola `key`, więc ID rozszerzenia rozpakowanego = skrót ścieżki katalogu. (a) Nowe pliki w **tym samym | |
| katalogu** + ⟳ → to samo ID, ustawienia i pamięć krajów zachowane, nazwa na liście zmienia się z „X Addons” na FlagTLDR. | |
| (b) **Inny katalog** → nowe ID, pusto (ustawienia domyślne); stary wpis trzeba usunąć, żeby nie działały dwa naraz. | |
| (c) **„Usuń” i ponowne załadowanie** (nawet z tego samego katalogu) → pusto – usunięcie kasuje dane rozszerzenia. | |
| Nie dodajemy pola `key` (stałe ID) ani eksportu ustawień – instrukcja zaleca wariant (a). | |
| - Migracja D18 działa także przy aktualizacji: kto zmienił coś w sekcji „Kraj konta” w 0.4.3, zachowuje swój wybór (w teście: | |
| zmienione „Pamięć podręczna (dni)” → `geoEnabled` zostaje wyłączone). | |
| ### D22. Anonimizacja repozytorium (po 0.5.0, bez zmiany wersji) | |
| - Właściciel projektu występuje w dokumentacji, komentarzach i testach jako **botex-human** (zamiast imienia). Godziny ustaleń zostały. | |
| - **ID Firefoksa** `browser_specific_settings.gecko.id`: `flagtldr@botezx.local` (poprzednio identyfikator z imieniem właściciela). | |
| Firefox jest poza zakresem (publikujemy tylko Chromium), a Chrome to pole ignoruje, więc zmiana nie wpływa na ustawienia | |
| ani pamięć krajów w Chromium. W Firefoksie byłoby to nowe rozszerzenie (dane od zera). | |
| - **Przykłady z X:** regresje 0.4.3 (oś czasu „5 z 6” i drugi zgłoszony przypadek) oraz odpowiedź Groka w układzie z numerowanymi | |
| nagłówkami odtworzone na **wymyślonych** kontach (`@przyklad_autor`, `@autorka_wpisu`, `@watek_start`, `@argument_a`…), | |
| identyfikatorach (`2113570000000000001`…) i treściach o tej samej strukturze. Pliki: `fixtures/hometimeline.focal2.json` | |
| (makieta `?tl=focal2`), `fixtures/grok-answers/numbered-pl.md` (makieta Groka `?answer=numbered`). Testy sprawdzają te same przypadki. | |
| ### D23. Wydanie 0.5.1 (2026-10-26) | |
| - Poprawki po testach 0.5.0: puste `()` w kartach ZA/PRZECIW po wyciągnięciu źródeł; odporność automatyzacji Groka na | |
| przełączanie kart (chwilowa aktywacja karty na tryb/wpisanie, łagodniejsze wykrywanie elementów w tle). | |
| - Anonimizacja repo (D22) wchodzi do tej paczki. Bez zmian kluczy `chrome.storage`. Paczka | |
| `dist/flagtldr-0.5.1-chrome.zip`, tag `v0.5.1`. | |
| ### D24. Wydanie 0.5.2 (2026-10-30) | |
| - Poprawka po testach 0.5.1: nowy przycisk „Tryb głosowy” w polu Groka był brany za przełącznik trybu (ogólne selektory | |
| `aria-label*="tryb"/"mode"`), więc rozszerzenie klikało mikrofon i nie wpisywało promptu. Kontrolki głosu są pomijane, | |
| a ogólne selektory wymagają przycisku z menu albo nazwy trybu w etykiecie. Bez zmian kluczy `chrome.storage`. | |
| Paczka `dist/flagtldr-0.5.2-chrome.zip`, tag `v0.5.2`. | |
| ### D25. Wydanie 0.5.3 (2026-10-30) | |
| - Grok w całości w tle: bez aktywowania karty Groka (pożyczanie fokusu z 0.5.1 domyślnie wyłączone, opcja | |
| `grokAllowFocusSwitch`), wpisywanie bez fokusu; reguła DNR usuwa `X-Frame-Options` tylko dla ramki `x.com/i/grok` | |
| otwieranej z x.com (uprawnienie `declarativeNetRequestWithHostAccess`). Paczka `dist/flagtldr-0.5.3-chrome.zip`, tag `v0.5.3`. | |