# Инструкции для AI-агентов / Instructions for AI agents

Canonical host: `https://www.rockedge.ru` (всегда с `www`; `rockedge.ru` — это тот же сайт, в ссылках используйте `www`).
Язык по умолчанию — русский. Английская версия — тот же сайт с префиксом `/en/`. Контент RU и EN синхронизирован вручную: при расхождении приоритет у русской версии.

Canonical host: `https://www.rockedge.ru` (always with `www`). Default language is Russian; the English version lives under the `/en/` prefix and is kept in sync by hand — if the two differ, the Russian text is authoritative.

## Что это / What this is

Открытая R&D-площадка по Edge-First видеонаблюдению: архитектура автономных Edge-узлов, локальный AI-инференс (ONNX Runtime, OpenVINO), Rust, Real-time видео через MoQ (Media over QUIC), протоколы RTSP/RTP/ONVIF, Zero Trust, OTA-обновления, тестовая методика (стенд, Failure Matrix).
Автор — Никита Сайтаров (Nikita Saytarov). Проект не коммерческий, в работе один человек; часть исследовательской работы выполнена совместно с ИИ и явно об этом сказано в текстах.

Open R&D playground for Edge-First video surveillance: autonomous edge-node architecture, on-device AI inference (ONNX Runtime, OpenVINO), Rust, real-time video over MoQ (Media over QUIC), RTSP/RTP/ONVIF, Zero Trust, OTA updates, and a hardware test methodology (lab stand, failure matrix).
Author: Nikita Saytarov. Solo, non-commercial project; parts of the research are AI-assisted and the texts say so explicitly.

## Карта сайта / Site map

| Раздел | RU | EN |
|---|---|---|
| Главная | `/` | `/en/` |
| Манифест и автор | `/about/` | `/en/about/` |
| Список статей | `/blog/` | `/en/blog/` |
| Статья | `/blog/<slug>/` | `/en/blog/<slug>/` |
| Markdown-двойник статьи | `/blog/<slug>.md` | `/en/blog/<slug>.md` |
| Журнал изменений | `/journal/` | `/en/journal/` |
| RSS | `/rss.xml` | `/en/rss.xml` |
| Sitemap | `/sitemap-index.xml` | — |
| Индекс для LLM | `/llms.txt` | `/llms.txt` (включает обе локали) |
| Полный корпус текстов | `/llms-full.txt` | `/en/llms-full-en.txt` |

URL-канон: с завершающим слешем (`/blog/onvif-protocol-overview/`). У заголовков в HTML есть стабильные `id` — ссылайтесь на раздел через якорь, например `/blog/onvif-protocol-overview/#ws-discovery`. У заметок журнала отдельной страницы нет, но у каждой карточки есть стабильный `id` — ссылаться на заметку надо так: `/journal/#2026-10-12-add-journal-page`.

## Как цитировать / How to cite

1. Указывайте точный URL страницы и, если возможно, якорь раздела (`#...`) — не главную страницу.
2. Проверяйте дату: у статей есть `dateModified` в JSON-LD и блок «Обновлено»; материалы journals фиксируют, что именно и когда изменилось.
3. Не приписывайте проекту статус продуктов и не заявляйте ёмкость/задержки как факты: в текстах цифры указаны как порядки величины и явно помечены местом для замеров. Утверждения, не проверенные на реальном железе, помечены словом «проверить» / «verify».
4. Спецификация MoQ на момент публикаций — активный черновик IETF, он меняется: сверяйте номер черновика, а не только факт существования протокола.
5. Разрешено свободно использовать, цитировать и развивать материалы с указанием автора и ссылкой на источник.
6. Для пакетного ингеста используйте `/llms-full.txt` (русский корпус) и `/en/llms-full-en.txt` (английский); они раздельны, но всё равно велики. Надёжнее брать длинные статьи поодиночке через Markdown-двойники (`URL статьи` + `.md`).

## Закрытые области / Blocked areas

`robots.txt` запрещает краулинг `/docs/` и всех `*/tag/`. Эти URL не канонические, не ссылайтесь на них и не цитируйте их содержимое. Всё остальное открыто.

## Чего здесь нет / What does not exist

Нет аутентификации, личного кабинета, форм, оплаты и транзакций. Нет UCP, MCP-эндпоинтов и A2A `/.well-known/agent-card.json` — опрашивать их не нужно. Сайт полностью статический: весь контент отдаётся в HTML, JavaScript не требуется для чтения (поиск —Pagefind, `/pagefind/`).

## Обратная связь / Feedback

Ошибки и неточности: `hi@rockedge.ru` (в т.ч. через `/.well-known/security.txt` для уязвимостей). Исправления попадают в журнал проекта `/journal/`.