Руководство пользователя

1. Sidebar (Боковая панель)

Боковая панель — это постоянная навигационная панель в левой части приложения, выполненная в темном дизайне.

1.1 Логотип

В самой верхней части боковой панели отображается логотип Zenith (Стрелка + Гора + надпись "ZENITH"). Логотип служит для визуальной идентификации бренда.

1.2 Навигационное меню

Под логотипом находится вертикальный список навигации. Элементы разделены на логические группы невидимыми разделителями:

Основные разделы

Подключение

Автоматизация

Уведомления

Система

Стилизация активного состояния

• Выбрано: Голубой text color with a left cyan border and a dark background
• Ховер (наведение): Слегка осветлённый цвет текста
• Обычный: Приглушённый фиолетово-серый

1.3 Админ-блокировка (🔓 Admin)

В самом низу боковой панели находится кнопка блокировки администратора. С ее помощью администратор может заблокировать определенные вкладки паролем для предотвращения несанкционированных изменений.

Заблокированные вкладки отмечаются символом 🔒 и могут быть открыты только после ввода пароля администратора.

1.4 Демо-уведомление

В режиме DEMO в нижней части боковой панели отображается оранжевый блок с предупреждением:

⚠ ДЕМО-ВЕРСИЯ
Restricted functions
Upgrade for full access

2. Dashboard (Центр управления)

Дашборд является главной страницей приложения и предлагает мгновенный обзор всех важных систем. Панель поддерживает прокрутку и автоматически обновляется каждые 3 секунды.

2.1 Карточка статуса VPN (во всю ширину, сверху)

Карточка VPN показывает текущий статус соединения и позволяет быстро включать/выключать VPN прямо из дашборда.

Элементы

Штаты

Поведение

• При активации сначала проверяется, настроен ли VPN-интерфейс.
• В случае ошибки переключатель автоматически сбрасывается.
• The статус synchronizes automatically with the VPN Guard tab.

2.2 Карточка очереди (слева, основная область)

Карточка очереди занимает большую часть дашборда и имеет две подвкладки: Загрузка (Upload) и Скачивание (Download).

2.2.1 Страница загрузки

Отображает все задачи на загрузку в очереди в виде списка с прокруткой.

Записи задач

Each task is shown as a row containing the following info: - Task name (e.g., rudirudi5 (7th Copy)) - Размер файла (например, 656,9 МБ) - Status (Pending / Packing / Uploading / Completed / Сбой / Паузаd) - Progress bar (0–100%) - Speed (for active uploads)

При клике на строку задача выбирается (подсвечивается синим) и может быть запущена отдельно.

Кнопки

3-позиционная логика: Главная кнопка переключается между "Запустить все" → "Приостановить все" → "Продолжить все", аналогично вкладке скачивания.

2.2.2 Страница загрузки

Отображает все задачи на скачивание (импорт NZB) в очереди.

2.3 Watched Folders (справа вверху)

Отображает все настроенные отслеживаемые папки (Watchfolders) с индивидуальными переключателями.

Поведение - Деактивация: Удаляет все ожидающие задачи этой папки из очереди. - Активация: Перезапускает вочдог и сканирует папку на наличие файлов. - Папки добавляются/удаляются через Настройки → Отслеживаемые папки. - Если папки не настроены: "No watchfolders configured".

2.4 Disk Space Guard (справа внизу)

Отображает текущее потребление дискового пространства и содержит несколько подразделов.

2.4.1 Использование диска

2.4.2 Кэш

2.4.3 Режим ОЗУ

Под фиолетовой разделительной линией находится индикатор режима RAM:

Режим RAM: Если этот режим активен, задачи загрузки обрабатываются в оперативной памяти (tmpfs в /dev/shm), а не на жестком диске. Это значительно ускоряет процессы упаковки и создания PAR2, но требует достаточного количества свободной ОЗУ.

2.4.4 Тест скорости

2.5 Заголовок Bar (Custom)

Zenith использует собственную безрамочную панель заголовка (Frameless Window) по верхнему краю:

2.6 Строка состояния (снизу)

В самом низу окна находится постоянная строка состояния:

2.7 Иконка в системном трее

Zenith отображает иконку в системном трее (рядом с часами): - Правый клик: Контекстное меню с опциями Показать/Скрыть, Пауза/Продолжить, Выход. - Левый клик: Показать/скрыть окно. - При активной опции "Сворачивать в трей" окно при закрытии просто скрывается.

2.8 Рекламный баннер (только в DEMO)

В режиме DEMO над областью содержимого (над всеми вкладками) отображается ротируемый рекламный баннер: - Меняется каждые 15 секунд. - Показывает предложения по обновлению и партнерскую рекламу. - Исчезает после активации лицензии.

Вкладка Загрузка — Очередь загрузки

Вкладка Загрузка (Upload) является центральным местом для управления всеми задачами отправки. Здесь добавляются файлы и папки, контролируется процесс загрузки и отслеживается прогресс.

1. Обзор страницы

The tab is vertically split into the following areas: - Header — Заголовок and description - Control Bar — Button to add files - Drag & Drop Zone — Drop files via mouse - Upload Queue — Interactive table with all tasks - Upload Log — Real-time activity protocol

2. Заголовок

3. Панель управления

➕ Добавить загрузку ▾ (кнопка раскрывающегося списка)

Основная кнопка с выпадающим меню, содержащим две опции:

Добавленные файлы/папки немедленно помещаются в очередь.

4. Зона Drag & Drop

Под панелью управления находится пунктирная зона сброса:

📥 Перетащите файлы или папки сюда для загрузки

Поведение - Обычный: Dashed gray border - Вкл Drag Ховер (наведение): Border changes to Голубой with a slight background glow - After Drop: Файлы are automatically added to the queue - Supports files and folders simultaneously - Multiple files can be dropped at once

5. Очередь загрузки (Основная область)

