Kolofon: Jak działa ta strona

TL;DR — Statyczne Astro na Cloudflare, dwa celowo rozdzielone Workery dla części dynamicznych, prawdziwe dane albo jasno oznaczony brak dostępności, uczciwe kody statusu oraz system projektowy, który nadaje stronie wygląd strony wyników wyszukiwania. To strona o powstawaniu studium przypadku edge SEO, którym stała się ta witryna.

Czym ta strona jest (a czym nie jest)

Kolofon to zapis powstawania i źródeł — wyjaśnia technologię, systemy oraz osoby stojące za opublikowanym dziełem, tak jak kolofon książki podaje jej krój pisma i drukarza. Nie zastępuje stron, które mają znaczenie prawne lub biograficzne: strona About opisuje, kim jestem, Privacy Policy wyjaśnia, jakie dane są zbierane i dlaczego, a Terms of Use określają zasady korzystania z witryny. Ta strona dokumentuje wyłącznie sposób budowy i działania witryny; jeśli któreś z poniższych twierdzeń pokrywa się z jedną z tamtych stron, to właśnie tamta strona jest źródłem nadrzędnym.

Stos technologiczny

Ta witryna używa statycznego wyjścia Astro do generowania stron HTML podczas builda. Dowód potwierdzający to twierdzenie Astro prerenders pages statically by default unless on-demand rendering is enabled. Zakres: Astro rendering modes used by this site's implementation. Poziom ufności: wysoki · Zweryfikowano: 2026-07-14 Astro: On-demand rendering Dostarczanie statyczne może ograniczać zależności czasu wykonania, choć wyniki SEO nadal zależą od wyrenderowanej treści, linków i konfiguracji technicznej. Dowód potwierdzający to twierdzenie Static delivery is an implementation choice; search performance still depends on accessible content, links, and other SEO fundamentals. Zakres: Editorial conclusion combining the site's stack with Google's general SEO guidance; static generation alone does not guarantee rankings. Poziom ufności: medium · Zweryfikowano: 2026-07-14 Google: SEO Starter Guide

• Astro generuje artykuły, glosariusz, huby, powłoki narzędzi, dane strukturalne, indeksy wyszukiwania i agentów oraz odpowiedniki Markdown podczas wdrażania. Korpus zmienia się zbyt szybko, aby ręcznie utrzymywana liczba stron była użyteczna.
• Cloudflare Workers Static Assets serwuje ten build z krawędzi. Konfiguracja witryny kieruje przez kod wyłącznie ścieżki dynamiczne i obsługiwane specjalnie; zwykłe żądania stron i zasobów omijają obliczenia Workera. Konfiguracja jest źródłem prawdy dla tej granicy tras, a nie skopiowana lista na tej stronie.
• Worker witryny obsługuje sprawy redakcyjne i społecznościowe: kontakt, pytania i odpowiedzi czytelników, reakcje, newsletter, telemetrię wyszukiwania, warstwę ekspertów i operacje właściciela.
• Osobno wdrażany Worker produktu obsługuje wykonywanie bezpłatnych narzędzi i trwałość danych produktu. Worker witryny dociera do niego przez service binding Cloudflare, dzięki czemu przeglądarki zachowują adresy /api/ w tym samym originie, bez zacierania obu granic bezpieczeństwa i danych.

Dwie płaszczyzny danych, celowo rozdzielone

Workery witryny i produktu mają każdy własną bazę danych D1 i własną przestrzeń nazw KV, połączone przez Cloudflare service binding. D1 witryny zawiera rekordy społecznościowe i redakcyjne; D1 produktu zawiera dane użycia narzędzi, oceny, zgłoszenia błędów, prośby o funkcje, zadania badawcze i dane monitoringu. KV służy do ograniczonych pamięci podręcznych i liczników awaryjnych.

R2 również jest podzielone według przeznaczenia. Zasobnik multimediów witryny przechowuje zdjęcia ekspertów i odpowiedzi audio. Prywatne zasobniki kopii zapasowych witryny i produktu otrzymują zaplanowane eksporty D1 według osobnych harmonogramów, a retencja i stan zdrowia są widoczne w operacjach właściciela. Worker produktu ma także ograniczone Workers AI, Browser Rendering, natywne bindingi limitowania szybkości oraz Durable Object koordynujący budżet renderowania w przeglądarce. Funkcje z niedostępnymi bindingami lub wyczerpanymi budżetami zwracają jawny stan niedostępności zamiast wymyślonego wyniku.

