Skip to content

Latest commit

 

History

History
163 lines (109 loc) · 30.6 KB

README.md

File metadata and controls

163 lines (109 loc) · 30.6 KB

Jak żyć lepiej

Praktyczny poradnik oparty na dowodach

Czytaj polską wersję online

Niezależna polska adaptacja HowToLiveBetter — 高性价比人生指南, autorstwa eternity4719. Wybieramy praktyczne zalecenia, sprawdzamy źródła i opisujemy ich ograniczenia. To nie jest oficjalne wydanie autora ani automatyczne tłumaczenie.

Stan treści: 522 opracowanych polskich porad z dwudziestu trzech rozdziałów. Źródła sprawdzono w opisanym przy poradach zakresie; nie oznacza to zatwierdzenia przez lekarza lub prawnika. Nie przetłumaczono całej książki ani wszystkich pozycji tych rozdziałów.

Rozdział Ocenione pozycje źródłowe W czytniku (verified) Pozostałe
01. Unikaj przedwczesnej śmierci 48 33 4 needs_verification, 11 needs_localization
02. Dbaj o zdrowie na co dzień 47 30 13 needs_verification, 4 needs_localization
03. Nie marnuj energii 27 12 13 needs_verification, 2 needs_localization
04. Nie marnuj czasu 18 10 8 wcześniejszych wyłączeń, bez pełnego tłumaczenia
05. Nie marnuj pieniędzy 51 35 2 needs_verification, 14 needs_localization
06. Czarna lista 35 35 —
07. Jak żyć, gdy nie ma się pieniędzy 23 23 —
08. Nie pakuj się w tarapaty 46 46 —
09. Czerwone linie prawa 29 29 —
10. Związek i małżeństwo: czy to się opłaca? 23 23 —
11. Czerwone linie IT 21 21 —
12. Przedsiębiorczość i biznes: nie płać za cudze błędy majątkiem osobistym 28 28 —
13. Sytuacje nagłe: co robić najpierw 48 48 —
14. Bezpieczeństwo kont i danych 12 11 1 needs_localization
15. Wynajem i kupno mieszkania 18 18 —
16. Życie z chorobą przewlekłą 14 14 —
17. Senior w rodzinie: wsparcie, bezpieczeństwo i opieka 13 12 1 needs_localization
18. Rodzicielstwo: decyzje, koszty i wsparcie 7 7 —
19. Praca, rozwiązanie umowy i wypadki 24 23 1 needs_verification
20. Opieka nad noworodkiem i niemowlęciem 17 16 1 needs_verification
21. Podróż za granicę i bezpieczeństwo 13 12 1 needs_localization
22. Odpoczynek, rozrywka i bezpieczeństwo 12 12 —
23. Edukacja, kwalifikacje i uczenie się 25 24 1 needs_localization
Razem 599 522 69 rekordów oczekujących i 8 wcześniejszych wyłączeń

Tabela obejmuje ocenione rozdziały 01–23. Pełny oryginał obejmuje 34 rozdziały i 767 numerowanych pozycji. Poza bieżącą adaptacją pozostaje 11 nieopracowanych rozdziałów (24–34), obejmujących 168 pozycji źródłowych. Nie są to gotowe polskie porady ani obietnica opublikowania każdej pozycji. Dalszą pracę opisuje zatwierdzony plan, sekcja H; szczegóły braków pozostają przy rekordach w book/pl/.