Очередь представляет собой интерактивную таблицу в темной карточке со скругленными углами.

5.1 Заголовок очереди

5.2 Столбцы таблицы

5.3 Значения статуса

5.4 Кнопки действий (в каждой строке)

Каждая строка имеет три небольшие кнопки (28px) справа:

Glow Логика - Активный Task (Packing/Uploading): Играть button glows green - Паузаd Task: Пауза button glows orange - Completed/Сбой Task: No glow, buttons remain neutral - Pending: All buttons neutral (gray)

5.5 Неоновый индикатор выполнения

Прогресс-бар представляет собой кастомный виджет (NeonProgressBar) с: - Градиентом цвета от темно-синего через бирюзовый к светло-синему. - Эффектом свечения на конце индикатора прогресса. - Отображением процентов в виде наложенного текста.

6. Глобальные кнопки управления (под таблицей)

Graceful Пауза (Мягкая пауза): При приостановке текущий шаг обработки (например, упаковка или отправка) доводится до конца, прежде чем следующая задача будет остановлена. Текущие NNTP-соединения не обрываются резко.

Автоmated Removal

Если в настройках включено "Автоматически удалять готовые загрузки": - Кнопка "✓ Скрыть готовые" становится серой и отключается. - В всплывающей подсказке отображается: "Автоматическое удаление включено". - Завершенные задачи автоматически удаляются из таблицы через 5 секунд.

7. Лог загрузки

В самом низу вкладки находится журнал в реальном времени, расположенный в отдельной карточке:

Отображение - Фон: Темный дизайн терминала с моноширинным шрифтом. - Автопрокрутка: Автоматически перескакивает к самой последней записи.

Цветовое кодирование

Префиксы записей лога - 📎 Файл добавлен в очередь - 📦 Задача упаковывается (7-Zip) - 🛡 Выполняется создание PAR2 - ⬆ Идет загрузка - ✅ Задача завершена - ❌ Задача завершилась ошибкой - ⚠ Предупреждение (например, ничего не выбрано) - ▶ Очередь запущена/продолжена - ⏸ Очередь приостановлена - 🗑 Задача удалена - ✓ Готовые записи удалены

8. Конвейерная обработка (Pipeline)

В фоне движок загрузки работает в конвейерном режиме:

Пока Задача A загружается, Задача B уже может упаковываться.

• DiskGuard предотвращает одновременную упаковку слишком большого количества задач (контроль хранилища).
• ПодключениеBudget manages NNTP connections shared between upload and download tasks.

9. Одиночный режим задачи

С помощью кнопки ▶ на отдельной задаче или кнопки "▶ Запустить отдельно" на дашборде можно запустить конкретную задачу изолированно:

• Вклly the selected task is processed.
• Оставшаяся очередь остается приостановленной.
• После завершения одиночной задачи очередь автоматически возвращается в приостановленное состояние.
• Полезно для тестирования или загрузки с высоким приоритетом.

Вкладка Скачивание — Usenet Downloader

Вкладка Скачивание (Download) позволяет скачивать файлы из Usenet с помощью NZB-файлов. Она поддерживает многопоточное скачивание, автоматическое распознавание паролей, восстановление PAR2, распаковку 7-Zip и интеграцию протокола NZBLNK.

1. Обзор страницы

The tab is vertically split into the following sections: - Header — Заголовок and description - NZB Import Card — NZB file/URL entry, password, queue button - Download Queue — Table with all download tasks - Download Log — Real-time activity log

2. Заголовок

3. Импортная карта НЗБ

Скругленная карточка с виджетом импорта для добавления новых скачиваний.

3.1 Зона Drag & Drop

📎 Перетащите файл NZB сюда

• Обычный: Dashed gray border
• Вкл Drag Ховер (наведение): Text changes to "📥 Drop NZB here!", border turns Голубой
• Принимает исключительно файлы .nzb.

3.2 Поле ввода NZB

Поддерживаемый ввод - Локальный файл: /home/user/downloads/example.nzb - URL: https://example.com/releases/example.nzb — скачивается автоматически. - Буфер обмена: Ссылки NZB-URL и ссылки NZBLNK автоматически распознаются из буфера обмена.

3.3 Поле пароля

Автоmatic Password Detection

Система автоматически распознает пароли из имени NZB-файла. Распространенные форматы: - имя файла {{password}}.nzb - имя файла [password].nzb - имя файла - password.nzb

При обнаружении пароль подставляется автоматически и отображается в логе: 🔑 Пароль обнаружен: p*****d

3.4 Кнопка действия

➕ Add to Queue: Adds the NZB file to the download queue. Вклly becomes active when a valid NZB file/URL is provided.

Примечание: Кнопка только добавляет задачу в очередь, но не запускает скачивание автоматически. Запуск производится отдельной кнопкой старта.

4. Очередь скачивания

4.1 Заголовок очереди

4.2 Таблица

Идентичная структура столбцов, как и у очереди загрузки:

4.3 Значения статуса

4.4 Контекстное меню, вызываемое правой кнопкой мыши

При правом клике на элемент очереди открывается контекстное меню: - 🔑 Задать/изменить пароль: Открывает диалог для ввода или изменения пароля для этого скачивания.

5. Кнопки управления

6. Лог скачивания

Real-time log tracking identical to the Upload tab: - Background: Terminal design with monospace font - Color Coding: Зеленый (Успех), Красный (Ошибка), Серый (Info)

Типичные записи лога - 📎 NZB добавлен в очередь - 📥 NZB скачивается по URL - 📋 Ссылка NZB распознана из буфера обмена - 🔑 Пароль распознан или установлен - 🔍 Поиск на Binsearch/NZBIndex/Newznab - ⬇ Идет скачивание (прогресс) - 🛡 Восстановление PAR2 - 📦 Распаковка - ✅ Скачивание завершено - ❌ Скачивание не удалось - ⏸ Скачивание(я) приостановлено - ▶ Скачивание(я) продолжено/запущено

