Przewodnik instalacji
Dwie rzeczy muszą działać na Twojej witrynie: komunikat, który widzą odwiedzający, oraz mały publiczny plik deklarujący Twoje użycie AI (twojawitryna.pl/.well-known/ai-disclosure.json). Wybierz swoją platformę poniżej; większość zajmuje około dziesięciu minut.
Baner i etykiety AI, które odwiedzający widzą na stronie.
ai-disclosure.json, publiczny plik odczytywalny z Twojej własnej domeny.
weryfikator pokazuje Poziom 2 · Wyświetlane.
Wybierz platformę
WordPress
Zainstaluj wtyczkę
W panelu WordPressa: Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer, wybierz plik pobrany poniżej, a następnie kliknij Włącz.
Pozwól jej zrobić obie rzeczy
Wtyczka wyświetla komunikaty i automatycznie publikuje Twój plik deklaracji. Oznaczaj treści AI w dowolnym wpisie lub obrazie przełącznikiem „Treść AI”. Bez edycji kodu.
-
Zweryfikuj
Gotowe, gdy weryfikator pokazuje Poziom 2 · Wyświetlane.
Uruchom weryfikator
Shopify
Dodaj snippet
Sklep online → Szablony → ⋯ → Edytuj kod → theme.liquid: wklej to tuż przed </body>. Zwróć uwagę na adres w pierwszej linii: Shopify nie może hostować plików w katalogu głównym Twojej domeny, więc snippet odczytuje deklarację z naszej hostowanej kopii.
theme.liquid <script>window.AIDiscloseConfig = { manifestUrl: "https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY" };</script> <script src="https://cdn.aidisclose.io/v0/aidisclose.js" defer></script>Podlinkuj deklarację
Wklej tę linię wewnątrz <head> w tym samym pliku. Twój panel pokazuje oba bloki wstępnie wypełnione Twoim kluczem witryny.
<head> <link rel="ai-disclosure" href="https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">To metoda dopuszczona przez specyfikację.
-
Zweryfikuj
Gotowe, gdy weryfikator pokazuje Poziom 1 · Zadeklarowano z adnotacją. To oczekiwany wynik na tej platformie i jest on zgodny z wymogami.
Uruchom weryfikator
Webflow
Dodaj snippet
Site settings → Custom code → Footer code: wklej blok snippetu poniżej, a następnie opublikuj.
Footer code <script>window.AIDiscloseConfig = { manifestUrl: "https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY" };</script> <script src="https://cdn.aidisclose.io/v0/aidisclose.js" defer></script>Podlinkuj deklarację
W Head code dodaj linię z linkiem do deklaracji (drugi blok poniżej). Wolisz serwować plik z własnej domeny? Użyj proxy z sekcji Zaawansowane, jeśli Twój DNS przechodzi przez Cloudflare.
Head code <link rel="ai-disclosure" href="https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">To metoda dopuszczona przez specyfikację.
-
Zweryfikuj
Gotowe, gdy weryfikator pokazuje Poziom 1 · Zadeklarowano z adnotacją. To oczekiwany wynik na tej platformie i jest on zgodny z wymogami.
Uruchom weryfikator
Squarespace
Dodaj snippet
Settings → Advanced → Code Injection → Footer: wklej blok snippetu poniżej. Wstrzykiwanie kodu wymaga planu Business.
Footer <script>window.AIDiscloseConfig = { manifestUrl: "https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY" };</script> <script src="https://cdn.aidisclose.io/v0/aidisclose.js" defer></script>Podlinkuj deklarację
W Header injection dodaj linię z linkiem do deklaracji (drugi blok poniżej).
Header <link rel="ai-disclosure" href="https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">To metoda dopuszczona przez specyfikację.
-
Zweryfikuj
Gotowe, gdy weryfikator pokazuje Poziom 1 · Zadeklarowano z adnotacją. To oczekiwany wynik na tej platformie i jest on zgodny z wymogami.
Uruchom weryfikator
Google Tag Manager
Utwórz tag
Nowy tag → Konfiguracja tagu → Niestandardowy kod HTML → wklej snippet. Reguła uruchamiania: All Pages (Page View). Nie używaj reguły opóźnionej ani opartej na przewijaniu: artykuł 50 wymaga komunikatu od pierwszej ekspozycji. Opublikuj obszar roboczy.
Custom HTML <script>window.AIDiscloseConfig = { manifestUrl: "/.well-known/ai-disclosure.json" };</script> <script src="https://cdn.aidisclose.io/v0/aidisclose.js" defer></script>Opublikuj też deklarację
Tag Manager obsługuje tylko komunikaty. Twój plik deklaracji nadal musi zostać opublikowany: wykonaj krok dla swojej platformy w pozostałych zakładkach albo w zakładce Kod własny, jeśli prowadzisz własną witrynę.
-
Zweryfikuj
Gotowe, gdy weryfikator pokazuje Poziom 2 · Wyświetlane.
Uruchom weryfikator
Kod własny
Dodaj snippet
Przed </body> na każdej stronie. Zabezpieczenia produkcyjne (przypięcie wersji, SRI) znajdziesz w sekcji Zaawansowane.
HTML <script>window.AIDiscloseConfig = { manifestUrl: "/.well-known/ai-disclosure.json" };</script> <script src="https://cdn.aidisclose.io/v0/aidisclose.js" defer></script>Serwuj plik deklaracji
ai-disclosure.json musi być odczytywalny pod /.well-known/ w Twojej domenie. Na Vercel lub Netlify po prostu dodaj plik do repozytorium. Konfiguracje nginx i Apache znajdziesz w sekcji Zaawansowane.
Vercel / Netlify # Vercel / Netlify: commit the file, done public/.well-known/ai-disclosure.json-
Zweryfikuj
Gotowe, gdy weryfikator pokazuje Poziom 2 · Wyświetlane.
Uruchom weryfikator
Zweryfikuj
Uruchom weryfikator. Potwierdza on trzy rzeczy: Twój plik deklaracji jest ważny, snippet działa, a komunikaty rzeczywiście pojawiają się na stronie. (Dla inżynierów: kontrole C1, C3 oraz C4 do C6.)
Zaawansowane
Przypnij skrypt do dokładnej wersji (SRI)
Hash integralności w znaczniku script sprawia, że przeglądarka odmawia uruchomienia zmodyfikowanego pliku. Przypnij wersjonowany adres URL i wygeneruj hash z dokładnie tego pliku, który wdrażasz:
curl -sO https://cdn.aidisclose.io/v0/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Serwuj plik samodzielnie (nginx / Apache)
Na serwerach, które kontrolujesz, serwuj pobrany plik ai-disclosure.json bezpośrednio:
location = /.well-known/ai-disclosure.json {
alias /var/www/site/ai-disclosure.json;
default_type application/json;
add_header Cache-Control "max-age=3600";
}
Alias "/.well-known/ai-disclosure.json" "/var/www/site/ai-disclosure.json"
<Files "ai-disclosure.json">
ForceType application/json
</Files>
Serwuj plik hostowany w panelu z własnej domeny
Twój serwer przekazuje żądania tego jednego adresu do nas: edytujesz plik w panelu, a on nadal jest serwowany z Twojej domeny. Panel pokazuje te bloki wstępnie wypełnione Twoim kluczem witryny.
location = /.well-known/ai-disclosure.json {
proxy_pass https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY;
proxy_set_header Host api.aidisclose.io;
proxy_ssl_server_name on;
}
export default {
async fetch(request) {
const url = new URL(request.url);
if (url.pathname === "/.well-known/ai-disclosure.json") {
return fetch("https://api.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY");
}
return fetch(request);
}
};
Jeśli Twoja witryna blokuje nasz weryfikator (AIDiscloseBot)
Skanowania i zapisy dowodów pochodzą od AIDiscloseBot/1.0. Czyta on wyłącznie strony publiczne: nigdy się nie loguje, nie wysyła formularzy i przestrzega robots.txt. Jeśli Twój robots.txt lub ochrona przed botami blokuje nieznane roboty, zezwól mu jawnie:
User-agent: AIDiscloseBot
Allow: /
Czy zezwolenie to ryzyko? Nie. Wpis allow w robots.txt nie daje żadnego dostępu. Mówi jedynie uprzejmym robotom, że mogą czytać strony, które i tak są publiczne. Każdy może podrobić ciąg User-Agent, ale podszywający się nie zyska nic ponad to, co Twoje publiczne strony już udostępniają.
Jeśli filtrujesz ruch przez WAF lub menedżera botów, nigdy nie zezwalaj wyłącznie na podstawie User-Agent. Połącz to z weryfikacją źródła. Publikujemy tożsamość naszego robota oraz zakresy wyjściowych adresów IP w miarę ich udostępniania pod adresem aidisclose.io/bot.json.