Rozdział 23 dodaje 24 zawężone pozycje o edukacji, kwalifikacjach i uczeniu się. Rozdziela prawo i zalecenia organizacyjne od syntez badań; nie obiecuje podwyżki za kurs ani dłuższego życia za rok szkoły. Wyjaśnia różnicę między ukończeniem kursu i kwalifikacją, ujawnia rozbieżność PIP/KP oraz ograniczoną lekturę abstraktów autorów. Przeglądy bez wspólnej wielkości efektu mają B. Pozycja 23.20 o polskim odpowiedniku obcego systemu tytułów pozostaje poza czytnikiem. Rozdział 22 dodaje 12 zawężonych pozycji o bezpieczeństwie rozrywki i odpoczynku. Rozdziela polskie wskazówki operacyjne, pojedyncze badania kliniczne i syntezy obserwacyjne. Nie wywodzi gwarancji przeżycia z OR lub HR, nie zaleca zastępowania leczenia ani zwiększania wysiłku mimo przeciwwskazań. Zakres lektury i braki dodatków pozostają przy pozycjach; uwzględniono korektę badania ruchu i depresji. Rozdział 21 dodaje 12 zawężonych porad organizacyjnych opartych na polskich i unijnych wyjaśnieniach: ostrzeżenia MSZ, kontakty i granice pomocy konsularnej, ubezpieczenie, oferty pracy, gotówka, dokumenty, prowadzenie pojazdu, zaproszenie cudzoziemca, plan kontaktu, leki i żywność. Nie obiecuje ochrony, refundacji lub legalności wyjazdu. Pozycja 21.9 o pośrednikach pozostaje needs_localization poza czytnikiem. Nie przeniesiono chińskich instytucji, sankcji, kwot i telefonów. Rozdział 20 dodaje 16 zawężonych porad o bezpieczeństwie i opiece nad niemowlęciem: sen, dokumentacja profilaktyki, karmienie, sygnały alarmowe, przeciążenie opiekuna i wyposażenie. Odróżnia opis zaleceń od wyników pojedynczego badania LEAP; nie podaje domowych prób prowokacji ani schematu leczenia. Przygotowanie mleka w proszku pozostaje poza poradami do rozstrzygnięcia w issue #36. Rozdział 19 dodaje 23 zawężone porady o pracy, zakończeniu zatrudnienia, BHP i dokumentacji wypadku. To opis polskich przepisów i procedur, nie gwarancja świadczenia lub wygranej. Pozycja 19.18 o podatku pozostaje poza czytnikiem do dalszej weryfikacji w issue #32. Nie przeniesiono zagranicznych mnożników wypłat ani ryzyk zdrowotnych z nieodczytanych badań. Rozdział 18 dodaje 7 zawężonych pozycji: polskie świadczenia i prawa pracownicze, trzy jawne osądy redakcyjne o czasie, budżecie i dobrowolności decyzji oraz dane obserwacyjne dotyczące płodności. Nie daje indywidualnej prognozy ani rachunku, czy dziecko „się opłaca”. Źródła czytano w opisanym zakresie; status opinii nie oznacza udowodnionej skuteczności. Rozdział 17 dodaje 11 zawężonych porad o wsparciu seniora bez odbierania samodzielności, testamencie, presji sprzedażowej, opiece domowej i całodobowej oraz wybranych potrzebach zdrowotnych. Dwie pozycje pozostają niepublikowane: przyszła reprezentacja prawna i pełna procedura uprawnień pracownika opiekującego się rodzicem. Rozdział 16 dodaje 14 zawężonych porad o życiu z chorobą przewlekłą: ciągłość leczenia, kontrole i dokumentacja, opieka POZ, recepty, podróż z EKUZ, cukrzyca, kamica i dna moczanowa, HBV, POChP oraz ruch po leczeniu raka okrężnicy. Odróżnia wyniki badań od zasad organizacyjnych; nie wyznacza indywidualnych dawek, harmonogramów ani gwarantowanej korzyści zdrowotnej. Oceny zmienione względem oryginału opisano zgodnie z definicjami tego wydania. Rozdział 15 (wynajem i kupno mieszkania) wycofano 2026-11-01 po błędach przypisania przepisów. Ponowna ocena 2026-11-02 przywraca 18 węższych wersji po odczycie wskazanych pełnych artykułów w urzędowych tekstach oraz oficjalnych wyjaśnień MS, KOWR, BGK i KNF. Nie przywraca dawnego tekstu: poprawiono m.in. kaucję, podstawę zmiany wynajmującego, depozyt notarialny, rezerwację i zadatek, wpis roszczenia, reformę wskaźników, nazwę programu BGK i rękojmię. Wszystkie oceny zmieniono z A do C zgodnie z definicją norm prawnych w tym wydaniu. Zakres i braki lektury opisano przy każdej pozycji; nie przeprowadzono recenzji prawnika ani analizy konkretnej transakcji. Zielone testy i CI nie potwierdzają poprawności prawnej. Rozdział 13 (sytuacje nagłe) dodaje 48 zawężonych porad o pierwszych minutach zagrożenia życia, zdrowia i wolności — RKO i AED, udar i zawał, krwotok i oparzenia, zatrucia i pożar, urazy, pomoc ofiarom przemocy; numery tylko z listy (112, 997, 998, 116 123, 116 111); to opis procedur i przepisów, nie poradnik medyczny ani porada prawna dla konkretnej sprawy. Rozdział 12 (przedsiębiorczość i biznes) dodaje 28 zawężonych porad o tym, co przy zakładaniu i prowadzeniu firmy w Polsce może ściągnąć długi, kary albo odpowiedzialność karną — forma działalności i majątek osobisty, poręczenia, franczyza, rejestracja, zezwolenia, żywność i etykiety, podatki i faktury, umowy, zatrudnienie, towary i podróbki, zamykanie firmy, lokal; to opis przepisów i procedur, nie porada prawna, podatkowa ani biznesowa dla konkretnej sprawy. Rozdział 11 (czerwone linie IT) dodaje 21 zawężonych porad o tym, co osobom technicznym w Polsce kończy się paragrafem albo pozwem o pieniądze — cheaty i skrypty automatyzujące, dostęp do cudzych systemów, dane osobowe, zlecenia od środowisk przestępczych, własność kodu i licencje, prywatność aplikacji, usługi AI i ataki sieciowe; to opis przepisów i procedur, nie porada prawna dla konkretnej sprawy. Rozdział 10 (związek i małżeństwo: czy to się opłaca?) dodaje 23 zawężone porady o relacjach i małżeństwie — dane GUS, prawo rodzinne i cywilne (majątek małżeński, umowa majątkowa, długi małżonka, rozwód, alimenty, kontakty z dzieckiem, konkubinat, pełnomocnictwa i testamenty) oraz wnioski z badań nad relacjami; to opis przepisów i badań, nie porada prawna ani życiowa dla konkretnej sprawy. Rozdział 09 (czerwone linie prawa) dodaje 29 zawężonych porad o tym, co w Polsce kończy się mandatem, zatrzymaniem albo wyrokiem — dezinformacja, symbole narodowe, nielegalne treści w sieci, pranie pieniędzy, wyłudzenia kredytów i odszkodowań, broń i drony, hazard, dzikie zwierzęta i rośliny, pobicia, handel organami, prawo autorskie, pożary lasu, oszustwa egzaminacyjne; to opis przepisów, nie porada prawna dla konkretnej sprawy. Rozdział 08 (nie pakuj się w tarapaty) dodaje 46 zawężonych porad o prawie, procedurach i bezpieczeństwie majątku — wypadki, oszustwa, obrona konieczna, przedawnienie, egzekucja, przemoc domowa; to opis przepisów i procedur, nie porada prawna dla konkretnej sprawy. Rozdział 07 (gdy nie ma się pieniędzy) dodaje 23 zawężone porady o świadczeniach i drogach wyjścia w kryzysie — zasiłek dla bezrobotnych, PIP i sąd pracy, NPP, MOPS, NFZ, mieszkanie socjalne, restrukturyzacja długu; to opis procedur, nie porada prawna ani finansowa dla konkretnej sprawy. Rozdział 06 (czarna lista) dodaje 35 zawężonych porad o rzeczach bez udokumentowanego efektu — suplementach, „pakietach badań”, gadżetach i wydatkach „na pokaz”; nie zawiera porad inwestycyjnych, podatkowych ani prawnych dla konkretnych spraw. Rozdział 05 dodaje 35 zawężonych porad o pieniądzach oraz 16 niepublikowanych rekordów; nic tu nie jest poradą inwestycyjną, podatkową, prawną ani ubezpieczeniową. Rozdział 02 dodaje 30 zawężonych porad oraz 17 niepublikowanych rekordów. Dotyczy m.in. palenia, ruchu, żywienia i bezpiecznej drogi do pomocy; nie wyznacza osobistego celu BMI, domowego detoksu ani obietnicy dłuższego życia. Rozdział 01 zawiera 33 zawężone porady oraz 15 niepublikowanych rekordów. Nie przeniesiono automatycznie chińskich progów badań, prawa, cen, schematów lekowych ani numerów pomocowych. Rozdziały 03, 04 i 14 zachowują wcześniejsze decyzje: 33 porady, 16 rekordów oczekujących i osiem wyłączeń rozdziału 04. To ocena redakcyjna pozycji, nie kompletny systematyczny przegląd medyczny.