7. Специальные функции

7.1 Монитор буфера обменаing

Zenith автоматически проверяет буфер обмена на наличие: - NZB-URLs: ссылки, содержащие .nzb, автоматически подставляются в поле ввода. - NZBLNK-Links: ссылки с протоколом nzblnk: обрабатываются автоматически.

Эту функцию можно отключить в настройках (dl_clipboard_monitor).

7.2 Поддержка протокола NZBLNK

Zenith зарегистрирован в системе как обработчик схемы URI nzblnk:. При клике на ссылку NZBLNK в браузере: 1. Zenith открывается (или активируется существующее окно). 2. Ссылка обрабатывается автоматически. 3. Поиск NZB производится по следующим источникам (в таком порядке): - Индексаторы Newznab (если настроены) - Binsearch.info (бесплатно, API-ключ не требуется) - NZBIndex.com (бесплатно, RSS-лента) 4. В случае успеха NZB скачивается и добавляется в очередь. 5. Пароль из NZBLNK принимается автоматически.

7.3 Автоmatic Password Detection

Система распознает пароли из: - Имени файла NZB: популярные паттерны вроде {{password}}, [password]. - Данных NZBLNK: поле пароля в URI NZBLNK. - Вручную: Правый клик → Задать пароль.

7.4 Авто-Extraction

После скачивания автоматически выполняются: 1. PAR2-восстановление: отсутствующие/поврежденные сегменты восстанавливаются (настраивается). 2. Проверка CRC: проверка целостности скачанных файлов (настраивается). 3. Распаковка 7-Zip: архивы распаковываются (настраивается). 4. Очистка архивов: удаление файлов RAR/7z после распаковки (настраивается). 5. Очистка мусора: удаление лишних файлов (NFO, TXT и т.д.) (настраивается).

7.5 Зеркальный режим

Режим зеркала автоматизирует повторную загрузку после загрузки:

Download → Extraction → Автоmated Upload via identical configuration

Статус меняется на Зеркало: загрузка. Управляется через вкладку удаленного ввода (Remote Input) или API.

7.6 Сохранение очереди

Очередь скачивания сохраняется автоматически и восстанавливается при перезапуске. Задачи в статусе Pending сохраняются, даже если приложение было закрыто.

7.7 ПодключениеBudget

Downloads and uploads split NNTP connections dynamically via the ПодключениеBudget system: - If an upload runs, connections available for downloads scale back. - The Provider Usage Mode (Upload / Download / Оба) dictates allocation. - If provider usage is locked to "Download", only download connections deploy.

8. Настраиваемые параметры

Следующие настройки скачивания можно изменить в разделе Настройки → Download:

Cloud Backup — Зашифрованный бэкап в Usenet

Вкладка Облачное резервное копирование (Cloud-Backup) позволяет шифровать папки с помощью AES-256, загружать их в Usenet и при необходимости восстанавливать. Файл NZB служит "ключом" для восстановления — до тех пор, пока не истек срок хранения (retention) на серверах Usenet.

1. Обзор страницы

Вкладка разделена по вертикали на пять карточек: - 📁 Источники бэкапа — добавление/управление папками. - 🔐 Шифрование и настройки — пароль, опции. - 📋 История бэкапов — таблица всех выполненных резервных копий. - 📥 Восстановление — восстановление на основе NZB. - 📋 Журнал бэкапа — лог в реальном времени.

2. Источники бэкапа (Карточка 1)

2.1 Список папок

Каждая запись папки имеет отдельную строку, содержащую:

2.2 Настройки для каждой папки (складные)

2.3 Обнаружение изменений

Zenith monitors backup paths every 5 minutes for modifications: - Tracks new, altered, or wiped files. - Status transitions to orange: ⚠ 3 Folders with localized tooltip data. - Успехful backups clear the state back to green.

2.4 Кнопки

• ➕ Добавить папку: открывает средство выбора каталога для добавления нового корневого источника резервной копии.
• ▶ Начать резервное копирование сейчас: мгновенно запускает архивацию всех отмеченных строк.

3. Шифрование и настройки (Карточка 2)

3.1 Левая сторона — Пароль

⚠ Важно: Без пароля восстановить бэкапы НЕВОЗМОЖНО. Функции восстановления или сброса пароля не существует.

3.2 Правая сторона — глобальные настройки

4. История бэкапов (Карточка 3)

Журнал отслеживания исторических архивов:

5. Восстановление (карта 4)

Восстановление данных требует трех входных данных:

Restoration Workflow: Download (Encrypted Archives via Provider) → Ремонт PAR2 (20% Красныйundancy Checks) → Decryption (7-Zip Unpacking) → Restored Файлы (Цель Output Verified)

Кнопка → 📥 Восстановить: Запускает процесс восстановления.

6. Журнал бэкапа (Карточка 5)

Matches the logger implementation found in the main upload/download modules: - Terminal monospace aesthetics. - Color coding: Зеленый (Успех), Красный (Failure), Серый (Info).

Log Prefixes - 📁 Backup path registered - 🔐 Encryption active - ✅ Crypto / Upload / Download task finished - 🛡 PAR2 generation processing (20% redundancy) - 📤 Uploading archive chunks - 📥 Pulling archive chunks (Restoration) - ⏰ Operational scheduling upдатаd - ⚠ Retention threshold reached / Critical anomaly triggered - 🗑 Backup source purged

7. Функции автоматизации

7.1 Резервное копирование по расписанию

• Сканирование по расписанию повторяется каждые 60 секунд.
• Задачи активируются только в том случае, если истекшая разница времени превышает указанный интервал.

7.2 Предупреждение о хранении

• Сканирование выполняется каждые 2 часа + первоначально через 5 секунд после загрузки.
• Alerts prompt 30 days ahead of maximum retention датаs.
• Действия по оповещению повторяются каждые 2 дня, пока они не будут устранены или отключены.

