1. Strona główna
  2. Pomoc
  3. Architektura

Architektura

How Matt Download Manager's pieces fit together.

Pakiety

Ścieżka Pakiet Rola
crates/engine mdm-engine Pobiera jeden plik przez HTTP(S) lub FTP(S): sonda, planowanie segmentów, połączenia, stan wznowienia, limity na hosta, ogranicznik prędkości, sumy kontrolne, skrypty proxy
crates/app mdm-app Aplikacja desktopowa (mattdownloadmanager.exe, egui): lista, kategorie, kolejki, harmonogram, okna dialogowe, zasobnik systemowy, ustawienia
crates/cli mdm-cli Pobieranie bez interfejsu graficznego z informacją o postępie (get, resume), wideo, torrenty i polecenia API automatyzacji: biblioteka uruchamiana przez program aplikacji (mattdownloadmanager --cli …) oraz mattdownloadmanager-cli, mały program uruchamiający ją z tymi samymi argumentami, terminalem i kodem wyjścia
crates/mcp mdm-mcp Serwer MCP (mattdownloadmanager-mcp): lista asystentów AI, dodawanie i kontrolowanie pobierania uruchomionej aplikacji poprzez API automatyzacji
crates/remote mdm-remote Zdalne sterowanie (#141): serwer HTTPS, którego używa sparowany telefon lub komputer w sieci lokalnej (jego strona, kody parowania, tokeny urządzeń, certyfikat z podpisem własnym); każde żądanie staje się poleceniem API automatyzacji, na które aplikacja odpowiada
crates/nmhost mdm-nmhost Host natywnych wiadomości przeglądarki: pobiera przechwycone pliki z rozszerzenia i przekazuje je do aplikacji
crates/ipc mdm-ipc Kanał pojedynczej instancji (lokalny socket chroniony tokenem), folder danych i reguły przechwytywania współdzielone przez aplikację i hosta
crates/debrid mdm-debrid Konta debrid (#44): oficjalne API usług (Real-Debrid, AllDebrid, Premiumize, TorBox, Mega-Debrid) zamieniają link hosta pliku w bezpośredni link, który pobiera silnik
crates/cnl mdm-cnl Click'n'Load 2 (#37): nasłuch na 127.0.0.1:9666, który odczytuje posty ze strony z linkami do pakietów dla Link grabber, z ograniczeniami co do tego, co pobiera
crates/extract mdm-extract Archive extraction (#37): zip, tar, gz and xz in process; 7z and RAR through an installed 7-Zip, run as its own program; in place through HatchZip when asked
crates/geo mdm-geo Lokalizacja serwera pobierania (#140): tabela zakresów IP-do-kraju zbudowana z danych DB-IP Lite (tools/geo/build.py), wyszukiwana tylko na tym komputerze, oraz flagi krajów.
crates/tools mdm-tools Strony wideo przez yt-dlp i ffmpeg, galerie obrazów przez gallery-dl (uruchamiane jako osobne programy); po wybraniu karty sieciowej ich połączenia przechodzą przez proxy MDM na 127.0.0.1, które je do niej wiąże (relay.rs); każdy program działa w folderze, do którego ma uprawnienia zapisu, będącym również jego folderem TEMP (workdir.rs)
crates/crash mdm-crash Raporty o awariach i zawieszeniach: proces monitorujący, minidumpy poza procesem, symboliczne stosy, tekst raportu i logi wydania (crash-reports.md)
crates/torrent mdm-torrent BitTorrent i linki magnetyczne przez librqbit
crates/labserver mdm-labserver Serwer HTTP Range z dziennikiem żądań i wstrzykiwaniem błędów oraz serwer FTP/FTPS z własnymi błędami, używane do testów i testów wydajności
extension/ — Rozszerzenie dla Chromium (MV3) i Firefox
docs/ — Podręcznik użytkownika i samouczki, ten plik oraz dane testów wydajności; witryna udostępnia podręcznik jako strony pomocy otwierane przez Pomoc
website/ — https://idm.teachermatt.com's own pages (home, download, features, themes, FAQ); tools/website/build.py adds the help from docs/ and the news from the CHANGELOG, in 22 languages, and GitHub Pages publishes it

Zależności wskazują do wewnątrz: app, cli, mcp, nmhost i remote używają engine i ipc; silnik nic nie wie o interfejsie użytkownika. Aplikacja widzi silnik tylko poprzez jego zdarzenia (postęp, migawki tabeli segmentów, zakończone, nieudane).

Silnik

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

Po pobraniu wszystkich segmentów plik tymczasowy jest sprawdzany pod kątem zgodności z oczekiwanym rozmiarem, a następnie przenoszony pod właściwą nazwę; data pliku może być taka sama jak data na serwerze.

A download's first request (get) follows redirects and the pages that lead on to a file by themselves (a waiting page's refresh). Sites whose links aren't the file's address have a module in sites/ (Google Drive: sites/gdrive.rs; MediaFire: sites/mediafire.rs): it turns the link into the file's address, reads the site's own pages (a confirmation form, a download button, an error page), names its refusals (Error::Refused) and, where the file's addresses expire, the page that gives a fresh one (sites::origin, asked again when a connection meets an expired address), with pure functions tested without a network. The lab server plays such a site on its real host names for the end-to-end tests (labserver/src/drive.rs, labserver/src/mediafire.rs).

FTP i FTPS (ftp.rs) korzystają z tego samego modułu planowania, obsługi połączeń i stanu: segment jest pobierany przez REST + RETR w sesji kontrolnej zamiast przez zakresowe GET, nagłówki zastępują SIZE i MDTM, a sesje są grupowane w ramach pobierania i ponownie wykorzystywane między segmentami.

Aplikacja

One egui window painted to fixed pixel coordinates, plus one immediate viewport per dialog. app.rs holds the state (downloads, queues, settings, the list's selection) and turns menu, toolbar, key and IPC commands into actions. Each dialog is its own module and returns an Outcome (open, closed, done with a value). Windows-only calls are confined to win32.rs and their Linux and macOS counterparts to unix.rs (starting with the session, the browsers' host, sounds, show in folder, the crash handler); every other file is safe, portable Rust. Fonts come from the system: Windows' Fonts folder, macOS's system fonts, fontconfig on Linux (theme.rs). The interface language's script fonts load at start; text in another script gets its font the first time it shows: from MDM's lists of the system's fonts for each script, then, on Windows and macOS, from the system's own fallback (DirectWrite's, CoreText's, through fontique: egui_system_font_provider) for what the lists don't name; Linux asks fontconfig for any letter. On Windows, Latin, Greek, Cyrillic and single-codepoint CJK text is drawn by DirectWrite (win32.rs, through egui's glyph rasterizer hook): View → Text → Smooth in its natural mode, anti-aliased at the size asked for and placed at quarter pixels with the font's own advances; Classic (the default) in GDI-classic mode, so each letter's hinted shape and whole-pixel width come together. CJK uses the interface language's system face; combining marks, multi-codepoint clusters and missing glyphs stay with egui, as do other scripts.

Motywy

Każdy kolor i rozmiar, z jakim rysowany jest element sterujący, pochodzi z aktywnego motywu (#45). Motyw to jasna i ciemna paleta, metryki, style elementów sterujących i styl ikon (palette.rs):

  • Role palety. palette.rs deklaruje każdą rolę ze stabilnym kluczem ("button.hot", "list.row", "caption"…), opisem oraz wartościami jasnymi i ciemnymi klasycznego wyglądu, zapisanymi wprost (klasyczny wygląd nie jest pochodny). Wspólne moduły rysujące (winui.rs, chrome.rs, list.rs, scrollbar.rs) odczytują je przez theme::colors() i theme::metrics() i na ich podstawie decydują o stanach każdego elementu sterującego; żaden kod rysujący nie przechowuje własnego koloru.
  • Palety pochodne. derive.rs tworzy całą paletę z kilku „ziaren” (tło, powierzchnia, tekst, akcent…), mieszając każdą inną rolę w OKLab i zachowując kontrast WCAG (4.5:1 dla tekstu, 3:1 dla krawędzi); Wysoki kontrast dodatkowo wzmacnia każdą krawędź. native.rs zasila motyw Natywny akcentem i kontrastem systemu (ustawienia Windows, portal freedesktop w systemie Linux, akcent macOS).
  • Style kontrolek. palette::Controls nazywa kształt każdej kontrolki (pola tekstowe, pola wyboru, przyciski, paski postępu, paski przewijania, znacznik fokusu, pasek tytułu); motywy stylów (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) wybierają swoje, a w Windows MDM samodzielnie rysuje pasek tytułu (role caption.*).
  • Pliki motywów. themefile.rs odczytuje TOML lub JSON z folderu danych themes (jeden plik lub <id>/theme.toml z ikonami obok). Plik nazywa tylko to, co zmienia; reszta pochodzi z motywu, który inherits (ID wbudowanego lub inny plik, domyślnie klasyczny wygląd), w łańcuchu, w którym cykl jest odrzucany. Nieznane klucze to ostrzeżenia, nie błędy. Wbudowane motywy stylów to również takie pliki, przenoszone w programie (crates/app/assets/themes).
  • Zestawy ikon. themeicons.rs rysuje ikony motywu (nazwane według przeznaczenia: tb-add-url, cat-music…, SVG lub PNG w rozmiarach 16, 24, 32 i 48 px, -symbolic w kolorze tekstu) tam, gdzie klasyczny wygląd rysuje swoje; brakująca ikona w zestawie zachowuje ikonę klasyczną.

Układ okna z jego elementami sterującymi pozostaje stały. Podobnie jest z ikonami przed nazwami plików (fileicons.rs): listy obrazów systemowych powłoki Windows, macOS Finder (NSWorkspace), motyw ikon pulpitu Linux (xdgicons.rs, shared-mime-info i Icon Theme Specification). Każdy typ jest wyszukiwany raz na rozmiar piksela, w osobnym wątku. Ikony Tango (dołączone) zastępują ikony systemowe, dopóki te nie będą gotowe, oraz wszędzie tam, gdzie system ich nie ma.

Rysowanie

Okna są rysowane za pomocą OpenGL (eframe's glow) lub za pomocą systemowego API graficznego przez wgpu eframe, tylko z jednym backendem: Direct3D 12 w systemie Windows (domyślnie), Vulkan w systemie Linux, Metal w systemie macOS (wybory tam; OpenGL pozostaje ich domyślnym, dopóki prawdziwe karty graficzne ich nie wypróbują, #206). Widok → Rysuj za pomocą wybiera jeden, od następnego uruchomienia. Jedna ścieżka kodu robi to w każdym systemie (crates/app/src/renderer.rs): gdy wybrany nie może się uruchomić, próbowany jest inny, więc okna zawsze się otwierają. Monitorowane uruchomienie z API systemowym pozostawia znacznik, dopóki nie zostanie narysowana pierwsza klatka: uruchomienie, które kończy się wcześniej (awaria sterownika), takie, którego pierwsza klatka nie pojawi się w ciągu 10 sekund (MDM uruchamia się wtedy ponownie z OpenGL), lub karta graficzna utracona dwukrotnie w ciągu 10 minut jest zapamiętywana z przyczyną, którą pokazuje menu.

Widok → Rozmiar interfejsu (scale.rs, #262) to współczynnik powiększenia egui ponad własną skalę wyświetlacza: każde okno jest układane w punktach, więc otwiera się o tyle większe; większe niż ekran przewija się.

Dane

Lista pobierania i ustawienia są zapisywane atomowo w folderze danych (downloads.json): %APPDATA%\mattdownloadmanager\ w systemie Windows, ~/.local/share/mattdownloadmanager w systemie Linux, ~/Library/Application Support/mattdownloadmanager w systemie macOS, folder data obok przenośnej kopii lub MDM_DATA_DIR (mdm_ipc::data_dir). Host przeglądarki odczytuje ten sam plik dla reguł przechwytywania, więc zmiana w Opcjach ma zastosowanie do następnego przechwyconego pobierania.

Tajne dane logowania (konta debrid, hasła do Loginy do witryn i proxy) są przechowywane w systemowym pęku kluczy (secrets.rs, #44): Menedżer poświadczeń Windows (win32.rs), Secret Service w systemie Linux lub pęk kluczy macOS (unix.rs). Ustawienia przechowują odniesienie keychain:<service>/<scope>/<key> w swoim miejscu, zapisywane tylko raz, gdy pęk kluczy potwierdził tajne dane; bez pęku kluczy (lub z zablokowanym, nigdy nie odblokowanym dla MDM) tajne dane pozostają w ustawieniach jak poprzednio.

Lokalizacja serwera pobierania (#140) to kraj adresu, z którym się połączono, wyszukany w tabeli mdm-geo na tym komputerze (countries.rs nazywa go w języku interfejsu); zadanie wydania ponownie buduje tabelę z danych z danego miesiąca (tools/geo/build.py --release).

Integracja z przeglądarką

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

Rozszerzenie pyta hosta, jakie typy plików ma pobierać, sprawdza każde pobieranie pod ich kątem i anuluje pobieranie przeglądarki dopiero po zaakceptowaniu go przez aplikację; w przeciwnym razie przeglądarka je zachowuje, a rozszerzenie podaje przyczynę.

A message to the host is at most 1 MB (mdm_ipc::MAX_MESSAGE; the host refuses more, and the browser lets a host answer no more than that either). A page's links past it go in parts, each measured as the widest browser writes it (wireSize in background.js) and carrying the page's referrer and cookies and its place (mdm_ipc::LinksPart); the host hands each over as it comes, and the app keeps them (linkparts.rs) until the last is in, then opens Link grabber with the whole list.

Host obsługuje tylko własne rozszerzenie MDM. Jego identyfikatory znajdują się w jednym miejscu, mdm_ipc::extension (crates/ipc/src/extension.rs): rozpakowanej kopii (UNPACKED_ID, z klucza publicznego manifestu), Chrome Web Store (STORE_ID, podpisanej własnym kluczem sklepu: pack.ps1 pomija klucz manifestu z kopii sklepu), dodatku Firefox (FIREFOX_ID) i jego strony addons.mozilla.org; identyfikatory sklepów Edge i Opera są symbolami zastępczymi, nigdy nieobsługiwanymi, dopóki rozszerzenie nie zostanie tam wymienione. Host zapisuje manifest każdej przeglądarki z tymi identyfikatorami, a aplikacja oferuje kopię ze sklepu (Dodaj do Chrome, Dodaj do Firefox) przed rozpakowaną.

Zdalne sterowanie

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

--headless(headless.rs, #157) uruchamia ten sam App bez eframe: pętla wywołuje jego tick (to, co logic uruchamia w każdej klatce) na czystym egui::Context, budzona przez kanał poleceń, i nigdy jego ui; polecenia są dodawane, gdy dodaje je zdalne sterowanie (bez okna). Dockerfile i docker/ (Compose, szablon Unraid) uruchamiają go na serwerze (server.md).

Serwer działa w środowisku uruchomieniowym Tokio aplikacji, jeden słuchacz na adres sieci lokalnej. Każde żądanie jest sprawdzane (Host, Origin, token), zamieniane na mdm_ipc::Command oznaczone remote (pole, którego żadna linia żądania nie może ustawić) i przekazywane do aplikacji przez ten sam kanał co wiersz poleceń; aplikacja odpowiada na nie w następnej klatce, tak jak odpowiada na API automatyzacji. Jego strona jest wbudowana (crates/remote/web), a teksty pochodzą z katalogów aplikacji (remote.rs).

Tłumaczenia

Każdy tekst wyświetlany w interfejsie użytkownika przechodzi przez crate::i18n (katalogi craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py odbudowuje i18n/en.tsv ze źródła, z notatką dla tłumaczy przy każdym tekście (co to jest, gdzie się wyświetla, jego symbole zastępcze). tools/i18n/translate.py uzupełnia to, czego brakuje w innych katalogach (wiersze oznaczone #, machine), zgodnie z przewodnikiem stylistycznym każdego języka (i18n/style/) i słownikiem; wiersz, który został przejrzany przez osobę, nigdy nie jest zastępowany, a CI (reviewed_guard.py) odrzuca zmianę, która go usuwa. Strona internetowa ma własne katalogi (i18n/site/, tools/website/translate_site.py).

Obrazy

Obrazy stron pomocy (docs/images/help/) pochodzą z jednej listy, tools/shots/shots.toml: tools/shots/make.py otwiera każde okno za pomocą własnego polecenia wiersza poleceń MDM /show <window> w instancji testowej poza ekranem, przycina i opatruje adnotacjami z drzewa dostępności okna i zapisuje bezstratne WebP; make.py check (CI) utrzymuje listę, strony i pliki w synchronizacji. Opublikowane są pobierane na runnerze GitHub Windows (docs-shots.yml).

Współtwórcy

tools/contributors.pyodczytuje z publicznego API GitHub, kto otwierał żądania ściągnięcia i zgłoszenia oraz kto komentował (z wyłączeniem opiekuna, Claude’a i botów), dla każdego miejsca, które im dziękuje: strony głównej witryny, /contributors.html i każdego wydania na stronie Aktualności (build.py, w każdej kompilacji), notatek do każdego wydania (release.yml, osoby aktywne od poprzedniego wydania) oraz pliku README (python tools/contributors.py readme podczas przygotowywania każdego wydania: okrągłe zdjęcia są zatwierdzane w art/contributors/, ponieważ GitHub nie może zaokrąglić obrazu w pliku README).

Testy i benchmarki

cargo testuruchamia testy jednostkowe i kompleksowe pobieranie w stosunku do mdm-labserver z wstrzykniętymi błędami (wolne, zerwane i odrzucone połączenia, serwery bez zakresów, zmieniające się pliki). tools/bench uruchamia opublikowane porównanie prędkości; jego surowe dane znajdują się w docs/bench/.

Darmowy, open source, bez reklam, bez wersji próbnej.

Pobierz Matt Download Manager