Podstawa adaptacji: commit upstream e2605d3e2242bd6216c9255192b8a8957a08c55a. Rozdziały 03 i 14 oceniono początkowo 2026-10-28, rozdziały 01, 02 i 05 — 2026-10-31, a rozdziały 06, 07, 08, 09, 10, 11, 12, 13, 15 i 16 — 2026-11-01. Rozdziały 17, 18 i 19 oceniono 2026-11-02, rozdział 20 — 2026-11-03, a rozdziały 21, 22 i 23 — 2026-11-05. Daty późniejszych korekt i zakresy sprawdzenia pozostają przy poszczególnych poradach. Historyczny run7 nie obejmuje rozdziałów 01, 02, 05, 06, 07, 08, 09, 10, 11, 12, 13, 15, 16, 17, 18, 19, 20, 21, 22 i 23.

Korekta 2026-11-03: porada 11.12 o zakazie konkurencji usuwa niepotwierdzony ogólny limit czasu i instrukcję rozwiązania całej umowy przy braku wpłat. Opis ogranicza się do odczytanych przepisów; źródło, zmiana oceny na C i granice weryfikacji są przy poradzie. To nie jest ponowne poświadczenie pozostałych pozycji rozdziału. Szczegóły zgłoszenia: issue #33.

Co pozostało poza czytnikiem

  • Pozycja 23.20 pozostaje needs_localization: nie ustalono jednej polskiej ścieżki odpowiadającej obcemu systemowi tytułów. Potrzebna jest konkretna branża, właściwy organ i aktualne warunki, nie zmiana samego statusu. Każda nowa pozycja ma oryginalny numer i decyzję. Nie zmieniamy numeracji, aby zapełnić luki.

  • W rozdziale 01 pozycje 26 oraz 32–34 wymagają dalszej weryfikacji: wynik edukacji nie dowodzi skuteczności całego zestawu wyposażenia, a dane o następstwach zdarzeń nie dowodzą bezpieczeństwa i skuteczności straszącego przekazu kryzysowego. Pozycje 8, 23, 24, 35, 37, 39, 40, 44, 45, 47 i 48 wymagają polskiej lokalizacji lub aktualnej kwalifikacji. Nie publikujemy zaleceń przekazywania haseł bankowych rodzinie, samodzielnego leczenia ani zagranicznych harmonogramów jako polskich zaleceń.

  • W rozdziale 03 pozycje 9–17, 20–22 i 24 wymagają dalszej weryfikacji. Powody obejmują nieuprawnione uogólnienia, przenoszenie korelacji na interwencję, różne populacje i niezweryfikowane liczby. Pozycje 19 i 25 wymagają polskiej lokalizacji procedur lub informacji o lekach.

  • W rozdziale 14 pozycja 11 nadal wymaga sprawdzenia polskich procedur i zakresu dostępnych rejestrów. Pozycja 14.5 opisuje już zawężone zasady dla konsumenta korzystającego ze zwykłego rachunku płatniczego, na podstawie polskiej ustawy i oficjalnych objaśnień. Nie gwarantuje zwrotu pieniędzy w każdym oszustwie. Nie skopiowano chińskich uprawnień ani usług.

  • W rozdziale 17 pozycja 1 wymaga potwierdzenia aktualnych polskich zasad przyszłej reprezentacji i pozostaje niepublikowana. Pozycję 17.12 oceniono ponownie 2026-11-07 na podstawie odczytanych przepisów i objaśnień PIP oraz ZUS: odróżnia urlop bez ustawowego wynagrodzenia od warunkowego zasiłku i innych zwolnień. Źródła oraz granice lektury pozostają przy poradzie. Nie jest to recenzja prawnika, indywidualna gwarancja świadczenia ani ponowne poświadczenie pozostałych pozycji; zakres zgłoszenia opisuje issue #31.

  • W rozdziale 19 pozycja 18 o podatku od świadczeń przy zakończeniu zatrudnienia pozostaje niepublikowana. Brak pełnej kwalifikacji zwolnień i wyjątków jest śledzony w issue #32; samo zgłoszenie nie oznacza, że każde świadczenie jest opodatkowane lub zwolnione.

  • W rozdziale 20 pozycja 5 o przygotowaniu mleka w proszku pozostaje needs_verification. Rozbieżne wytyczne WHO i BfR nie zostały zamienione w jeden uniwersalny przepis dla polskich warunków; dalszą pracę śledzi issue #36.

  • W rozdziale 21 pozycja 9 o pośrednictwie wizowym, migracyjnym i edukacyjnym pozostaje needs_localization. Nie ustalono jednej właściwej procedury weryfikacji wszystkich tych usług; szczegółowe kryteria pozostają przy rekordzie.

  • Osiem wcześniejszych wyłączeń rozdziału 04 ma uzasadnienia w jego końcowej tabeli. Nie zmieniono ich na podstawie nowych rozdziałów.