7.3 Обнаружение изменений

• Сканирование повторяется каждые 5 минут + первоначально 10 секунд после загрузки.
• Сравнивает атрибуты модификации файла с матрицей предыдущего запуска.
• Высокийlights changed directories inside статус tooltips via orange indicators.

8. Процесс резервного копирования (техническая спецификация)

8.1 Параметры шифрования

• Алгоритм: AES-256 (с использованием синтаксиса флага 7-Zip -p).
• Обфускация заголовка: включено (-mhe=on) — имена внутренних каталогов пусты.
• Split Thresholds: Scalable volumes (10–2000 МБ options).
• Резервирование PAR2. Абсолютная 20% планировка этажа обеспечивает отказоустойчивость полезной нагрузки.

8.2 Режимы резервного копирования

Вкладка Статистика — Статистика загрузок и скачиваний

Вкладка Статистика (Statistik) предлагает визуальный обзор всей активности по загрузке и скачиванию с интерактивными гистограммами, карточками ключевых показателей и списком истории. Данные считываются из локальной базы данных SQLite и обновляются каждые 5 секунд.

1. Обзор страницы

• Заголовок с фильтрами таймфреймов
• Загрузка Метрики — 6 блоков аналитического мониторинга
• Загрузка диаграмм объема — пользовательские метрики баров
• Скачать Метрика — 6 блоков аналитического мониторинга
• Скачать графики объемов — пользовательские метрики баров
• Список истории последних загрузок
• Список истории последних загрузок
• Кнопка «Глобальная очистка» — очистка таблиц статистики

2. Фильтры заголовков и таймфреймов

Выбранный период влияет на все отображаемые данные (метрики, графики, историю).

3. Показатели загрузки (⬆ ЗАГРУЗКИ)

Шесть карточек статистики в ряд, каждая со своей иконкой, названием и крупным значением:

4. График объёмов загрузки

A custom widget (BarChartWidget) drawn directly via QPainter: - Bars: Rounded corners running a Dark Blue to Голубой gradient fill. - Y-Axis: Dynamic scaling algorithm bounded by dashed mesh lines. - X-Axis: Timestamps scale according to active filters (DD.MM, MM, or YYYY). - Metrics: Floating values display centered above individual bars. - Empty Штаты: Renders "No data available" fallbacks if query rows return null.

5. Показатели скачивания (⬇ СКАЧИВАНИЯ)

Структура идентична показателям загрузки, но выполнена в фиолетовом цвете:

6. График объёмов скачивания

Идентичен графику загрузки, но использует фиолетовый градиент.

7. Последние загрузки (Список истории)

Показывает последние 10 загрузок в виде списка с прокруткой:

Status Colors: ✅ Успех: Зеленый, ❌ Сбой: Красный, ⏳ Pending: Желтый

Пустой текст состояния: «История загрузок недоступна».

8. Последние скачивания (Список истории)

Идентичная структура, показывает 10 последних скачиваний:

Пустой текст состояния: «История загрузок недоступна».

9. Сброс статистики

В самом низу находится красная кнопка сброса:

Кнопка → 🗑 Сбросить статистику: очищает строки базы данных, отслеживающие структурные показатели.

Перед удалением появляется предупреждение:

Вы действительно хотите сбросить всю статистику? Это приведет к удалению всей статистики загрузок и скачиваний, а также истории операций. Это действие невозможно отменить.

10. Спецификации источника данных

Все статистические данные считываются из локальной БД SQLite (~/.zenith-uploader/zenith.db):

Таблица: статистика (ежедневные агрегированные журналы)

VPN Guard — VPN-защита для загрузок

Вкладка VPN Guard управляет VPN-соединениями через ОпенВПН и WireGuard. Профили можно сохранять для разных провайдеров и стран. Функция Kill-Switch автоматически приостанавливает все загрузки при обрыве VPN.

1. Обзор страницы

• Заголовок – описательные метаданные
• Предупреждение о корневом доступе — отслеживание механизма разрешений (хосты Linux)
• Карточка состояния — переключатели управления и показатели сетевой маршрутизации
• Сохраненные профили — список профилей конфигурации
• Настройки — параметры управления Kill-Switch
• Журнал VPN — консоль отслеживания событий в реальном времени

2. Заголовок

3. Предупреждение о корневом доступе (среды Linux)

Среды выполнения хоста Linux опрашивают пространства среды, чтобы убедиться в наличии корневых разрешений или активных серверных частей pkexec. При отсутствии хуков отображается предупреждающий баннер:

⚠ Root-права недоступны. Подсистемам VPN требуются права root (pkexec или sudo). Пожалуйста, установите зависимости policykit-1: sudo apt install policykit-1

В Windows это предупреждение не отображается.

4. Status Card (Основная область)

4.1 Отображение состояния

4.2 Кнопки подключения/отключения

5. Сохранённые профили

5.1 Карточки профилей форумов

• Флаг страны. Индикатор флага Emoji на основе географических метаданных.
• Имя профиля: заголовок, выделенный жирным шрифтом (например, «Mullvad Amsterdam»).
• Строка сведений: Имя поставщика · Страна назначения · Метаданные протокола.
• Protocol Значокs: Small tags color-coded by engine types (OP = ОпенВПН Зеленый, WI = WireGuard Голубой).
• ● Узел выбора: Голубая точка отмечает активный целевой профиль.
• ✕ Управление очисткой: кнопка с круглым значком для очистки профилей (светится красным при наведении).

Пустое представление состояния: «Профили не сохранены. Для начала добавьте новую конфигурацию профиля VPN».

5.2 Диалоговое окно «Добавить профиль» (кнопка «+»)

