Ръководство за инсталиране
Две неща трябва да са активни на сайта ви: уведомлението, което посетителите ви виждат, и малък публичен файл, който декларира използването на ИИ (yoursite.com/.well-known/ai-disclosure.json). Тагът на скрипта се поставя веднъж, еднакъв е на всяка страница, а декларацията ви определя кои уведомления къде се показват. Изберете платформата си по-долу; за повечето отнема около десет минути.
Банер и етикети за ИИ, които посетителите ви виждат на страницата.
ai-disclosure.json, публичен файл, четим от вашия собствен домейн.
инструментът за проверка показва Ниво 2 · Показано.
Изберете платформата си
WordPress
Инсталирайте приставката
В администрацията на WordPress: Plugins → Add New → Upload Plugin, изберете файла, който сте изтеглили по-долу, след което щракнете върху Activate.
Оставете я да свърши и двете задачи
Приставката показва уведомленията и публикува файла ви с декларация автоматично. Маркирайте съдържание от ИИ във всяка публикация или изображение с превключвателя ѝ „AI content“. Без редактиране на код.
-
Проверете
Готово, когато инструментът за проверка показва Ниво 2 · Показано.
Стартирайте инструмента за проверка
Shopify
Добавете скрипта
Online Store → Themes → ⋯ → Edit code → theme.liquid: поставете този един таг непосредствено преди </body>. theme.liquid е оформлението, през което се показва всяка страница, така че едно поставяне покрива целия магазин. Shopify не може да хоства файлове в корена на домейна ви, затова тагът носи ключа на вашия сайт в AIDisclose (data-aidisclose) и зарежда манифеста, който хостваме за вас.
theme.liquid <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>Свържете декларацията си
Поставете тази връзка в <head> в същия файл. Таблото ви за управление показва и двата реда, предварително попълнени с ключа на вашия сайт.
<head> <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Това е позволен метод съгласно спецификацията.
-
Проверете
Готово, когато инструментът за проверка показва Ниво 1 · Декларирано с бележка. Това е очакваният резултат на тази платформа и той е в съответствие.
Стартирайте инструмента за проверка
Webflow
Добавете скрипта
Site settings → Custom code → Footer code: поставете блока със скрипта по-долу, след което Publish. Персонализираният код на ниво сайт се зарежда на всяка страница.
Footer code <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>Свържете декларацията си
В Head code добавете реда с връзката към декларацията (втория блок по-долу). Предпочитате да доставяте файла от собствения си домейн? Използвайте прокси сървъра в раздела „Разширени настройки“, ако вашият DNS минава през Cloudflare.
Head code <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Това е позволен метод съгласно спецификацията.
-
Проверете
Готово, когато инструментът за проверка показва Ниво 1 · Декларирано с бележка. Това е очакваният резултат на тази платформа и той е в съответствие.
Стартирайте инструмента за проверка
Squarespace
Добавете скрипта
Settings → Advanced → Code Injection → Footer: поставете блока със скрипта по-долу. Инжектирането на код важи за всяка страница. Изисква плана Business.
Footer <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>Свържете декларацията си
В Header injection добавете реда с връзката към декларацията (втория блок по-долу).
Header <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Това е позволен метод съгласно спецификацията.
-
Проверете
Готово, когато инструментът за проверка показва Ниво 1 · Декларирано с бележка. Това е очакваният резултат на тази платформа и той е в съответствие.
Стартирайте инструмента за проверка
Google Tag Manager
Създайте тага
New tag → Tag configuration → Custom HTML → поставете скрипта. Triggering: All Pages (Page View). Не използвайте забавен активатор или активатор при превъртане: правилата за оповестяване изискват уведомлението от първото излагане. Публикувайте работната област.
Custom HTML <script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>Публикувайте и декларацията си
Tag Manager се грижи само за уведомленията. Файлът ви с декларация все още трябва да бъде публикуван: следвайте стъпката за вашата платформа в другите раздели или раздела Персонализиран код, ако управлявате собствен сайт.
-
Проверете
Готово, когато инструментът за проверка показва Ниво 2 · Показано.
Стартирайте инструмента за проверка
Персонализиран код
Добавете скрипта
Веднъж в шаблона или оформлението на сайта си, преди </body>, за да се доставя с всяка страница. Обезопасяването за продукция (фиксиране на версията, SRI) е в раздела „Разширени настройки“.
HTML <script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>Доставете файла с декларацията
ai-disclosure.json трябва да е четим на /.well-known/ във вашия домейн. На Vercel или Netlify качете файла в хранилището. Ако вашият фреймуърк пренасочва всеки маршрут към index.html, този файл се нуждае от изключение: вижте Едностранични приложения в раздела Разширени настройки. Конфигурациите за nginx и Apache също са в раздела Разширени настройки.
Vercel / Netlify # Vercel / Netlify: commit the file public/.well-known/ai-disclosure.json # SPA that rewrites every route to index.html? # Exclude /.well-known/ from the rewrite (see Advanced).-
Проверете
Готово, когато инструментът за проверка показва Ниво 2 · Показано.
Стартирайте инструмента за проверка
Проверете
Стартирайте инструмента за проверка. Той потвърждава три неща: файлът ви с декларация е валиден, скриптът работи и уведомленията наистина се появяват на страницата. (За инженери: проверки C1, C3 и от C4 до C6.)
Ако сайтът ви блокира нашия инструмент за проверка (AIDiscloseBot)
Сканиранията и заснеманията на доказателства идват от AIDiscloseBot/1.0. Той чете само публични страници: никога не влиза в профили, никога не изпраща формуляри и спазва robots.txt. Ако вашият robots.txt или защита срещу ботове блокира непознати обхождащи роботи, разрешете го изрично:
User-agent: AIDiscloseBot
Allow: /
Рисковано ли е да го разрешите? Не. Разрешение в robots.txt не дава достъп. То само указва на добронамерените ботове, че могат да четат страници, които вече са публични. Всеки може да фалшифицира низа User-Agent, но фалшификаторът не печели нищо повече от това, което публичните ви страници вече дават.
Ако контролирате трафика с WAF или мениджър на ботове, никога не разрешавайте само въз основа на User-Agent. Съчетайте го с проверка на източника. Публикуваме самоличността на обхождащия ни робот и изходящите диапазони от IP адреси, докато се предоставят, на aidisclose.io/bot.json.
Разширени настройки
Theming with CSS variables, custom copy, single-page-app setup, and the full option reference are in the snippet reference.
Заключете скрипта към точна версия (SRI)
Хеш за цялост в тага на скрипта кара браузъра да откаже да изпълни променен файл. Фиксирайте URL адреса с версия и генерирайте хеша от точния файл, който разгръщате:
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Доставяйте файла сами (nginx / Apache)
За сървъри, които контролирате, доставяйте изтегления ai-disclosure.json директно:
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>
Доставяйте хоствания в таблото файл от вашия собствен домейн
Вашият сървър препраща заявките за този един адрес към нас: вие редактирате файла в таблото за управление, а той продължава да се доставя от вашия домейн. Таблото ги показва предварително попълнени с ключа на вашия сайт.
location = /.well-known/ai-disclosure.json {
proxy_pass https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY;
proxy_set_header Host cdn.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://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY");
}
return fetch(request);
}
};
Едностранични приложения и статични сървъри
Фреймуърците, които пренасочват всеки маршрут към index.html, както и някои статични сървъри, прихващат /.well-known/ai-disclosure.json и връщат HTML на приложението ви със статус 200. Файлът изглежда качен, но инструментът за проверка чете HTML вместо манифеста. Две решения: изключете /.well-known/ от всеобхватното пренасочване, така че статичният файл да се доставя с тип application/json, или добавете data-aidisclose="YOUR_SITE_KEY" към тага на скрипта, за да се зареди хостваният от AIDisclose манифест и доставянето на файла да се пропусне изцяло.
# netlify.toml: serve the real file before the SPA fallback
[[redirects]]
from = "/*"
to = "/index.html"
status = 200
force = false # a real file at the path wins over this fallback
# vercel.json: rewrite everything EXCEPT /.well-known to the app
{ "rewrites": [
{ "source": "/((?!\.well-known/).*)", "destination": "/index.html" }
] }