Ta sekcja celowo pomija: nazwy bindingów, identyfikatory zasobników, schematy baz danych, dane uwierzytelniające, wewnętrzne endpointy i harmonogramy kopii zapasowych. Podanie publicznego przeznaczenia każdej usługi pomaga zrozumieć witrynę; podanie jej prywatnej topologii głównie pomagałoby atakującemu, dlatego zgodnie z zasadami pozostaje poza publiczną stroną, a nie wskutek przeoczenia.

Dlaczego podejście statyczne to stanowisko SEO, a nie tylko wybór hostingu

Każda indeksowalna strona redakcyjna jest dostarczana jako w pełni wyrenderowany dokument HTML z prawdziwym kodem statusu. Interaktywne wyniki narzędzi mogą działać w przeglądarce lub wywoływać Workera, ale przeznaczenie i instrukcje narzędzia nie zależą od renderowania po stronie klienta, aby w ogóle istnieć. Strona 404 zwraca rzeczywiste 404, usunięte strony mogą zwracać rzeczywiste 410, a /coffee zwraca rzeczywiste 418, ponieważ czajniczek nie może zaparzyć kawy. Właściwości dostępności i TTFB, które sprawiają, że witryna jest przyjemna dla użytkowników, są tymi samymi właściwościami, dzięki którym jest tania dla crawlerów.

Zasada uczciwości danych

Metryki produkcyjne widoczne dla odwiedzających pochodzą ze wskazanego źródła: liczba słów i czas czytania z treści artykułu, liczby reakcji z D1, dane o crawlach botów z analityki strefy Cloudflare, a własne Core Web Vitals z przeglądarki za pośrednictwem PerformanceObserver. Narzędzie może zaoferować oznaczony przykład lub fixture objaśniający wynik, ale nie jest on przedstawiany jako pomiar na żywo. Funkcje wymagające niedostępnych danych uwierzytelniających lub mające wyczerpany budżet informują o tym albo ukrywają dotknięty wynik, zamiast po cichu wymyślać dane produkcyjne.

Proweniencja redakcyjna

System treści traktuje proweniencję AI jako stan przeglądu, a nie ozdobę. Artykuł w całości wygenerowany przez AI otrzymuje etykietę na poziomie artykułu; późniejsza sesja AI dotycząca wcześniej zrecenzowanej treści ponownie oznacza tylko zmieniony lens lub zmienione lensy, chyba że sesja obejmuje cały artykuł. Metadane rewizji AI rejestrują sesję i jej datę. Dopóki pozostaje jakakolwiek etykieta AI, artykuł pokazuje autorstwo AI zamiast przypisywać treść Patrickowi i jest wyłączony ze zbiorczych liczników treści oraz powiązanych statystyk całej witryny. Tylko przegląd lub rewizja dokonane przez człowieka usuwa etykietę; kolejna sesja AI tego nie robi.

Ten kontrakt nie poświadcza, że nieoznaczona treść jest wolna od błędów. Zapobiega temu, by autorstwo, status przeglądu i publiczne liczniki po cichu zawyżały zakres tego, co zostało sprawdzone przez człowieka. Terms of Use określają granicę widoczną dla czytelnika, a wspólny helper etykiet w repozytorium utrzymuje tę samą zasadę we wszystkich odbiorcach.

Jawne interfejsy dla agentów

Crawlery AI mogą korzystać z tego samego wyrenderowanego HTML co wszyscy inni, ale nie muszą już go scrapować. Każdy opublikowany artykuł ma wygenerowany odpowiednik index.md i kontrolkę „Copy as Markdown” (tłumaczenie) „Kopiuj jako Markdown”. /llms.txt wskazuje korpus, /llms-full.txt udostępnia zbiorczy Markdown, /agent-index.json opisuje kompletny publiczny korpus pobierania, a /content-graph.json publikuje graf linków wewnętrznych. Ograniczony limitem szybkości, tylko do odczytu serwer MCP udostępnia wyszukiwanie treści, pobieranie artykułów, taksonomię i niewielki zestaw ograniczonych narzędzi diagnostycznych. Aktualny skład i instrukcje połączenia znajdują się na stronie Dla agentów. Nic z tego nie jest przedstawiane jako gwarancja indeksowania, cytowania ani rankingu — to stabilny kontrakt pobierania, a nie twierdzenie SEO.

Nie jest natomiast włączona negocjacja Accept: text/markdown pod tym samym adresem URL za pośrednictwem Cloudflare Markdown for Agents. Jawne adresy Markdown są dziś stabilnym publicznym kontraktem; jeśli negocjacja treści zostanie kiedyś włączona, może działać przed tym samym wygenerowanym źródłem, zamiast tworzyć drugą kopię redakcyjną.