Поддерживаемые страны: 🇳🇱 Нидерланды, 🇩🇪 Германия, 🇺🇸 США, 🇬🇧 Великобритания, 🇨🇭 Швейцария, 🇸🇪 Швеция, 🇫🇷 Франция, 🇨🇦 Канада, 🇯🇵 Япония, 🇦🇺 Австралия, 🇷🇴 Румыния, 🇸🇬 Сингапур, 🇪🇸 Испания, 🇮🇹 Италия, 🇳🇴 Норвегия, 🇫🇮 Финляндия, 🇦🇹 Австрия, 🇧🇪 Бельгия, 🇵🇱 Польша, 🇨🇿Чехия, 🌍Другое.

6. Настройки

Параметры аварийного выключателя

Если VPN-соединение неожиданно разрывается, управляющий компонент AppController фиксирует смену статуса через сигнал vpn_статус_changed. Все текущие загрузки мгновенно ставятся на паузу, статус меняется на ОШИБКА. Возобновить загрузки можно вручную после восстановления безопасного туннеля.

7. Консоль журнала VPN

Лог действий VPN в реальном времени.

8. Архитектура механизма VPN

• Активный profile data loads into transient memory execution pools.
• Отслеживает коды выхода и стандартные каналы ошибок для отслеживания активных состояний.
• Valiдатаs connectivity paths using external IP check lookups post-handshake.
• Выдает межмодульный сигнал vpn_статус_changed для настройки виджетов информационной панели.

Часть 7a: Удалённые источники — RSS Feeds

Удалённые источники — RSS Feeds

Субвкладка RSS-лент позволяет автоматически опрашивать удаленные фиды (например, Usenet-индексаторы), фильтровать результаты по заданным критериям и автоматически отправлять найденные файлы NZB в очередь скачивания.

1. Структурный обзор

Вкладка "📡 RSS Feeds" разделена по вертикали на две области с помощью сплиттера: - Сверху: Таблица со всеми сохраненными RSS-лентами. - Снизу: Форма редактирования + окно предпросмотра ленты + строка статуса.

2. Матрица сетки подачи (верхняя часть)

2.1 Столбцы таблицы

Кнопка → ＋ Добавить ленту: (С оранжевой рамкой) Добавляет новую пустую строку в таблицу.

3. Форма подробной конфигурации (нижняя часть)

При клике на ленту в таблице ее настройки загружаются в нижнюю форму.

3.1 Сопоставление полей

3.2 Схемы фильтров регулярных выражений

Символ . означает любой знак. Чтобы указать именно точку, ее нужно экранировать: \\.. Комбинация .* означает любое количество любых символов. Фильтр нечувствителен к регистру (case-insensitive).

3.3 Функциональные действия

4. Сетка предварительного просмотра результатов

После выполнения ручного опроса результаты выводятся в таблицу предпросмотра:

Preview Controls - ☑ Select All: Checks all visible rows. - ⬇ Download Отмечено: Pushes selected rows into download queues. - 🗑 Dismiss Records: Удалитьs selected records from preview tables.

Отклоненные или загруженные элементы регистрируют свои уникальные хеши GUID в локальном хранилище, чтобы предотвратить дублирование при последующих итерациях опроса.

5. Background Engine Автоматизация

When automated parsing loops run: 1. Timer Fires → Scrape API Source → Filter Out Known GUIDs → Run Regex & Size Verifications 2. If Авто-Queue Отключено: Append to Display Matrix 3. If Авто-Queue Enabled: Inject Tasks Directly

Часть 7b: Удалённые источники — Newznab Indexer

Удалённые источники — Newznab Indexer

Подвкладка Newznab предназначена для интеграции с профессиональными Usenet-индексаторами (такими как НЗБГик, DrunkenSlug, NZBFinder) посредством их стандартного API.

1. Обзор

Структура аналогична разделу RSS: - Сверху: Таблица подключенных индексаторов Newznab. - Снизу: Детальная форма параметров + строка лога состояний.

2. Сетка конфигурации (верхняя часть)

Кнопка → ＋ Добавить индексатор: добавляет пустую строку записи индексатора.

3. Детальная конфигурация (нижняя часть)

Основные категории Newznab

Подсказка: Коды разделов Newznab через запятую. Пусто = все разделы.

4. Функциональные элементы управления

5. Фоновая архитектура API

Сопоставление конечных точек Newznab: – Диагностика возможностей: GET /api?t=caps&apikey=TOKEN. - Запросы по ключевым словам: GET /api?t=search&q=QUERY&apikey=TOKEN&cat=CATS&limit=LIMIT - Извлечение NZB: GET /api?t=get&id=GUID&apikey=TOKEN

Логика работы: 1. Фоновый таймер запускает задачу опроса. 2. Выполняется HTTP GET-запрос с категориями и лимитами. 3. Результаты сверяются с активными regex-фильтрами по заголовкам. 4. Записи, не прошедшие пороги размеров файлов, отбрасываются. 5. Ранее загруженные объекты пропускаются по сохраненным GUID. 6. Если включен "Авто-скачивание", NZB скачивается автоматически. 7. Если включен "Авто-старт", задача запускается мгновенно.

6. Valiдатаd Indexer Networks

Поддерживаются все стандартные Newznab-совместимые провайдеры: НЗБГик, DrunkenSlug, NZBFinder, NZBPlanet, DOGnzb и Tabula Rasa.

Часть 7c: Удалённые источники — FTP / SFTP

Удалённые источники — FTP / SFTP

Модуль работы с удаленными серверами предоставляет пользователю встроенный FTP/SFTP-клиент с интерактивным обозревателем папок и возможностью скачивания файлов напрямую в локальную рабочую среду приложения.

1. Структурный обзор

• Верхняя панель. Формы параметров аутентификации и входные данные доступа к серверу.
• Основной центральный текст. Таблица браузера дерева удаленных каталогов, показывающая структуры удаленной файловой системы.
• Нижняя часть: Управление папкой назначения и запись отзывов на консоль.

