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 та магнітні посилання через 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

Коли кожен сегмент завершено, файл частини перевіряється на відповідність очікуваному розміру та перейменовується на місце; дата файлу може відповідати даті сервера.

Перший запит на завантаження (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 називає форму кожного елемента керування (текстові поля, прапорці, кнопки, індикатори прогресу, смуги прокрутки, маркер фокусу, рядок заголовка); теми стилів (Метро, 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, Finder macOS (NSWorkspace), тема іконок робочого столу Linux (xdgicons.rs, shared-mime-info та Icon Theme Specification). Кожен тип шукається один раз для кожного розміру пікселів у фоновому потоці. Іконки Tango (в комплекті) використовуються, доки системна іконка не буде готова, і скрізь, де система не має жодної.

Малювання

Вікна малюються за допомогою OpenGL (eframe's glow) або власного графічного 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). Хост браузера читає той самий файл для правил перехоплення, тому зміна в Параметрах застосовується до наступного перехопленого завантаження.

Секрети входу (облікові записи дебрид-сервісів, логіни на сайтах та паролі проксі) зберігаються в системному сховищі ключів (secrets.rs, #44): Windows Credential Manager (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 с) і під час завантаження (хвилина).

Список завантажень у спливному вікні панелі інструментів (Пауза, Відновити, Відкрити папку) і число на кнопці — це 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