Narzędzia i przegląd ekspertów

Bezpłatne narzędzia SEO obejmują lokalne w przeglądarce parsery, walidatory i kalkulatory, a także ograniczone pobrania na żywo, porównania renderowania, odczyty danych polowych oraz operacje wspomagane przez AI. Wspólne rejestry reguł utrzymują zgodność wyników przeglądarki, Workera, trybu zbiorczego i MCP tam, gdzie narzędzie ma więcej niż jeden interfejs.

Publiczna warstwa ekspertów zamienia artykuły w dyskusje zakotwiczone w tekście. Zweryfikowani eksperci mogą dołączać notatki do stabilnych identyfikatorów akapitów i odpowiadać na pytania; zaufane wypowiedzi są publikowane bezpośrednio, a pozostałe trafiają do moderacji. Opublikowane notatki i odpowiedzi są wbudowane w wynik artykułu oraz jego dane strukturalne, zamiast być ładowane jako niedająca się indeksować dopowiedź.

System projektowy natywny dla wyszukiwania

Witryna jest stylizowana jak medium, w którym działa: strumień strony głównej, hub treści i wyszukiwanie w witrynie renderują się jako wyniki SERP (zielony breadcrumb, niebieski tytuł, fragment), artykuły zawierają autoreferencyjny podgląd “In search results” (Wyniki wyszukiwania), TL;DR-y są stylizowane na featured snippets, a pytania i odpowiedzi czytelników zwijają się jak People Also Ask. Pięć skórek (Clean, Magazine, Neo-Brutalist, Punk, Cyberpunk) przestylizowuje wszystko przez własne właściwości CSS — promień, obramowania, cienie i typografię — dzięki czemu komponent napisany raz względem tokenów działa we wszystkich pięciu.

Budżet wydajności