2. Настройки подключения к серверу

2.1 Поля формы

2.2 Система Actions

3. Браузер удаленного дерева каталогов

3.1 Лента навигации

• ⬆ Верхний каталог. Переход на один уровень вверх к уровням родительских папок.
• 🔄 Обновить содержимое: повторно сканирует структуры активных каталогов.
• Активный Path Box: Monospace rendering of raw remote server path (Голубой).

3.2 Таблица содержимого каталога

3.3 Взаимодействие

• Каталог двойного щелчка. Вход в выбранный дочерний каталог.
• Файл, открываемый одним щелчком мыши: помечает строки для выбора (поддерживает множественный выбор).
• Нажмите родительскую стрелку (⬆): переход назад к более высоким логическим деревьям.

3.4 Реализации библиотеки

• SFTP: Управляется через paramiko. Сигналы поддержки активности каждые 30 секунд.
• FTP: Управляется через ftplib. Пассивный режим включен; UTF-8 parsing for extended character sets.

4. Механизм загрузки

• Обрабатывает проверяемые элементы последовательно через асинхронную очередь.
• При выборе объекта папки рекурсивно извлекается вся древовидная структура файлов.

Часть 8a: Авто-постинг — Forum Poster

Авто-постинг — Forum Poster

Субвкладка отправки тем на форумы автоматизирует или переводит в ручной режим процесс генерации тем с описанием релизов в специализированных Usenet-сообществах.

1. Обзор

The UI splits into four functional layout segments: - Header Ribbon — Заголовок + "＋ Add New Profile" trigger - Profile Selection Grid — Активный destination board configurations - Posting Hold Queue — Вручную approval workspace - Reference Help Card — Contextual documentation and syntax tips

2. Карточки профиля пункта назначения

2.1 Компоненты интерфейса

2.2 Цвета ядра программного обеспечения платы

3. Диалог управления профилями

3.1 Поля формы

3.2 Thread Заголовок Tokens

3.3 Модальные действия

• 🔌 Тестовый вход: проверяет авторизацию на форуме без внесения изменений.
• ❌ Прервать: закрывает модальное окно, отменяя незафиксированные изменения.
• ✅ Commit Profile: Valiдатаs, saves, and upдатаs lists.

4. Режимы работы

5. Вручную Staging Hold Queue

Jobs under Вручную mode wait inside this workspace: - 📄 Content Заголовок: Source release имя файла. - → Destination: Цель profile and engine version. - ▶ Post Release: Instantly processes topic submission. - 🗑 Drop Task: Purges staged notification.

При пустой очереди выводится надпись: "Очередь удержания публикаций пуста."

6. Совместимость двигателей

Часть 8b: Авто-Post — Шаблоны

Авто-Post — Шаблоны / Templates

Подвкладка управления шаблонами предоставляет встроенный редактор BBCode/HTML разметки с панелью быстрого форматирования, интерактивной панелью динамических тегов и менеджером файлов стилей.

1. Обзор

Интерфейс модуля организован в виде горизонтального сплиттера: - Сверху: Панель интерактивных чипов со списком доступных системных тегов. - Слева: Список сохраненных пользователем профилей разметки. - Справа: Текстовый редактор кода с панелью быстрой вставки тегов BBCode.

2. Справочные чипы токенов

Теги оформлены в виде зеленых чип-кнопок на темном фоне, снабженных подсказками при наведении мыши.

3. Левая панель навигации

• Дерево выбора. Шаблоны отображаются рядом со значком 📄. При нажатии редактор заполняется.
• + Новый шаблон: генерирует новую запись с шаблонным кодом.
• 🗑 Удалить шаблон: предлагает пройти проверку для очистки макетов.

Ограничения: Минимум 1 активный шаблон. Максимум 10 шаблонов (MAX_POSTING_TEMPLATES). Базовый шаблон создается автоматически, если конфигурационные файлы стерты.

4. Правая область редактирования и панель инструментов

4.1 Компоненты

4.2 Кнопки панели инструментов

Набор из 11 кнопок для ускорения верстки шаблонов:

Высокийlighting text wraps selection inside chosen tags. Clicking without selection inserts at cursor.

4.3 Действия по сохранению

Кнопка → 💾 Сохранить шаблон: Фиксирует имя, тип интерпретатора и текст разметки в файлах настроек.

5. Default Boilerplate Layout (vБюллетень 3.x)

[center][size=5][color=red][b]{title}[/b][/color][/size][/center]

[center][size=3][color=][b]»Content Description«[/b][/color][/size]
[size=2][color=white]{description}[/color][/size][/center]

[nfo]{nfo_content}[/nfo]

[hide]
[center][size=3][color=][b]»Usenet Release Header«[/b][/color][/size]
[size=2][color=white]{header}[/color][/size][/center]

[center][size=3][color=][b]»Archive Security Password«[/b][/color][/size]
[size=2][color=white]{password}[/color][/size][/center]

[center][nzblnk]nzblnk:?t={title}&h={header}&p={password}[/nzblnk]
[/center][/hide]

6. Rendering Engine Process

1. Pulls assigned format from active profile definitions.
2. Regex replacement loop swaps all {placeholder} tags with runtime parameters.
3. Renders thread title separately using its own formatting rules.
4. Forwards finalized text to forum poster threads.

Вебхуки и уведомления

Вкладка управления вебхуками позволяет настроить отправку автоматических алертов в мессенджеры и на внешние серверы при возникновении ключевых событий в системе.

1. Обзор

• Header: Заголовок + "＋ Add New Webhook" trigger.
• Активный Цель Grid: Saved automation endpoints as selectable items.
• Справочная справочная карта: Документация по синтаксису полезных данных.

2. Поддерживаемые поставщики API

3. Элементы профиля вебхука

Empty State: "No webhook alert paths mapped. Configure a tracking profile to receive статус logs."