Szczegółowy powód i wymagane dalsze źródła są przy każdym rekordzie. Ich treść nie trafia do wyszukiwania ani kart porad.

Jak czytać koszty i korzyści

Każda opublikowana porada oddziela koszt pieniędzy, czasu i wysiłku, wynik badań lub treść oficjalnego zalecenia, ocenę redakcyjną opłacalności oraz ograniczenia. Koszty przygotowania są ocenami redakcji, nie pomiarami czasu pracy. Nie podajemy zmyślonych polskich cen. Nie przeliczamy automatycznie czasu na pieniądze lub długość życia.

Mały koszt próby nie oznacza mocnych dowodów. Mocne dowody nie oznaczają opłacalności dla każdego. Kolejność wynika z numerów źródła, nie z rankingu. Nie trzeba wykonywać wszystkich zaleceń.

Jak czytać dowody

Oznaczenia A/B/C są skrótem redakcyjnym inspirowanym oryginałem, nie formalnym systemem GRADE. Zmianę oznaczenia względem oryginału opisujemy przy poradzie.

Ocena Znaczenie w tym wydaniu
A Ilościowa synteza badań dotycząca działania i wyniku. Jej projekt, ryzyko błędu i pewność nadal wymagają osobnej oceny. Synteza korelacji nie dowodzi skuteczności porady.
B Pojedyncze badanie, ograniczone próby, przegląd bez jednej wspólnej wielkości efektu lub publikowany wąski wniosek z wytycznych klinicznych.
C Norma prawna, zalecenie operacyjne lub osąd redakcyjny bez bezpośredniego pomiaru skuteczności. Prawo i instrukcja techniczna nie są eksperymentem.

