Как устроены компоненты 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