Fonty są ładowane przez API Fonts Astro z fallbackami o dostosowanym rozmiarze, dzięki czemu podmiany nie przesuwają układu; preload otrzymuje tylko krój wyświetlany stojący za zwykłym elementem LCP. Osadzenia zewnętrzne oraz własne wywołania /api/* witryny w karcie danych SEO są ładowane leniwie dopiero po otwarciu karty. Speculation Rules prerenderuje linki w tej samej witrynie po najechaniu w Chromium. Chipy Core Web Vitals w pasku zdrowia każdego artykułu są dowodami — to prawdziwe liczby z Twojej sesji.

Źródła i podziękowania

• Właściciel i autor: Patrick Stox pisze i utrzymuje tę witrynę; strona About zawiera informacje o jego tle.
• Framework i platforma: Astro do budowania; Cloudflare Workers, D1, KV i R2 do warstwy wykonawczej i danych.
• Protokół agentów: specyfikacja Model Context Protocol, dla opisanego wyżej serwera MCP.
• Współtwórcy: zweryfikowani eksperci z warstwy ekspertów, którzy dodają notatki i odpowiedzi do fragmentów artykułów, oznaczani nazwiskiem tam, gdzie publikują.
• Źródła tej strony: twierdzenia o wdrożonym zachowaniu są sprawdzane względem źródeł i konfiguracji tego repozytorium; twierdzenia o zachowaniu platform są sprawdzane względem oficjalnej dokumentacji Astro i Cloudflare, do której prowadzą linki w całym tekście. Wymienienie technologii jest rzeczowym podziękowaniem, a nie rekomendacją ani twierdzeniem o wyniku SEO.

Ta strona jest okresowo sprawdzana względem działającego repozytorium i bieżącej dokumentacji platform, zamiast pozostawać bez aktualizacji; data updated poniżej odzwierciedla ostatnią taką sesję.

Easter eggi są elementami nośnymi

/robots.txt to jeden plik, który jest jednocześnie prawidłowym robots.txt i stroną internetową (negocjacja treści na etykiecie, ciało identyczne bajt po bajcie). Konsola ma easter egga. /coffee to działająca demonstracja HTCPCP. Każdy z tych elementów istnieje po to, by uczyć mechanizmu, z którym się bawi — co w miniaturze stanowi całą tezę witryny.

TL;DR — Utrzymuj witrynę z zachowaniem jawnych granic: statyczny HTML jako domyślna ścieżka, praca dynamiczna w odpowiednim Workerze i planie danych, uczciwe stany braku zależności oraz zsynchronizowane kontrakty crawlerów, agentów, pochodzenia i wydajności.

Wydawaj osobno warstwy statyczne i dynamiczne

Artefakt statyczny jest publiczną bazą. Sprawdź pełny HTML i czy zwykłe zasoby nie uruchamiają przypadkiem Workera. Redakcja i społeczność należą do Site Worker, narzędzia i dane produktu do Product Worker, a service binding pozostaje interfejsem.

Zachowaj granice danych i ujawnień

Rozdziel ścieżki D1, KV i kopii zapasowych witryny i produktu, a media ekspertów trzymaj w przeznaczonym R2. Opisuj cel publiczny bez ujawniania danych dostępowych, prywatnych nazw bindingów, identyfikatorów, schematów, endpointów i harmonogramów.

Testuj uczciwość jako cechę wydania

Ustal źródło każdej widocznej wartości. Metryki live pochodzą z nazwanej produkcji, przykłady pozostają oznaczone, a brak zależności lub budżetu daje jawny stan. Sprawdź rzeczywiste HTTP: poprawne strony, 404 dla brakujących, 410 dla celowo usuniętych i tylko /coffee z zamierzonym 418.

Synchronizuj pobieranie i pochodzenie

Zmiana samego HTML nie wystarcza. Sprawdź razem bliźniaczy Markdown, indeksy agentów, graf treści, dane strukturalne i MCP tylko do odczytu. Zachowaj etykiety AI i metadane rewizji do przeglądu przez człowieka.

Lista operatora

• Sprawdź routing zasobów i odpowiedzialnego Workera.
• Przetestuj same-origin /api/ przez service binding.
• Wymuś jawne stany niedostępności.
• Porównaj HTML, Markdown, indeksy, graf i dane strukturalne.
• Sprawdź Core Web Vitals oraz budżety fontów, embedów, API i prerenderu.
• Ponownie przejrzyj About, Privacy i Terms, jeśli zmienia się zakres.

• Zakres: zapis powstawania i źródeł, odrębny od stron About, Privacy i Terms, które pozostają nadrzędne w przypadku nakładających się twierdzeń.
• Stos: statyczny build Astro serwowany przez Cloudflare Workers Static Assets; zwykły ruch statyczny omija obliczenia Workera.
• Podział czasu wykonania: Worker witryny obsługuje redakcyjne i społecznościowe API oraz przekazuje ścieżki produktu przez service binding do osobno wdrażanego Workera produktu.
• Warstwa danych: osobne magazyny D1/KV witryny i produktu; R2 dla mediów ekspertów i prywatnych zaplanowanych kopii zapasowych; ograniczone Workers AI, Browser Rendering, bindingi limitowania szybkości i Durable Object po stronie produktu.
• Właściwości SEO: w pełni wyrenderowany HTML redakcyjny, uczciwe kody statusu (rzeczywiste 404/410/418), prerenderowanie Speculation Rules i JSON-LD dla każdego artykułu; interaktywne wyniki narzędzi mogą korzystać z wykonania w przeglądarce lub Workerze.
• Uczciwość danych: metryki produkcyjne wskazują swoje prawdziwe źródło; przykłady są oznaczane, a niedostępne funkcje na żywo ujawniają ten stan zamiast fabrykować wyniki produkcyjne.
• Proweniencja redakcyjna: treści wygenerowane lub poprawione przez AI pozostają oznaczone do czasu przeglądu przez człowieka, podczas oznaczenia pokazują autorstwo AI i nie wchodzą w zbiorcze liczniki treści.
• Dostęp agentów: HTML oraz Markdown dla każdego artykułu, zbiorcze i strukturalne indeksy, graf treści i tylko do odczytu serwer MCP. Negocjacja Markdown pod tym samym adresem URL nie jest włączona.
• Systemy publiczne: platforma bezpłatnych narzędzi oraz moderowane notatki i odpowiedzi ekspertów dołączane do stabilnych fragmentów artykułów.
• Projekt: motyw natywny dla wyszukiwania (strumienie stylizowane na SERP, TL;DR-y jak featured snippets, pytania i odpowiedzi w stylu PAA) z pięcioma skórkami sterowanymi tokenami.
• Wydajność: fallbacki fontów o dostosowanym rozmiarze, preloady wyłącznie dla LCP, leniwe osadzania zewnętrzne i widoczne chipy CWV z bieżącej sesji.
• Granica ujawniania: publiczne przeznaczenia usług (D1, KV, R2, service bindings, MCP), ale nie nazwy bindingów, identyfikatory zasobników, schematy, dane uwierzytelniające ani harmonogramy kopii zapasowych.
• Źródła i podziękowania: Patrick Stox jako właściciel/autor, Astro i Cloudflare jako platforma, specyfikacja Model Context Protocol dla dostępu agentów oraz zweryfikowani eksperci, którzy wnoszą notatki i odpowiedzi.

Dziennik zmian