Litera nie zastępuje opisu źródła. A może dotyczyć syntezy o niskiej pewności, jak w 03.18. C nie oznacza, że norma prawna jest dowolną opinią. Przykładowo d = 0,65 nie oznacza poprawy o 65%, a wzrost z 29,3% do 60,0% wynosi 30,7 punktu procentowego. Nie zamieniamy korelacji w przyczynę ani ilorazu szans w bezwzględne prawdopodobieństwo.

Przy części publikacji dostępny był tylko abstrakt autorów. Przy prawie sprawdzono wskazane artykuły lub oficjalne wyjaśnienia, nie każdą możliwą sprawę. Preprint pozostaje oznaczony jako preprint. Każda porada podaje datę i zakres. Stan verified nie oznacza ponownego wykonania badania, formalnej porady prawnej ani pełnego systematycznego przeglądu najnowszej literatury.

Informacje zdrowotne dotyczą opisanych populacji i nie zastępują diagnozy ani leczenia. Porady o bezpieczeństwie dzieci są skierowane do dorosłych opiekunów, nie stanowią instrukcji samoleczenia dzieci. Badanie przesiewowe bez objawów nie jest tym samym co diagnostyka niepokojącego objawu. Nie publikujemy dawkowania leków, samodzielnego ograniczania snu ani obietnicy leczenia depresji przez wykonanie listy nawyków. Chińskie kontakty pomocowe zastąpiono sprawdzonymi polskimi kontaktami tylko tam, gdzie przygotowano pełną poradę. Przy pilnym zagrożeniu nie należy czekać na wykonanie zaleceń produktywności.

Stan treści i pochodzenie

Kanoniczne porady i rekordy redakcyjne są w plikach book/pl/. Rejestr CHAPTERS w reader.mjs przechowuje tylko identyfikatory i ścieżki. Czytnik pobiera Markdown, nie osobną bazę ani chińskie rozdziały. Każda porada zawiera oryginalny numer, przypięty odsyłacz do upstream, źródła, projekt dowodu, ograniczenia, datę, zakres oraz opis zmian.

