# Обработка данных

Актуально для расширения **1.4.5** и помощника **1.3.2**. Исходники доступны для просмотра,
условия использования собственного кода ограничены [лицензией](LICENSE).
У проекта нет собственного сервера обработки видео, аккаунтов, телеметрии, рекламы или аналитики.
Это не означает отсутствие обработки данных: необходимые сведения используются на вашем компьютере,
а запросы к YouTube и источникам обновлений идут через интернет.

## Какие данные используются

| Данные | Для чего и где |
| --- | --- |
| Ссылка на выбранный ролик, ID, название, канал, доступные дорожки | Получение качества и скачивание. Расширение передаёт выбранную ссылку локальному помощнику через Native Messaging. Метаданные обрабатываются в памяти; завершённые операции попадают в локальную историю. |
| Качество, формат, кодек, папка, своё имя файла, тема и состояние мастера | Сохранённые настройки в `chrome.storage.local` текущего профиля. Синхронизация через `storage.sync` не используется. |
| История и состояние операций | Расширение сохраняет до 30 последних операций в `chrome.storage.local`: название, ссылку, состояние, результат, путь и текст ошибки при её наличии. Помощник отдельно сохраняет до 30 успешно завершённых загрузок в своей папке данных для истории и «Показать файл». Разработчику эти записи не отправляются. |
| Название GPU, проверенные кодеки, версии компонентов | Проверка локального оборудования и программ, выбор рабочего режима конвертации и показ статуса. Не отправляются разработчику. |
| Настройка и время проверки обновлений | Локальный `update-settings.json` помощника. По умолчанию автоматическое обновление включено. |
| Cookies YouTube — только после согласия | Необязательная авторизация загрузчика в текущем профиле. Передаются локальному помощнику, затем используются yt-dlp в запросах к YouTube. Не пишутся в файлы cookies, настройки или историю; остаются в памяти на время обработки запроса. |

Скачивание и обработка выполняются в выбранной рабочей папке, в подпапках `.ytdl-*`.
При сохранении результата на другом диске временный файл создаётся также в папке сохранения.
Помощник очищает их по окончании операции; после аварийного завершения остатки могут сохраниться.
Готовые видео и аудио остаются там, куда вы указали.

## Разрешения расширения

| Разрешение | Назначение |
| --- | --- |
| `nativeMessaging` | Связь с установленным локальным помощником. Браузер запускает его по зарегистрированному имени; HTTP-сервер на локальном порту для этой связи не нужен. |
| `storage` | Параметры, локальное состояние операций и мастера. |
| `notifications` | Уведомления о ходе и результате операций. |
| `activeTab` | Получение адреса активной вкладки по действию пользователя. |
| Доступ к `www.youtube.com`, `m.youtube.com`, `music.youtube.com` | Кнопки и работа со ссылками YouTube. Скрипты кнопок запускаются на www/m; Music-ссылки можно открыть через окно расширения. |
| **Необязательные** `cookies` и `https://*.youtube.com/*` | Включаются только кнопкой «Использовать вход в YouTube». Код выбирает cookies домена YouTube, включая HttpOnly, и не читает Google cookies, пароли или файлы профиля. |

Chrome выдаёт разрешение `cookies` как браузерную возможность, а не отдельное разрешение на каждый cookie.
В этой реализации область чтения дополнительно ограничена доменом YouTube в коде.
Кнопка **Отключить** отзывает необязательное разрешение и прекращает передачу входа в новые операции.
Уже начатая операция может завершить запрос с переданным ранее состоянием входа.

## Кому идут сетевые запросы

- **YouTube и используемые им медиасерверы:** ссылки, запросы метаданных и скачивания; при включённом входе — cookies YouTube. Эти сервисы видят ваш IP и обрабатывают запросы по своим правилам.
- **Официальные источники компонентов:** `python.org`, `nodejs.org`, GitHub и его серверы релизов, `pypi.org` и `files.pythonhosted.org`. Запросы возникают при ручном или автоматическом обновлении. Передаются обычные сведения сетевого запроса, необходимые для скачивания; история роликов и cookies туда не отправляются.
- **Сайт и Gitea проекта:** переходы к сайту, репозиторию, релизам и задачам на `git.lonarpgproxy.space`. Сервер сохраняет стандартные журналы запросов: IP, время, запрошенный адрес, статус ответа и User-Agent браузера. История загрузок видео, локальные пути и cookies YouTube туда не отправляются. Статический сайт не содержит счётчиков, внешних шрифтов, рекламных SDK или собственных cookies. Тема сайта сохраняется в `localStorage` браузера. Gitea использует cookies для собственных сеансов входа; они не относятся к сессии YouTube. Запросы к GitHub по-прежнему возможны при обновлении сторонних компонентов с их официальных источников.

Установка первоначального EXE после скачивания работает без интернета. Само скачивание роликов требует интернет.
Нет отдельного «облачного» сервиса YouTubeDL, куда отправляется ролик для конвертации.

## Где хранятся данные и как их удалить

Обычная установка: `%LOCALAPPDATA%\YouTubeDL\Helper`, пользовательские данные — подпапка `data`.
При работе из исходников используется локальная `.runtime` проекта.
Удаление помощника сохраняет скачанные файлы и историю. После удаления помощника можно удалить его `data`,
если история тоже не нужна. Удаление расширения удаляет его локальные настройки в данном профиле браузера.
Очищать скачанные файлы нужно в выбранной вами папке.

Публичные задачи и вложения в Gitea проекта видны другим людям. Перед отправкой отчёта уберите cookies,
токены, приватные ссылки и личные пути. Текст ошибки и скриншот не отправляются автоматически.