Ръководство за инсталиране

Две неща трябва да са активни на сайта ви: уведомлението, което посетителите ви виждат, и малък публичен файл, който декларира използването на ИИ (yoursite.com/.well-known/ai-disclosure.json). Тагът на скрипта се поставя веднъж, еднакъв е на всяка страница, а декларацията ви определя кои уведомления къде се показват. Изберете платформата си по-долу; за повечето отнема около десет минути.

1 · Покажете уведомленията

Банер и етикети за ИИ, които посетителите ви виждат на страницата.

2 · Публикувайте декларацията си

ai-disclosure.json, публичен файл, четим от вашия собствен домейн.

Готови сте, когато

инструментът за проверка показва Ниво 2 · Показано.

Изберете платформата си

WordPress

  1. Инсталирайте приставката

    В администрацията на WordPress: Plugins → Add New → Upload Plugin, изберете файла, който сте изтеглили по-долу, след което щракнете върху Activate.

    Изтеглете приставката AIDisclose (.zip)

  2. Оставете я да свърши и двете задачи

    Приставката показва уведомленията и публикува файла ви с декларация автоматично. Маркирайте съдържание от ИИ във всяка публикация или изображение с превключвателя ѝ „AI content“. Без редактиране на код.

  3. Проверете

    Готово, когато инструментът за проверка показва Ниво 2 · Показано.

    Стартирайте инструмента за проверка

Проверете

Стартирайте инструмента за проверка. Той потвърждава три неща: файлът ви с декларация е валиден, скриптът работи и уведомленията наистина се появяват на страницата. (За инженери: проверки C1, C3 и от C4 до C6.)

Стартирайте инструмента за проверка

Ако сайтът ви блокира нашия инструмент за проверка (AIDiscloseBot)

Сканиранията и заснеманията на доказателства идват от AIDiscloseBot/1.0. Той чете само публични страници: никога не влиза в профили, никога не изпраща формуляри и спазва robots.txt. Ако вашият 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 адреса с версия и генерирайте хеша от точния файл, който разгръщате:

shell
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Доставяйте файла сами (nginx / Apache)

За сървъри, които контролирате, доставяйте изтегления ai-disclosure.json директно:

nginx
location = /.well-known/ai-disclosure.json {
  alias /var/www/site/ai-disclosure.json;
  default_type application/json;
  add_header Cache-Control "max-age=3600";
}
Apache
Alias "/.well-known/ai-disclosure.json" "/var/www/site/ai-disclosure.json"
<Files "ai-disclosure.json">
  ForceType application/json
</Files>
Доставяйте хоствания в таблото файл от вашия собствен домейн

Вашият сървър препраща заявките за този един адрес към нас: вие редактирате файла в таблото за управление, а той продължава да се доставя от вашия домейн. Таблото ги показва предварително попълнени с ключа на вашия сайт.

nginx
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;
}
Cloudflare Worker
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 / vercel.json
# 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" }
] }