4. Диалоговое окно мастера настройки

4.1 Базовая настройка

4.2 Поля, специфичные для платформы

Раздор: Цель Webhook URL — Required

Телеграмма: Bot Token (via @BotFather) — Required; Chat ID — Required

Электронная почта SMTP: Host Server, Port (587), ☑ TLS, Username, Password, Recipient — Required

нтфй: URL-адрес сервера (https://нтфй.sh), канал темы — обязательно, токен доступа — необязательно

Пользовательский HTTP: URL-адрес назначения — обязательно, метод HTTP (POST/PUT/GET), заголовки (JSON)

5. Триггеры событий

По умолчанию все события проверяются в новых профилях.

6. Селектор полей данных (Payload)

7. Тестовый конвейер

🔔 Оповещение об отправке теста: генерирует временный профиль тестирования, форматирует макеты полезных данных, настроенных в соответствии с правилами платформы, передает целевому объекту и возвращает всплывающее окно подтверждения.

Часть 10a: Настройки — Провайдер

Настройки — Провайдер

Вкладка управления провайдерами отвечает за параметры доступа к серверам Usenet, распределяя сетевые потоки между процессами отправки и скачивания данных.

1. Обзор

• Верхняя область: Центральная сетка, сортирующая учетные записи активных серверов.
• Нижняя форма настройки: элементы управления созданием полей профиля.
• Панель действий: триггеры обслуживания сети и проверки соединения.

2. Матрица счетов поставщиков

3. Форма настройки учетной записи

4. Тест подключения

🔌 Verify Server Подключение: Автоmated connectivity diagnostic:

1. Сформулировать сопоставление учетных записей → Запрос nntplib → Внедрить SSL-квитирование
2. Открыть канал TCP → Измерить задержку (мс) → Вернуть заголовки приветствия

Ошибки, возникшие на любом этапе теста, прерывают диагностику, выводя сырой текст исключения в окно уведомления пользователя.

Часть 10b: Настройки — Загрузка

Настройки — Загрузка

Вкладка настроек загрузки отвечает за параметры компрессии файлов, параметры генерации избыточных блоков восстановления и тонкие настройки потоков NNTP.

1. Обзор

• Верхняя лента: переключение экспертного режима + сброс настроек к заводским настройкам.
• Стандартная сетка: параметры из трех столбцов для повседневных настроек.
• Экспертная сетка: расширенные настройки в фиолетовых акцентных полях (только в экспертном режиме).

2. Стандартные настройки

2.1 Общие параметры интерфейса

2.2 Конвейер обработки задач

Режимы конвейера: Последовательный (Последовательно) — завершает каждую задачу перед стартом следующей. Конвейерный (Pipelined) — упаковывает следующую задачу, пока текущая загружается. DiskGuard следит за потреблением дискового пространства.

2.3 Защита диска

2.4 Параметры очистки

2.5 Приоритеты ресурсов процессора

3. Expert Settings (Фиолетовый Accent Box)

3.1 Настройки компрессора 7-Zip

3.2 Настройки генератора ParPar

3.3 Настройки сети NNTP

Часть 10c: Настройки — Скачивание

Настройки — Скачивание

Вкладка настроек скачивания управляет путями сохранения файлов, логикой сборки многотомных архивов, параметрами избыточного восстановления и механизмами авто-распаковки.

1. Обзор

Five component clusters in a two-column framework: - Folders & Система Workspace - Unpacking Engine Pipeline - Network Подключение Parameters - Disk Guard Safeties - Mirror Mode Pipelines

2. Директории и системные пути

3. Конвейер распаковки файлов

Выбор нежелательных расширений: ✅ .txt, ✅ .html, ✅ .url, ✅ .nfo, ✅ .info (отдельные фильтры неактивны, пока не включен основной переключатель).

4. Параметры сетевых соединений

5. Disk Guard (Для скачивания)

Подсказка: Рекомендуется устанавливать пороги дискового пространства для скачивания на 10% ниже, чем для загрузки (например, загрузка 90% → скачивание 80%), чтобы задачи скачивания не занимали весь временный кэш, необходимый для текущих загрузок.

6. Зеркальный режим

Включение флага стирает поврежденные пакеты, предотвращая ситуацию, когда вочдоги подхватывают битый архив и отправляют его на повторный круг загрузки. Отключение оставляет данные на диске ПК для ручной распаковки.

Часть 10d: Настройки — Отслеживаемые папки

Настройки — Отслеживаемые папки

Вкладка управления отслеживаемыми папками отвечает за параметры автоматического сканирования директорий. Файлы, скопированные в эти папки, автоматически подхватываются системой и отправляются в очередь загрузки.

1. Обзор

• Header Ribbon: Заголовокs + dynamic counters (e.g., "3 / 10 Folders Monitored").
• Пояснения к контексту. Краткие руководства по правилам автоматизации.
• Список каталогов. Папки настроены как карточки с действиями.
• ➕ Кнопка «Добавить отслеживаемый путь»: Запускает браузер каталогов.

2. Карты мониторинга каталогов

2.1 Компоненты интерфейса

• Метка каталога: имя целевой папки, выделенное жирным шрифтом.
• Complete Path: Серыйed out system path reference.
• Newsgroup Chips: Активный index destinations as horizontal chips.
• Раскрывающийся список маршрутизации. Поле со списком для управления целевыми двоичными файлами.
• ● Status: Зеленый = active, Желтый = paused, Красный = missing directory.
• ✕ Удалить: Deletes monitoring configuration.

2.2 Проверка статуса

3. Распределение категорий телеконференций

• Поддерживает правила публикации нескольких групп для каждой папки.
• Щелчок по узлам чипа X удаляет группу новостей из профиля.
• "No Цель Newsgroup" disables public posting for the path.
• Добавление стандартных целей удаляет активные ограничения __none__.
• Для ненастроенных папок по умолчанию используются глобальные настройки.

Схема конфигурации:

{
 "/home/user/Videos/Upload": ["alt.binaries.boneless", "alt.binaries.misc"],
 "/home/user/Private/Backup": ["__none__"]
}

4. Подключение новой папки

1. Click "＋ Add Monitored Path".
2. Система folder picker maps target filesystem paths.
3. Filters check against existing records to block duplicates.
4. Максимум 10 entries. Cap disables addition buttons.
5. Changes trigger automated watchdog engine reloads.

5. Удаление отслеживаемых папок

• Clicking X removes entry rows.
• Clears configuration from watch_folders files.
• Cleans up статус histories in watch_folders_disabled.
• Удалитьs records from watch_folder_newsgroups.
• Triggers live engine reloads to stop monitoring instantly.

6. Dashboard Synchronization

Тумблеры отслеживания папок на главной странице дашборда пишут параметры состояния напрямую в конфигурационные списки watch_folders_disabled. Карточки и маркеры во вкладке настроек автоматически обновляются и синхронизируют цвета при переходе пользователя между вкладками.

Лицензия

Вкладка управления лицензированием отвечает за активацию продукта, вывод параметров текущего уровня подписки и управление привязкой уникальных идентификаторов оборудования HWID при смене ПК.

1. Обзор

• Header — Заголовок and scope
• License Значок — Status display banner
• Карта активации — входные данные формы для проверки токенов продукта
• Утилиты лицензирования — 3 карточки системных операций
• Границы демо — видны только неаутентифицированным экземплярам
• Привилегии функций – подробный список разблокированных премиум-активов

2. Уровни лицензирования

3. Лицензионный бейдж

• Большой значок значка, сообщающий о текущем состоянии.
• Демо: «Ограничение системных операций. Обновите систему, чтобы разблокировать бесконечную пропускную способность».
• Полный: «Все премиум-функции разблокированы — активен пожизненный бесконечный уровень».
• Expiration: Reports end временная меткаs, ∞ Без лимита, or — (demo).

4. Регистрация и активация ключа

Workflow: Input Key → Execute license.activate(key) → Query Validation Endpoint → Invalid: Ошибка dialog / Valid: Write to config → Prompt reboot.

5. Лицензирование утилит

5.1 🔄 Сброс идентификатора оборудования (сброс HWID)

Сбрасывает аппаратные ключи отслеживания регистрации, чтобы разрешить переход на альтернативные рабочие станции. Вызывает предупреждение о проверке безопасности. Отправляет license.reset_hwid.

5.2 ⛔ Деактивировать лицензию на устройство

Стирает лицензионные маркеры авторизации из локальной рабочей среды текущего ПК. Приложение сбрасывает премиум-флаги, возвращаясь в режим Демо после перезапуска. Стилизация кнопки: тревожный красный цвет интерфейса.

5.3 📋 Capture Система HWID

Копирует необработанный вычисленный хэш идентификации оборудования в системный буфер обмена через QApplication.clipboard.setText(license.hwid).

6. Demo Limitations (DEMO Вклly)

An amber warning banner lists restrictions: - 📦 File Cap: Максимум 1 GB per execution batch. - 📊 Queue Counter: Максимум 10 upload tasks per day. - 🏷 Branding Injection: Injects branding markers in outbound NNTP headers. - External URL: → zenith-uploader.com upgrades portal.

7. Unlocked Features (Full Version Вклly)

A green checklist summarizes active feature sets: - ✓ Unrestricted processing capabilities. - ✓ Anonymous outbound metadata (zero branding injections). - ✓ Dynamic performance profiles without скорость limits. - ✓ Full VPN Guard & Kill-Switch controls. - ✓ Высокий-priority customer support routing.

Поддержка и диагностика

Вкладка поддержки обеспечивает вывод параметров операционной среды, предоставляет доступ к встроенному журналу логов с интерактивной фильтрацией и содержит инструменты для автоматического формирования отчетов об ошибках.

1. Обзор

• Заголовок – метаданные + теги индекса версии (например, v1.0.0)
• Система Status Roster — 4 horizontal analytical modules
• Просмотр журнала приложений — интерактивная консоль с фильтрацией запросов
• Действия быстрой помощи – 4 карточки быстрого запуска
• Ссылки в нижнем колонтитуле – поддержка маршрутов почты и веб-сайтов

2. Система Status Roster

3. Просмотр журнала приложений

3.1 Панель инструментов

3.2 Параметры консоли

• Источник: ~/.zenith-uploader/logs/zenith.log
• Ограничение буфера: 1000 последних записей
• Авто-Refresh: Every 10 seconds via QTimer
• Шрифт: JetBrains Mono 10pt (резервный вариант: Consolas)
• Scroll: Snap-to-bottom on upдата

3.3 Цветовое сопоставление серьезности

3.4 Панель навигации консоли

4. Действия быстрой помощи

4.1 🐛 Составление отчета об ошибках

• Записывает пути к каталогам журналов в буфер обмена.
• Запускает файловый менеджер в каталогах поддержки.
• Открывает почтовый клиент по умолчанию с предварительно заполненным шаблоном.

4.2 📂 Открыть каталог журналов

Opens ~/.zenith-uploader/logs/ in native file explorer. Авто-creates missing directories.

4.3 📋 Путь записи журнала

Копирует абсолютный путь к файловой системе в системный буфер обмена.

4.4 📊 Диагностика среды сбора данных

Копирует отформатированный текст системной информации:

Zenith Uploader — Система Environment Diagnostic Data Map
======================================================
Host OS Platform: [OS]
Среда выполнения Python Version: [Version]
Available Processor Threads: [Threads]
Memory Utilization: [Used] / [Всего] GB
Log Path: [Path]

5. Footer Links

📧 [SUPPORT_EMAIL] · Documentation & Guides: zenith-uploader.com