Stan Znaczenie
verified Opracowana porada ze źródłami sprawdzonymi w opisanym zakresie, ograniczeniami i pochodzeniem. To stan redakcyjny, nie zatwierdzenie przez specjalistę ani gwarancja skuteczności. Tylko ten stan trafia do czytnika.
needs_verification Rekord oczekuje na potwierdzenie materialnego twierdzenia lub działania. Nie jest gotową poradą.
needs_localization Brakuje sprawdzonego zastosowania w polskich przepisach, instytucjach, rynku lub procedurach.
not_applicable Brak odpowiedniego zastosowania w Polsce. To dostępny stan, niewykorzystany w nowych rozdziałach.

Chińskie pliki w book/ i docs/, odziedziczony selfcheck.html, skille oraz starsze generatory są materiałem referencyjnym upstream, nie gotową polską treścią. Czytnik ich nie ładuje. Kontrole czytają je wyłącznie po to, by sprawdzić przypięte odsyłacze, numerację i liczby przeniesione z oryginału.

Uruchom lokalny czytnik

Potrzebujesz Pythona 3 do serwera HTTP. Czytnik nie wymaga instalacji pakietów, konta ani połączeń z usługami zewnętrznymi.

git clone https://github.com/mikomiel/HowToLiveBetter-PL.git
cd HowToLiveBetter-PL
python3 -m http.server 8000 --bind 127.0.0.1

Jeśli sprawdzasz zmiany z niescalonego PR, najpierw przełącz się na jego gałąź. Otwórz http://127.0.0.1:8000/. Nie otwieraj index.html przez file://: przeglądarka może blokować moduł i odczyt treści. Statyczny komunikat wyjaśnia wtedy, jak uruchomić czytnik.

Czytnik ma nawigację rozdziałów, wyszukiwanie we wszystkich opublikowanych poradach, filtr rozdziału i oceny, stałe odsyłacze do porad i rozdziałów oraz szczegóły źródeł. Wyszukiwanie działa także bez polskich znaków. Liczby pochodzą z wczytanych plików. Odsyłacze między rozdziałami działają w Markdown i w czytniku. Obsługuje klawiaturę i małe ekrany.

Zbiór jest pokazywany dopiero po odczycie i sprawdzeniu wszystkich plików. Błąd jednego rozdziału usuwa całość kart i wyświetla wyjaśnienie oraz ponowną próbę. Nie pokazujemy części jako pełnego zbioru. Surowy HTML i niedozwolone adresy w treści nie są wykonywane.

Jak zgłosić poprawkę

Konkretny błąd, brak źródła lub decyzję wymagającą doprecyzowania zgłoś jako issue w tym repozytorium, po sprawdzeniu duplikatów. Podaj identyfikator lub stały link pozycji, kwestionowane zdanie, źródło pierwotne i kryteria zakończenia. Uwagi do trwającego przeglądu zostaw przy właściwym otwartym PR, bez dublowania ich w issue; poprawkę tekstu prześlij jako PR. Samo zgłoszenie lub zamknięcie issue nie zastępuje weryfikacji ani nie nadaje poradzie statusu verified. Nie zamieszczaj publicznie danych zdrowotnych, danych kont, haseł ani opisów indywidualnych spraw — własnych lub cudzych. Jeżeli dowodu brakuje, napisz to zamiast dopisywać pewny wniosek.

Przeczytaj AGENTS.md. Edytuj Markdown, nie kopię porady w kodzie. Zmiana materialnego twierdzenia wymaga ponownej oceny i daty. Niezweryfikowana treść pozostaje poza czytnikiem. PR kieruj wyłącznie do main w mikomiel/HowToLiveBetter-PL.

Kontrole

Potrzebujesz Node.js 22 lub nowszego. Playwright służy do testów przeglądarkowych. Testy regresji odziedziczonego eksportera EPUB używają Marked w tej samej przypiętej wersji co eksporter; w głównym package.json jest to zależność wyłącznie testowa. Czytnik nie ma zależności uruchomieniowych. Na Linuksie przeglądarki wymagają też bibliotek systemowych; samo pobranie binarek nie wystarcza. CI instaluje je przez --with-deps w jednorazowym runnerze. Instalacja pakietów na hoście roboczym wymaga zgody jego właściciela.

