Dannex Download Manager
  1. Главная
  2. Справка
  3. Архитектура

Архитектура

Как устроены компоненты Dannex Download Manager.

Крейты

Путь Крейт Роль
crates/engine mdm-engine Загружает один файл по HTTP(S) или FTP(S): зондирование, планировщик сегментов, рабочие соединения, состояние возобновления, ограничения на хост, ограничитель скорости, контрольные суммы, прокси-скрипты
crates/app mdm-app Настольное приложение (dannexdownloadmanager.exe, egui): список, категории, очереди, планировщик, диалоги, трей, настройки
crates/cli mdm-cli Загрузки без графического интерфейса с индикатором выполнения (get, resume), видео, торренты и команды API автоматизации: библиотека, которую запускает программа приложения (dannexdownloadmanager --cli …), и dannexdownloadmanager-cli — небольшой лаунчер, который запускает её с теми же аргументами, терминалом и кодом выхода.
crates/mcp mdm-mcp Сервер MCP (dannexdownloadmanager-mcp): список ИИ-помощников, добавление и управление загрузками запущенного приложения через API автоматизации
crates/remote mdm-remote Удаленное управление (#141): HTTPS-сервер, который использует сопряженный телефон или компьютер в локальной сети (его страница, коды сопряжения, токены устройств, самоподписанный сертификат); каждый запрос становится командой API автоматизации, на которую отвечает приложение
crates/nmhost mdm-nmhost Хост нативных сообщений браузера: принимает перехваченные загрузки от расширения и передает их приложению
crates/ipc mdm-ipc Канал единственного экземпляра (локальный сокет, защищенный токеном), папка данных и правила перехвата, общие для приложения и хоста
crates/debrid mdm-debrid Учётные записи дебрид-сервисов (#44): официальные API этих сервисов (Real-Debrid, AllDebrid, Premiumize, TorBox) преобразуют ссылку файлового хостинга в прямую ссылку, которую загружает движок.
crates/extract mdm-extract Распаковка архивов (#37): zip, tar, gz и xz в процессе; 7z и RAR через установленный 7-Zip, запускаемый как отдельная программа.
crates/geo mdm-geo Местоположение сервера загрузки (#140): таблица диапазонов IP-адресов по странам, построенная на основе данных DB-IP Lite (tools/geo/build.py), поиск выполняется только на этом компьютере, а также флаги стран.
crates/tools mdm-tools Видеостраницы через yt-dlp и ffmpeg, галереи изображений через gallery-dl (запускаются как отдельные программы); при выборе сетевого адаптера их соединения проходят через прокси DDM на 127.0.0.1, который привязывает их к нему (relay.rs).
crates/crash mdm-crash Отчеты о сбоях и зависаниях: процесс монитора, минидампы вне процесса, символизированные стеки, текст отчета и журналы выпуска (crash-reports.md)
crates/torrent mdm-torrent BitTorrent и magnet-ссылки через librqbit
crates/labserver mdm-labserver HTTP Range-сервер с журналом запросов и внедрением ошибок, а также FTP/FTPS-сервер со своими ошибками, для тестов и бенчмарков
extension/ — Расширение для Chromium (MV3) и Firefox
docs/ — Руководство пользователя и учебные пособиям, этот файл, данные для бенчмарка; веб-сайт делает руководство своими страницами справки, которые открывает Справка
website/ — Собственные страницы dannex.kavangi.co.ke (главная, загрузка, возможности, темы, FAQ); tools/website/build.py добавляет справку из docs/ и новости из CHANGELOG на 22 языках, а GitHub Pages публикует их.

Зависимости направлены внутрь: app, cli, mcp, nmhost и remote используют engine и ipc; движок ничего не знает о пользовательском интерфейсе. Приложение видит движок только через его события (прогресс, снимки таблицы сегментов, завершено, сбой).

Движок

Download
 ├─ probe()              size, resumable?, validators (ETag / Last-Modified), file name
 ├─ Planner (pure)       segment table: when a connection is free, the largest remaining
 │                       part is split in half (planner.rs, tested by random simulation)
 ├─ Worker × N           one HTTP/1.1 connection each, reused across segments; slow ones
 │                       are dropped and their part re-split
 │    └─ writes at its offset into <name>.mdm.part (created sparse)
 ├─ HostLimits           learns how many connections each server accepts
 ├─ Limiter (shared)     per-download and global token buckets
 ├─ State                segment table saved atomically (craft-atomic) for crash-safe resume
 └─ events → channel     Progress, Done, Failed

Когда все сегменты загружены, файл .part проверяется на соответствие ожидаемому размеру и переименовывается; дата файла может соответствовать дате сервера.

Первый запрос на скачивание (get) следует перенаправлениям и страницам, которые сами ведут к файлу (обновление страницы ожидания). Для сайтов, чьи ссылки не являются адресом файла, в sites/ есть модуль (Google Drive: sites/gdrive.rs): он преобразует ссылку в адрес файла, читает собственные страницы сайта (форма подтверждения, страница ошибки) и называет его отказы (Error::Refused), используя чистые функции, протестированные без сети. Лабораторный сервер имитирует такой сайт на его реальных хост-именах для сквозных тестов (labserver/src/drive.rs).

FTP и FTPS (ftp.rs) проходят через тот же планировщик, рабочие процессы и состояние: сегмент — это REST + RETR в управляющей сессии вместо диапазонного GET, SIZE и MDTM заменяют заголовки, а сессии объединяются для каждой загрузки и повторно используются между сегментами.

Приложение

Одно окно egui, отрисованное в фиксированных пиксельных координатах, плюс один непосредственный видовой экран для каждого диалогового окна. app.rs хранит состояние (загрузки, очереди, параметры, выбор списка) и преобразует команды меню, панели инструментов, клавиш и IPC в действия. Каждое диалоговое окно является собственным модулем и возвращает Outcome (открыто, закрыто, выполнено со значением). Вызовы только для Windows ограничены win32.rs, а их аналоги для Linux и macOS — unix.rs (запуск с сеансом, хост браузеров, звуки, показать в папке, обработчик сбоев); все остальные файлы — безопасный, переносимый Rust. Шрифты берутся из системы: папка Fonts в Windows, системные шрифты macOS, fontconfig в Linux (theme.rs). В Windows латинский, греческий и кириллический текст рисуется с помощью DirectWrite (win32.rs, через хук растеризатора глифов egui): Вид → Текст → Сглаженный в естественном режиме, сглаженный до запрошенного размера и расположенный с точностью до четверти пикселя с собственными смещениями шрифта; Классический (по умолчанию) в режиме GDI-classic, так что подсказанная форма каждой буквы и ширина в целых пикселях объединяются. Другие скрипты формируются и рисуются egui.

Темы

Каждый цвет и размер элемента управления определяется активной темой (#45). Тема состоит из светлой и темной палитры, метрик, стилей элементов управления и стиля значков (palette.rs):

  • Роли палитры. palette.rs объявляет каждую роль со стабильным ключом ("button.hot", "list.row", "caption"…), описанием и значениями для светлой и темной тем классического вида, записанными явно (классический вид не является производным). Общие отрисовщики (winui.rs, chrome.rs, list.rs, scrollbar.rs) считывают их через theme::colors() и theme::metrics() и определяют состояния каждого элемента управления на их основе; ни один код отрисовки не содержит собственного цвета.
  • Производные палитры. derive.rs создает целую палитру из нескольких исходных цветов (фон, поверхность, текст, акцент…), смешивая все остальные роли в OKLab и сохраняя контраст WCAG (4.5:1 для текста, 3:1 для краев); «Высокая контрастность» усиливает каждый край сверху. native.rs инициализирует системную тему из системного акцента и контраста (настройки Windows, портал freedesktop в Linux, акцент macOS).
  • Стили элементов управления. palette::Controls определяет форму каждого элемента управления (текстовые поля, флажки, кнопки, индикаторы выполнения, полосы прокрутки, метка фокуса, заголовок окна); темы стилей (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) выбирают свои, а в Windows DDM затем отрисовывает заголовок окна самостоятельно (роли caption.*).
  • Файлы тем. themefile.rs считывает TOML или JSON из папки данных themes (один файл или <id>/theme.toml со значками рядом). Файл называет только то, что он изменяет; остальное берется из темы, которую он inherits (идентификатор встроенной темы или другого файла, по умолчанию — классический вид), по цепочке, в которой цикл не допускается. Неизвестные ключи являются предупреждениями, а не ошибками. Встроенные стили тем также являются такими файлами, содержащимися в программе (crates/app/assets/themes).
  • Наборы значков. themeicons.rs отрисовывает значки темы (названные по их назначению: tb-add-url, cat-music…, SVG или PNG размером 16, 24, 32 и 48 пикселей, -symbolic значки, окрашенные в цвет текста) там, где классический вид отрисовывает свои собственные; если в наборе отсутствует необходимый значок, используется классический.
  • Стили значков панели инструментов. Вид → Панель инструментов → Линейный стиль (контуры, окрашенные цветом темы) или 3D-стиль: собственные глянцевые картинки DDM (assets/icons/toolbar3d, рисуются tools/icon/toolbar_3d.py размером от 16 до 64 px, подходящим к размеру на экране; при недоступной кнопке icons.rs делает их серыми). Они применяются там, где у темы нет своего значка для кнопки и значки выводятся в собственных цветах; тема с набором значков или с одноцветными значками (Высокая контрастность) оставляет свои.

Расположение элементов управления в окне остается его макетом. То же самое относится к значкам перед именами файлов (fileicons.rs): системные списки изображений оболочки Windows, macOS Finder (NSWorkspace), тема значков рабочего стола Linux (xdgicons.rs, shared-mime-info и Icon Theme Specification). Каждый тип ищется один раз для каждого размера пикселя в фоновом потоке. Значки Tango (в комплекте) используются до тех пор, пока системный значок не будет готов, и везде, где система его не имеет.

Отрисовка

Окна отрисовываются с помощью OpenGL (glow от eframe) или с помощью собственного графического API системы через wgpu от eframe, только с одним бэкендом: Direct3D 12 в Windows (по умолчанию), Vulkan в Linux, Metal в macOS (выбор там; OpenGL остается их по умолчанию, пока реальные видеокарты не попробуют их, #206). Вид → Отрисовка с помощью выбирает один, начиная со следующего запуска. Один путь кода делает это на каждой системе (crates/app/src/renderer.rs): когда выбранный не может запуститься, пробуется другой, так что окна всегда открываются. Контролируемый запуск с API системы оставляет маркер до отрисовки первого кадра: запуск, который заканчивается до этого (сбой в драйвере), запуск, первый кадр которого не появляется в течение 10 секунд (DDM затем снова запускается с OpenGL), или видеокарта, потерянная дважды за 10 минут, запоминается с указанием причины, которую показывает меню.

Вид → Размер интерфейса (scale.rs, #262) — это коэффициент масштабирования egui поверх собственного масштаба дисплея: каждое окно располагается в точках, поэтому оно открывается настолько большим; окно, большее, чем экран, прокручивается.

Данные

Список загрузок и параметры сохраняются атомарно в папку данных (downloads.json): %APPDATA%\dannexdownloadmanager\ в Windows, ~/.local/share/dannexdownloadmanager в Linux, ~/Library/Application Support/dannexdownloadmanager в macOS, папка data рядом с переносимой копией или MDM_DATA_DIR (mdm_ipc::data_dir). Хост браузера читает тот же файл для правил захвата, поэтому изменение в Параметрах применяется к следующей захваченной загрузке.

Секреты входа (учетные записи debrid, логины сайтов и пароли прокси) хранятся в системной связке ключей (secrets.rs, #44): диспетчер учетных данных Windows (win32.rs), Secret Service в Linux или связка ключей macOS (unix.rs). Параметры хранят ссылку keychain:<service>/<scope>/<key> на своем месте, записываемую только после того, как связка ключей подтвердит секрет; без связки ключей (или с заблокированной, никогда не разблокированной для DDM) секрет остается в параметрах, как и раньше.

Местоположение сервера загрузки (#140) — это страна адреса, к которому он подключился, ищется в таблице mdm-geo на этом компьютере (countries.rs называет ее на языке интерфейса); задание выпуска перестраивает таблицу из данных месяца (tools/geo/build.py --release).

Интеграция с браузером

page ──► extension ──native messaging──► mdm-nmhost ──ipc──► app

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

Тот же ответ содержит ключи из Параметры → Общие (keys: по каким клавишам page.js удерживает щелчок, чтобы оставить ссылку браузеру или принудительно передать её приложению) и пункты контекстного меню, которые нужно показывать (menu: background.js заново создаёт своё меню при их изменении); ответ на вопрос, можно ли показывать кнопку видео, содержит настройки Панелей загрузки (panel: над видео или аудиопроигрывателями, минимальная длительность, первый угол). Их имена и значения по умолчанию берутся из mdm_ipc::capture и считываются из настроек, которые сохраняет приложение. Расширение запрашивает их снова, когда окно браузера получает фокус (через несколько секунд после последнего запроса), при открытии страницы (15 с) и при загрузке (1 мин).

Список загрузок во всплывающем окне панели инструментов (Приостановить, Продолжить, Открыть папку) и число на кнопке — это list и действия API автоматизации, запрашиваемые через хост с параметром browser: приложение отвечает на них независимо от переключателя API, как и на меню качества кнопки видео, а хост никогда не запускает ради них приложение. Расширение делает запросы, только пока окно открыто или идут загрузки.

Хост обслуживает только собственное расширение DDM. Его идентификаторы находятся в одном месте, mdm_ipc::extension (crates/ipc/src/extension.rs): распакованной копии (UNPACKED_ID, из открытого ключа манифеста), Chrome Web Store (STORE_ID, подписанной собственным ключом магазина: pack.ps1 исключает ключ манифеста из копии магазина), дополнения Firefox (FIREFOX_ID) и его страницы addons.mozilla.org; магазины Edge и Opera являются заполнителями, никогда не обслуживаются, пока расширение не будет там указано. Хост записывает манифест каждого браузера с этими идентификаторами, и приложение предлагает копию магазина (Добавить в Chrome, Добавить в Firefox) перед распакованной.

Удаленное управление

phone ──HTTPS (paired token)──► mdm-remote ──ipc::Sink──► app (answer, remote_add)

--headless(headless.rs, #157) запускает тот же App без eframe: цикл вызывает его tick (то, что logic запускает в каждом кадре) на чистом egui::Context, пробуждаемом каналом команд, и никогда его ui; команды добавляются по мере их добавления пультом дистанционного управления (без окна). Dockerfile и docker/ (Compose, шаблон Unraid) запускают его на сервере (server.md).

Сервер работает на Tokio-среде выполнения приложения, по одному слушателю на каждый адрес локальной сети. Каждый запрос проверяется (Host, Origin, токен), преобразуется в mdm_ipc::Command, помеченный remote (поле, которое не может быть установлено строкой запроса), и передается приложению через тот же канал, что и командная строка; приложение отвечает на него в следующем кадре, как оно отвечает на API автоматизации. Его страница встроена (crates/remote/web), а тексты берутся из каталогов приложения (remote.rs).

Переводы

Каждый текст, отображаемый в пользовательском интерфейсе, проходит через crate::i18n (каталоги craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py перестраивает i18n/en.tsv из исходного кода, с примечанием для переводчиков к каждому тексту (что это, где отображается, его заполнители). tools/i18n/translate.py заполняет то, чего не хватает в других каталогах (строки, помеченные #, machine), следуя руководству по стилю каждого языка (i18n/style/) и глоссарию; строка, проверенная человеком, никогда не заменяется, а CI (reviewed_guard.py) отклоняет изменение, которое удаляет ее. Веб-сайт имеет свои собственные каталоги (i18n/site/, tools/website/translate_site.py).

Изображения

Значок приложения рисуется по геометрии (tools/icon/dannex_logo.py; build_icon.py создаёт все размеры, вручную выровненные по целым пикселям от 16 до 48 px). Везде, где он показывается, берётся рисунок для размера на экране (logo.rs): в Windows это значки в заголовке каждого окна и на панели задач в масштабе своего дисплея (win32::crisp_icons, он же сохраняет их при переносе на другой дисплей), а значок в области уведомлений — в масштабе панели задач. Вид → DDM Значок в области уведомлений показывает его в полном цвете (3D-стиль) или только знак цветом панели задач (Плоский стиль: белый на тёмной панели, тёмный на светлой; шаблонное изображение в macOS) с узкой полоской внизу, пока идут загрузки.

Изображения страниц справки (docs/images/help/) берутся из одного списка, tools/shots/shots.toml: tools/shots/make.py открывает каждое окно через собственную командную строку DDM /show <window> в тестовом экземпляре вне экрана, обрезает и аннотирует его из дерева доступности окна и записывает WebP без потерь; make.py check (CI) поддерживает синхронизацию списка, страниц и файлов. Опубликованные изображения сделаны на GitHub's Windows runner (docs-shots.yml).

Участники

tools/contributors.pyчитает, кто открывал запросы на слияние и проблемы, и кто комментировал, из публичного API GitHub (без учета сопровождающего, Клода и ботов) для каждого места, где им выражается благодарность: домашняя страница веб-сайта, /contributors.html и каждый выпуск на странице «Новости» (build.py, в каждой сборке), примечания к каждому выпуску (release.yml, люди, активные с предыдущего выпуска) и README (python tools/contributors.py readme при подготовке каждого выпуска: его круглые фотографии фиксируются в art/contributors/, так как GitHub не может округлить изображение в README).

Тесты и бенчмарки

cargo testзапускает модульные тесты и сквозные загрузки против mdm-labserver с внедренными ошибками (медленные, отброшенные и отклоненные соединения, серверы без диапазонов, изменяющиеся файлы). tools/bench запускает опубликованное сравнение скоростей; его необработанные данные находятся в docs/bench/.

Время кадров окон измеряется, а не угадывается (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 каждую секунду записывает в журнал проходы главного окна, сколько из них вызвано вводом, сколько они стоят (главное окно, окна хода загрузки, их компоновка) и какие строки кода запросили остальные; MDM_SYNTHETIC_LIST=10000 (с тестовым MDM_DATA_DIR) добавляет столько выдуманных строк; MDM_BENCH_SCROLL=10 сам прокручивает список десять секунд и записывает время кадров. У неактивного окна кадров нет, кроме кадров его часов (один раз в 2 с); список создаёт только видимые строки.

Бесплатно, с открытым исходным кодом, без рекламы, без пробного периода.

Загрузить Dannex Download Manager