Jak poszczególne części Dannex Download Manager do siebie pasują.
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 (dannexdownloadmanager.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 (dannexdownloadmanager --cli …) oraz dannexdownloadmanager-cli, mały program uruchamiający ją z tymi samymi argumentami, terminalem i kodem wyjścia |
crates/mcp |
mdm-mcp |
Serwer MCP (dannexdownloadmanager-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) zamieniają link z hosta plików w bezpośredni link, który pobiera silnik. |
crates/extract |
mdm-extract |
Rozpakowywanie archiwów (#37): zip, tar, gz i xz w trakcie; 7z i RAR za pośrednictwem zainstalowanego 7-Zip, uruchamianego jako osobny program. |
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 oddzielne programy); po wybraniu adaptera sieciowego ich połączenia przechodzą przez proxy DDM na 127.0.0.1, które je do niego wiąże (relay.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/ |
— | Własne strony dannex.kavangi.co.ke (strona główna, pobieranie, funkcje, motywy, FAQ); tools/website/build.py dodaje pomoc z docs/ i wiadomości z CHANGELOG, w 22 językach, a GitHub Pages to publikuje. |
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.
Pierwsze żądanie pobierania (get) podąża za przekierowaniami i samoczynnymi przekierowaniami ze stron do pliku (na przykład odświeżeniem strony oczekiwania). Dla witryn, których linki nie prowadzą bezpośrednio do pliku, w sites/ znajduje się moduł (sites/gdrive.rs dla Google Drive): zamienia link na adres pliku, odczytuje strony witryny (formularz potwierdzenia, stronę błędu) i obsługuje odmowy witryny (Error::Refused). Czyste funkcje modułu są testowane bez połączenia z siecią. Serwer testowy udostępnia taką witrynę pod jej rzeczywistymi nazwami hostów na potrzeby testów end-to-end (labserver/src/drive.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
Jedno okno egui rysowane do stałych współrzędnych pikseli, plus jeden natychmiastowy obszar widoku na każde okno dialogowe. app.rs przechowuje stan (pobierania, kolejki, ustawienia, zaznaczenie listy) i zamienia polecenia z menu, paska narzędzi, klawiszy i IPC w akcje. Każde okno dialogowe jest własnym modułem i zwraca Outcome (otwarte, zamknięte, zakończone z wartością). Wywołania tylko dla Windows są ograniczone do win32.rs, a ich odpowiedniki dla Linux i macOS do unix.rs (rozpoczynanie sesji, host przeglądarek, dźwięki, pokaż w folderze, obsługa awarii); każdy inny plik to bezpieczny, przenośny Rust. Czcionki pochodzą z systemu: folder Fonts w Windows, czcionki systemowe w macOS, fontconfig w Linux (theme.rs). W Windows tekst łaciński, grecki i cyrylica są rysowane przez DirectWrite (win32.rs, za pośrednictwem haka rasteryzatora glifów egui): Widok → Tekst → Wygładzony w trybie naturalnym, z antyaliasingiem w żądanym rozmiarze i umieszczony na ćwierćpikselach z własnymi odstępami czcionki; Klasyczny (domyślny) w trybie GDI-classic, więc wskazany kształt każdej litery i szerokość całego piksela łączą się. Inne skrypty są kształtowane i rysowane przez egui.
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.rsdeklaruje 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 przeztheme::colors()itheme::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.rstworzy 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.rszasila motyw Natywny akcentem i kontrastem systemu (ustawienia Windows, portal freedesktop w systemie Linux, akcent macOS). - Style kontrolek.
palette::Controlsnazywa 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 DDM samodzielnie rysuje pasek tytułu (rolecaption.*). - Pliki motywów.
themefile.rsodczytuje TOML lub JSON z folderu danychthemes(jeden plik lub<id>/theme.tomlz ikonami obok). Plik nazywa tylko to, co zmienia; reszta pochodzi z motywu, któryinherits(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.rsrysuje ikony motywu (nazwane według przeznaczenia:tb-add-url,cat-music…, SVG lub PNG w rozmiarach 16, 24, 32 i 48 px,-symbolicw kolorze tekstu) tam, gdzie klasyczny wygląd rysuje swoje; brakująca ikona w zestawie zachowuje ikonę klasyczną. - Style ikon paska narzędzi. Widok → Pasek narzędzi → Styl liniowy (kontury, kolorowane zgodnie z motywem) lub Styl 3D: własne błyszczące obrazki DDM (
assets/icons/toolbar3d, rysowane przeztools/icon/toolbar_3d.pyw rozmiarach od 16 do 64 px, zawsze w rozmiarze pasującym do ekranu; wyszarzane przezicons.rs, gdy są wyłączone). Obowiązują tam, gdzie motyw nie ma własnej ikony przycisku i rysuje ikony w ich własnych kolorach; motyw z własnym zestawem ikon albo rysujący ikony jednym kolorem (Wysoki kontrast) zachowuje własne.
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 (DDM 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%\dannexdownloadmanager\ w systemie Windows, ~/.local/share/dannexdownloadmanager w systemie Linux, ~/Library/Application Support/dannexdownloadmanager 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 DDM) 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ę.
Ta sama odpowiedź zawiera klawisze z Opcje → Ogólne (keys: według których page.js rozpoznaje kliknięcie, aby zostawić link przeglądarce lub wymusić jego obsługę przez aplikację) oraz pozycje menu prawego przycisku do pokazania (menu: background.js tworzy swoje menu od nowa, gdy się zmienią); odpowiedź na pytanie, czy przycisk wideo może się pokazać, zawiera ustawienia Paneli pobierania (panel: nad filmami lub odtwarzaczami dźwięku, najkrótsza długość, pierwszy róg). Ich nazwy i wartości domyślne pochodzą z mdm_ipc::capture, odczytanych z ustawień zapisywanych przez aplikację. Rozszerzenie pyta ponownie, gdy okno przeglądarki odzyska fokus (kilka sekund po ostatnim pytaniu), gdy zaczyna się strona (15 s) i przy pobieraniu (po minucie).
Lista pobierań w oknie podręcznym przycisku paska narzędzi (Wstrzymaj, Wznów, Otwórz folder) i liczba na przycisku to list oraz akcje API automatyzacji, o które host pyta z ustawionym browser: aplikacja odpowiada na nie niezależnie od przełącznika API, tak jak na menu jakości przycisku wideo, a host nigdy nie uruchamia dla nich aplikacji. Rozszerzenie pyta tylko wtedy, gdy okno podręczne jest otwarte lub trwają pobierania.
Host obsługuje tylko własne rozszerzenie DDM. 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
Ikona aplikacji jest rysowana na podstawie geometrii (tools/icon/dannex_logo.py; build_icon.py zapisuje każdy rozmiar, ręcznie ułożony na pełnych pikselach od 16 do 48 px). Każde miejsce, które ją pokazuje, bierze rysunek dla swojego rozmiaru na ekranie (logo.rs): w Windows ikony paska tytułu i paska zadań każdego okna w skali jego ekranu (win32::crisp_icons, co zachowuje je także po przeniesieniu na inny ekran), a ikonę w zasobniku w skali paska zadań. Widok → DDM Ikona w zasobniku systemowym pokazuje ją w pełnym kolorze (Styl 3D) albo sam znak w kolorze paska zadań (Styl płaski: biały na ciemnym pasku zadań, ciemny na jasnym; obraz szablonowy w macOS), z cienkim paskiem u dołu, gdy trwają pobierania.
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ń DDM /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/.
Klatki okien są mierzone, a nie zgadywane (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 co sekundę zapisuje w dzienniku przebiegi rysowania głównego okna, ile z nich pochodziło z działań użytkownika, ile kosztowały (główne okno, okna postępu, ich układ) i które wiersze kodu poprosiły o pozostałe; MDM_SYNTHETIC_LIST=10000 (z roboczym MDM_DATA_DIR) dodaje tyle wymyślonych wierszy; MDM_BENCH_SCROLL=10 przewija listę samodzielnie przez dziesięć sekund i zapisuje czasy klatek. Bezczynne okno nie ma klatek poza klatkami swojego zegara (jedna co 2 s); lista rysuje tylko widoczne wiersze.
Darmowy, open source, bez reklam, bez wersji próbnej.
Pobierz Dannex Download Manager