npm ci --ignore-scripts
npm test
npm run lint:content
npx playwright install chromium firefox webkit
npm run test:browser

Testy obejmują wszystkie decyzje źródłowe, stany, pochodzenie, liczby, odsyłacze i workflow. Osobne testy budują syntetyczny EPUB w katalogu tymczasowym, bez publikowania e-booka ani uruchamiania eksportera na polskiej treści. Sprawdzają granice wierszy opisu, kodowanie tekstu i etykiet nawigacji oraz wynik parsowania HTML i XML. Przeglądarki wczytują rzeczywiste pliki i sprawdzają rozdziały, wyszukiwanie, filtry, klawiaturę, mały ekran i błędy. Playwright uruchamia Chromium na komputerze i z emulacją telefonu oraz Firefox i WebKit na komputerze. WebKit na Linuksie nie jest testem rzeczywistego Safari. Nie zastępuje to fizycznych urządzeń ani audytu technologii asystujących. Zielony CI nie potwierdza sam naukowej lub prawnej poprawności. Osobny przegląd musi dotyczyć dokładnego opublikowanego HEAD.

Dependency Review sprawdza zmieniane zależności, także deweloperskie, i kończy się błędem po wykryciu nowych znanych podatności high lub critical. Nie ocenia prawdziwości porad. Dependabot proponuje cotygodniowe, grupowane aktualizacje npm i GitHub Actions; sam ich nie scala. CodeQL działa w zarządzanym trybie GitHuba dla JavaScript i Actions. Jego kanoniczną konfiguracją są ustawienia repozytorium, nie drugi workflow. Alerty wymagają oceny; poprawne wykonanie analizy nie oznacza braku podatności.

Publikacja i licencje

GitHub jest jedynym autorytatywnym forge. Decyzja o scaleniu należy do człowieka. Po zgodzie operatora na dany PR agent może wykonać squash merge, ale dopiero po zatwierdzeniu aktualnego HEAD przez uprawnionego recenzenta-człowieka i przejściu wymaganych kontroli. Nie używa --admin ani bypassu. Sprawdza SHA przez --match-head-commit. Docelowo korzysta z osobnej tożsamości bez uprawnień Administration, ograniczonej do tego repozytorium. Sama zmiana tokenu tego samego konta nie rozdziela autora i recenzenta. Dopóki osobna tożsamość nie jest skonfigurowana, agent nie wykonuje merge; robi to człowiek. Ten model nie jest jeszcze w pełni uruchomiony.

Reguły redakcyjne wymagają PR, zatwierdzenia człowieka dla aktualnego HEAD, aktualnej gałęzi, rozwiązanych wątków i braku bypassu. To wymagania procesu, nie deklaracja aktualnych ustawień serwera. Faktyczną ochronę main sprawdzaj w rulesecie GitHuba, którym zarządza operator. Wymagane checki to „Treść i czytnik” i „Dependency review” z GitHub Actions. Ten wymóg nie zastępuje recenzji człowieka. Jeżeli konfiguracja jest słabsza, nie znosi to obowiązku uzyskania akceptacji człowieka. Agent nie zmienia reguł w celu umożliwienia merge. Komentarz z przeglądem AI nie jest zatwierdzeniem GitHuba.

Workflowy repozytorium wykonują walidację, z contents: read, Actions przypiętymi do pełnych SHA i bez zachowywania poświadczeń checkoutu. Używają standardowego runnera Ubuntu 24.04. Nie tworzą e-booków, tagów ani wydań. Jedynym wyjątkiem od zasady „tylko walidacja” jest ręcznie uruchamiany pages.yml, opisany niżej: wdraża stronę czytnika, ale nie tworzy e-booków, tagów ani wydań. CodeQL publikuje wyniki w zakładce Security, nie wydanie książki. Nie włączamy większych płatnych runnerów, płatnych dodatków ani zwiększonych limitów storage. Starsze generatory nie służą do publikacji polskiego wydania.

