60 lines
9.3 KiB
Markdown
60 lines
9.3 KiB
Markdown
# Обработка данных
|
|
|
|
Актуально для расширения **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,
|
|
токены, приватные ссылки и личные пути. Текст ошибки и скриншот не отправляются автоматически.
|