Wdrożeniem strony czytnika w GitHub Pages zarządza właściciel. Samo scalenie kodu nie jest dowodem wdrożenia strony. Workflow uruchamia ręcznie właściciel (Actions, „Run workflow”, gałąź main); nie startuje po pushu ani według harmonogramu. Przed pierwszym uruchomieniem właściciel ustawia w Settings, Pages, źródło „GitHub Actions” oraz w Settings, Environments, github-pages regułę Deployment branches: tylko main. Warunek if w pliku pages.yml sam nie wystarcza, bo działa tylko w pliku z gałęzi, z której uruchomiono workflow. Workflow uruchamia npm test, buduje folder poleceniem node tools/pl/build-site.mjs _site, sprawdza go w prawdziwej przeglądarce i publikuje tylko jego zawartość: index.html, reader.mjs, rozdziały z rejestru CHAPTERS oraz LICENSE i LICENSE-CODE. Odziedziczone reklamy, chińskie docs/, selfcheck.html, og.png, audit/ i narzędzia nie trafiają na stronę; pilnują tego tests/site.test.mjs i tests/browser/site.spec.mjs. Adres czytnika to polska strona adaptacji. robots.txt z repozytorium nie jest publikowany. Przy domyślnym adresie strony projektu (nazwa-konta.github.io/HowToLiveBetter-PL/) roboty, zgodnie ze standardem, czytają robots.txt z katalogu głównego hosta, więc ten plik nie wyłącza indeksowania strony. Właściciel zdecydował 2026-10-30, że strona nie ma być indeksowana, dlatego index.html zawiera meta robots noindex. To prośba do wyszukiwarek, a nie kontrola dostępu: adres strony pozostaje publiczny. Nagłówek strony mówi też wprost, że porady są sprawdzane ze źródłami maszynowo, przegląd trwa i nie zatwierdził ich lekarz ani prawnik (za zgodą właściciela z 2026-10-30). Odziedziczony sitemap.xml usunięto.

Prywatność i gotowość do publikacji

Adaptację przygotowywano i przeglądano z pomocą generatywnej AI. Konsultacja z agentem Prawnik AI nie jest przeglądem przez adwokata lub radcę prawnego. Historyczny run7 i jego liczba przyjętych raportów nie potwierdzają automatycznie aktualnego brzmienia porad: zmiana tekstu unieważnia odpowiednie pakiety audytu. Aktualne daty i zakres sprawdzenia pozostają przy poradach.

Publiczne informacje o opiekunie adaptacji, kanale korekt i działaniu czytnika mają jedno miejsce w sekcji „Wydanie, kontakt i prywatność”, publikowanej razem z czytnikiem. Właściciel zatwierdził oznaczenie opiekuna jako mikomiel, GitHub Issues do publicznych korekt i brak dodatkowej analityki. Nie oznacza to, że hosting nie przetwarza danych. Sekcja rozróżnia lokalne wyszukiwanie, pamięć podręczną przeglądarki, przetwarzanie przez GitHub Pages i publiczne zgłoszenia, również opracowywane z pomocą AI. Nie podawaj danych wrażliwych ani dokumentów indywidualnej sprawy.

To opis ustalonych funkcji i kanału kontaktu, nie deklaracja pełnej zgodności prawnej, braku przetwarzania przez GitHub ani indywidualnej porady. Nie przypisujemy opiekunowi fikcyjnej firmy, kwalifikacji zawodowych ani danych kontaktowych. Nie dodajemy formularza zgłoszeń, analityki ani banera zgody. Zmiana modelu przetwarzania wymaga ponownej oceny informacji. Treść sekcji staje się dostępna na stronie dopiero po odrębnym wdrożeniu przez właściciela; samo scalenie PR nie potwierdza aktywacji.

Warunki licencji

Tekst oryginału oraz polska adaptacja, w tym README i book/pl/, są udostępnione na CC BY 4.0. Możesz kopiować, adaptować i używać ich komercyjnie zgodnie z warunkami licencji. Zachowaj oznaczenie eternity4719, tytuł i link do HowToLiveBetter, link do licencji, informację o adaptacji i dokonanych zmianach. Nie sugeruj zatwierdzenia adaptacji przez autora. Nie ma gwarancji poprawności; pełne warunki i wyłączenia zawiera LICENSE. Prawa do znaków i materiałów osób trzecich nie wynikają automatycznie z tej licencji.

Kod czytnika i narzędzi jest na MIT. Pełne zawiadomienie Copyright (c) 2026 eternity4719 i warunki MIT pozostają bez zmian. Nie używamy odziedziczonych reklam, próśb o wpłaty ani grafik marki w polskim czytniku.