Dannex Download Manager
  1. Beranda
  2. Bantuan
  3. Arsitektur

Arsitektur

Bagaimana bagian-bagian Dannex Download Manager saling terhubung.

Crates

Jalur Crate Peran
crates/engine mdm-engine Mengunduh satu berkas melalui HTTP(S) atau FTP(S): probe, perencana segmen, pekerja koneksi, status lanjutkan, batas per host, pembatas kecepatan, checksum, skrip proxy
crates/app mdm-app Aplikasi desktop (dannexdownloadmanager.exe, egui): daftar, kategori, antrean, penjadwal, dialog, baki, pengaturan
crates/cli mdm-cli Unduhan tanpa antarmuka dengan progres (get, resume), video, torrent, dan perintah API otomatisasi: pustaka yang dijalankan oleh program aplikasi (dannexdownloadmanager --cli …), dan dannexdownloadmanager-cli, peluncur kecil yang memulainya dengan argumen, terminal, dan kode keluar yang sama
crates/mcp mdm-mcp Server MCP (dannexdownloadmanager-mcp): asisten AI dapat melihat, menambahkan, dan mengontrol unduhan aplikasi yang sedang berjalan melalui API otomatisasi
crates/remote mdm-remote Kontrol jarak jauh (#141): server HTTPS yang digunakan ponsel atau komputer yang dipasangkan di jaringan lokal (halamannya, kode pemasangan, token perangkat, sertifikat yang ditandatangani sendiri); setiap permintaan menjadi perintah API otomatisasi yang dijawab aplikasi
crates/nmhost mdm-nmhost Host pesan asli peramban: mengambil unduhan yang ditangkap dari ekstensi dan menyerahkannya ke aplikasi
crates/ipc mdm-ipc Saluran satu instans (soket lokal yang dilindungi token), folder data, dan aturan penangkapan yang dibagikan oleh aplikasi dan host
crates/debrid mdm-debrid Akun debrid (#44): API resmi layanan (Real-Debrid, AllDebrid, Premiumize, TorBox) mengubah tautan host file menjadi tautan langsung yang diunduh oleh mesin
crates/extract mdm-extract Ekstraksi arsip (#37): zip, tar, gz, dan xz sedang dalam proses; 7z dan RAR melalui 7-Zip yang terinstal, dijalankan sebagai programnya sendiri
crates/geo mdm-geo Lokasi server unduhan (#140): tabel rentang IP-ke-negara yang dibuat dari data DB-IP Lite (tools/geo/build.py), dicari hanya di komputer ini, dan bendera negara
crates/tools mdm-tools Halaman video melalui yt-dlp dan ffmpeg, galeri gambar melalui gallery-dl (berjalan sebagai program terpisah); saat adaptor jaringan dipilih, koneksi mereka melewati proxy DDM di 127.0.0.1 yang mengikatnya (relay.rs)
crates/crash mdm-crash Laporan kerusakan dan macet: proses monitor, minidump di luar proses, tumpukan bersimbol, teks laporan dan log rilis (crash-reports.md)
crates/torrent mdm-torrent BitTorrent dan tautan magnet melalui librqbit
crates/labserver mdm-labserver Server HTTP Range dengan log permintaan dan injeksi kesalahan, dan server FTP/FTPS dengan kesalahannya sendiri, untuk pengujian dan tolok ukur
extension/ — Ekstensi Chromium (MV3) dan Firefox
docs/ — Panduan pengguna dan tutorial, berkas ini, data benchmark; situs web menjadikan panduan sebagai halaman bantuannya, yang dibuka oleh Bantuan
website/ — Halaman dannex.kavangi.co.ke sendiri (beranda, unduh, fitur, tema, FAQ); tools/website/build.py menambahkan bantuan dari docs/ dan berita dari CHANGELOG, dalam 22 bahasa, dan GitHub Pages memublikasikannya

Ketergantungan mengarah ke dalam: app, cli, mcp, nmhost, dan remote menggunakan engine dan ipc; mesin tidak tahu apa-apa tentang UI. Aplikasi hanya melihat mesin melalui kejadiannya (kemajuan, cuplikan tabel segmen, selesai, gagal).

Mesin

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

Setelah semua segmen selesai, file sementara diperiksa apakah ukurannya sesuai harapan, lalu dipindahkan ke lokasi akhir dengan nama yang sesuai; tanggal file dapat mengikuti tanggal dari server.

Permintaan pertama unduhan (get) mengikuti pengalihan dan halaman yang mengarahkan ke file, seperti penyegaran otomatis di halaman tunggu. Situs yang tautannya bukan alamat file memiliki modul di sites/ (Google Drive: sites/gdrive.rs): modul ini mengubah tautan menjadi alamat file, membaca halaman milik situs (formulir konfirmasi, halaman kesalahan), dan mengidentifikasi alasan penolakannya (Error::Refused). Fungsi-fungsi murninya diuji tanpa jaringan. Server lab meniru situs tersebut dengan nama host aslinya untuk pengujian menyeluruh (labserver/src/drive.rs).

FTP dan FTPS (ftp.rs) menggunakan perencana, pekerja, dan status yang sama: segmen berupa REST + RETR pada sesi kontrol, bukan GET; SIZE dan MDTM berjangka digunakan sebagai pengganti header, dan sesi dikumpulkan per unduhan serta digunakan kembali antarsegmen.

Aplikasi

Satu jendela egui digambar ke koordinat piksel tetap, ditambah satu viewport langsung per dialog. app.rs menyimpan status (unduhan, antrean, pengaturan, pilihan daftar) dan mengubah perintah menu, bilah alat, kunci, dan IPC menjadi tindakan. Setiap dialog adalah modulnya sendiri dan mengembalikan Outcome (terbuka, tertutup, selesai dengan nilai). Panggilan khusus Windows terbatas pada win32.rs dan padanannya di Linux dan macOS pada unix.rs (dimulai dengan sesi, host browser, suara, tampilkan di folder, penangan crash); setiap file lainnya adalah Rust yang aman dan portabel. Font berasal dari sistem: folder Fonts Windows, font sistem macOS, fontconfig di Linux (theme.rs). Di Windows, teks Latin, Yunani, dan Sirilik digambar oleh DirectWrite (win32.rs, melalui kait rasterizer glyph egui): Tampilan → Teks → Halus dalam mode alaminya, anti-alias pada ukuran yang diminta dan ditempatkan pada seperempat piksel dengan kemajuan font itu sendiri; Klasik (default) dalam mode GDI-klasik, sehingga bentuk berpetunjuk dan lebar piksel penuh setiap huruf menyatu. Skrip lain dibentuk dan digambar oleh egui.

Tema

Setiap warna dan ukuran kontrol digambar berasal dari tema aktif (#45). Sebuah tema adalah palet terang dan gelap, metrik, gaya kontrol, dan gaya ikon (palette.rs):

  • Peran palet. palette.rs mendeklarasikan setiap peran dengan kunci stabil ("button.hot", "list.row", "caption"…), deskripsi, dan nilai terang serta gelap tampilan klasik, dituliskan (tampilan klasik tidak diturunkan). Pelukis bersama (winui.rs, chrome.rs, list.rs, scrollbar.rs) membacanya melalui theme::colors() dan theme::metrics() dan memutuskan status setiap kontrol darinya; tidak ada kode lukisan yang memiliki warna sendiri.
  • Palet turunan. derive.rs membuat seluruh palet dari beberapa benih (latar belakang, permukaan, teks, aksen…), mencampur setiap peran lain di OKLab dan menjaga kontras WCAG (4.5:1 untuk teks, 3:1 untuk tepi); Kontras tinggi memperkuat setiap tepi di atasnya. native.rs memberi benih tema Sistem dari aksen dan kontras sistem (pengaturan Windows, portal freedesktop di Linux, aksen macOS).
  • Gaya kontrol. palette::Controls menamai bentuk setiap kontrol (kotak teks, kotak centang, tombol, bilah kemajuan, bilah gulir, tanda fokus, bilah judul); tema gaya (Metro, Adwaita, Breeze, Luna, Aero, Aqua, Emerald) memilih gayanya, dan di Windows DDM kemudian menggambar bilah judul itu sendiri (peran caption.*).
  • File tema. themefile.rs membaca TOML atau JSON dari folder data themes (satu file, atau <id>/theme.toml dengan ikon di sampingnya). Sebuah file hanya menamai apa yang diubahnya; sisanya berasal dari tema yang inherits (ID bawaan atau file lain, tampilan klasik secara default), menyusuri rantai di mana siklus ditolak. Kunci yang tidak dikenal adalah peringatan, bukan kesalahan. Tema gaya bawaan juga merupakan file semacam itu, dibawa dalam program (crates/app/assets/themes).
  • Set ikon. themeicons.rs menggambar ikon tema (dinamai berdasarkan fungsinya: tb-add-url, cat-music…, SVG atau PNG pada 16, 24, 32, dan 48 px, -symbolic yang diwarnai dengan warna teks) di mana tampilan klasik menggambar ikonnya sendiri; kebutuhan yang tidak dimiliki set akan mempertahankan ikon klasik.
  • Gaya ikon bilah alat. Tampilan → Bilah Alat → Gaya garis (garis tepi, diwarnai sesuai tema) atau Gaya 3D: gambar mengilap milik DDM sendiri (assets/icons/toolbar3d, digambar oleh tools/icon/toolbar_3d.py pada 16 hingga 64 px, sesuai ukuran di layar; diredupkan oleh icons.rs saat dinonaktifkan). Gaya ini berlaku pada tombol yang ikonnya tidak disediakan tema dan mewarnai ikonnya dengan warnanya sendiri; tema dengan set ikon sendiri, atau yang mewarnai ikon dengan satu warna (Kontras tinggi), tetap memakai ikonnya sendiri.

Di mana jendela menempatkan kontrolnya tetap menjadi tata letaknya. Begitu juga ikon sebelum nama file (fileicons.rs): daftar gambar sistem shell Windows, Finder macOS (NSWorkspace), tema ikon desktop Linux (xdgicons.rs, shared-mime-info dan Spesifikasi Tema Ikon). Setiap jenis dicari sekali per ukuran piksel, pada utas latar belakang. Ikon Tango (dibundel) berfungsi sampai ikon sistem siap, dan di mana pun sistem tidak memilikinya.

Menggambar

Jendela digambar dengan OpenGL (glow eframe) atau dengan API grafis sistem sendiri melalui wgpu eframe, dengan hanya satu backend itu: Direct3D 12 di Windows (default di sana), Vulkan di Linux, Metal di macOS (pilihan di sana; OpenGL tetap menjadi default mereka sampai kartu grafis sungguhan mencobanya, #206). Tampilan → Render dengan memilih salah satu, dari awal berikutnya. Satu jalur kode melakukannya di setiap sistem (crates/app/src/renderer.rs): ketika yang dipilih tidak dapat dimulai, yang lain dicoba, sehingga jendela selalu terbuka. Mulai yang diawasi dengan API sistem meninggalkan penanda sampai bingkai pertamanya digambar: mulai yang berakhir sebelumnya (crash di dalam driver), yang bingkai pertamanya tidak datang dalam 10 detik (DDM kemudian mulai lagi dengan OpenGL), atau kartu grafis yang hilang dua kali dalam 10 menit diingat dengan alasannya, yang ditunjukkan menu.

Tampilan → Ukuran antarmuka (scale.rs, #262) adalah faktor zoom egui di atas skala tampilan sendiri: setiap jendela ditata dalam poin, sehingga terbuka lebih besar; yang lebih besar dari layar akan menggulir.

Data

Daftar unduhan dan pengaturan disimpan secara atomik ke folder data (downloads.json): %APPDATA%\dannexdownloadmanager\ di Windows, ~/.local/share/dannexdownloadmanager di Linux, ~/Library/Application Support/dannexdownloadmanager di macOS, folder data di samping salinan portabel, atau MDM_DATA_DIR (mdm_ipc::data_dir). Host browser membaca file yang sama untuk aturan pengambilan, sehingga perubahan di Opsi berlaku untuk unduhan yang diambil berikutnya.

Rahasia masuk (akun debrid, Login Situs, dan kata sandi proxy) disimpan di rantai kunci sistem (secrets.rs, #44): Windows Credential Manager (win32.rs), Secret Service di Linux atau rantai kunci macOS (unix.rs). Pengaturan menyimpan referensi keychain:<service>/<scope>/<key> di tempatnya, ditulis hanya setelah rantai kunci mengonfirmasi rahasia; tanpa rantai kunci (atau dengan yang terkunci, tidak pernah dibuka untuk DDM) rahasia tetap ada di pengaturan seperti sebelumnya.

Lokasi server unduhan (#140) adalah negara dari alamat yang terhubung, dicari di tabel mdm-geo di komputer ini (countries.rs menamainya dalam bahasa antarmuka); tugas rilis membangun kembali tabel dari data bulan itu (tools/geo/build.py --release).

Integrasi browser

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

Ekstensi meminta host jenis file apa yang akan diambil, memeriksa setiap unduhan terhadapnya, dan membatalkan unduhan browser hanya setelah aplikasi menerimanya; jika tidak, browser menyimpannya, dan ekstensi mengatakan alasannya.

Jawaban yang sama membawa tombol di Opsi → Umum (keys: kunci yang dipakai page.js untuk menahan klik, agar tautan diserahkan ke browser atau dipaksa ke aplikasi) dan item klik kanan yang ditampilkan (menu: background.js membuat ulang menunya saat item berubah); jawaban tentang boleh tidaknya tombol video tampil membawa pengaturan Panel unduhan (panel: di atas video atau pemutar suara, durasi minimum, sudut pertama). Nama dan nilai bawaannya milik mdm_ipc::capture, dibaca dari pengaturan yang disimpan aplikasi. Ekstensi bertanya lagi saat jendela browser kembali mendapat fokus (beberapa detik setelah pertanyaan terakhir), saat halaman dimulai (15 dtk), dan saat ada unduhan (semenit).

Daftar unduhan di popup bilah alat (Jeda, Lanjutkan, Buka folder) dan angka pada tombol adalah list dan aksi API otomatisasi, yang ditanyakan lewat host dengan browser diatur: aplikasi menjawabnya apa pun status sakelar API, seperti ia menjawab menu kualitas tombol video, dan host tidak pernah memulai aplikasi untuk itu. Ekstensi hanya bertanya saat popup terbuka atau unduhan berjalan.

Host hanya melayani ekstensi DDM sendiri. ID-nya ada di satu tempat, mdm_ipc::extension (crates/ipc/src/extension.rs): salinan yang belum dikemas (UNPACKED_ID, dari kunci publik manifes), Chrome Web Store (STORE_ID, ditandatangani dengan kunci toko sendiri: pack.ps1 meninggalkan kunci manifes dari salinan toko), add-on Firefox (FIREFOX_ID) dan halaman addons.mozilla.org-nya; toko Edge dan Opera adalah placeholder, tidak pernah dilayani, sampai ekstensi terdaftar di sana. Host menulis manifes setiap browser dengan ID tersebut, dan aplikasi menawarkan salinan toko (Tambah ke Chrome, Tambah ke Firefox) sebelum yang belum dikemas.

Kontrol jarak jauh

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

--headless(headless.rs, #157) menjalankan App yang sama tanpa eframe: sebuah loop memanggil tick-nya (apa yang dijalankan logic di setiap bingkai) pada egui::Context kosong, dibangunkan oleh saluran perintah, dan tidak pernah ui-nya; perintah ditambahkan saat remote control menambahkannya (tanpa jendela). Dockerfile dan docker/ (Compose, template Unraid) menjalankannya di server (server.md).

Server berjalan pada runtime Tokio aplikasi, satu pendengar per alamat jaringan lokal. Setiap permintaan diperiksa (Host, Origin, token), diubah menjadi mdm_ipc::Command yang ditandai remote (bidang yang tidak dapat diatur oleh baris permintaan) dan diserahkan ke aplikasi melalui saluran yang sama dengan baris perintah; aplikasi menjawabnya pada bingkai berikutnya, seperti halnya menjawab API otomatisasi. Halamannya dibuat di dalam (crates/remote/web) dan teksnya berasal dari katalog aplikasi (remote.rs).

Terjemahan

Setiap teks yang ditampilkan UI melewati crate::i18n (katalog craft-i18n, i18n/<locale>.tsv). tools/i18n/extract.py membangun kembali i18n/en.tsv dari sumber, dengan catatan untuk penerjemah pada setiap teks (apa itu, di mana ditampilkan, placeholder-nya). tools/i18n/translate.py mengisi apa yang tidak dimiliki katalog lain (baris yang ditandai #, machine), mengikuti panduan gaya setiap bahasa (i18n/style/) dan glosarium; baris yang ditinjau seseorang tidak pernah diganti, dan CI (reviewed_guard.py) menggagalkan perubahan yang menghapus satu. Situs web memiliki katalognya sendiri (i18n/site/, tools/website/translate_site.py).

Gambar

Ikon aplikasi digambar dari geometri (tools/icon/dannex_logo.py; build_icon.py menulis semua ukuran, ditempatkan manual pada piksel utuh dari 16 hingga 48 px). Setiap tempat yang menampilkannya memakai gambar sesuai ukuran di layar (logo.rs): di Windows, bilah judul setiap jendela dan ikon bilah tugasnya pada skala layarnya (win32::crisp_icons, yang juga mempertahankannya saat dipindah ke layar lain), dan ikon baki pada skala bilah tugas. Tampilan → DDM Ikon baki menampilkannya berwarna penuh (Gaya 3D) atau hanya tandanya dengan warna tinta bilah tugas (Gaya datar: putih pada bilah tugas gelap, gelap pada bilah tugas terang; gambar templat di macOS), dengan batang tipis di bagian bawahnya selama unduhan berjalan.

Gambar halaman bantuan (docs/images/help/) berasal dari satu daftar, tools/shots/shots.toml: tools/shots/make.py membuka setiap jendela melalui baris perintah /show <window> DDM sendiri dalam instans uji di luar layar, memotong dan menganotasinya dari pohon aksesibilitas jendela, dan menulis WebP lossless; make.py check (CI) menjaga daftar, halaman, dan file tetap sinkron. Yang dipublikasikan diambil di runner Windows GitHub (docs-shots.yml).

Kontributor

tools/contributors.pymembaca siapa yang membuka permintaan tarik dan isu, dan siapa yang berkomentar, dari API publik GitHub (pemelihara, Claude, dan bot tidak disertakan) untuk setiap tempat yang berterima kasih kepada mereka: halaman beranda situs web, /contributors.html dan setiap rilis di halaman Berita (build.py, pada setiap build), catatan setiap rilis (release.yml, orang-orang yang aktif sejak rilis sebelumnya) dan README (python tools/contributors.py readme pada persiapan setiap rilis: foto bulatnya di-commit di art/contributors/, karena GitHub tidak dapat membulatkan gambar di README).

Pengujian dan tolok ukur

cargo testmenjalankan pengujian unit dan unduhan ujung-ke-ujung terhadap mdm-labserver dengan kesalahan yang disuntikkan (koneksi lambat, terputus, dan ditolak, server tanpa rentang, berkas yang berubah). tools/bench menjalankan perbandingan kecepatan yang diterbitkan; data mentahnya ada di docs/bench/.

Bingkai jendela diukur, bukan ditebak (crates/app/src/framestats.rs): MDM_FRAME_STATS=1 mencatat setiap detik proses jendela utama, berapa banyak yang berasal dari input, biayanya (jendela utama, jendela progres, tata letaknya), dan baris kode mana yang meminta sisanya; MDM_SYNTHETIC_LIST=10000 (dengan MDM_DATA_DIR sementara) menambahkan sejumlah baris rekaan; MDM_BENCH_SCROLL=10 menggulir daftar sendiri selama sepuluh detik dan mencatat waktu bingkainya. Jendela yang menganggur tidak punya bingkai selain jam miliknya (satu per 2 dtk); daftar hanya membuat baris yang terlihat.

Gratis, sumber terbuka, tanpa iklan, tanpa masa uji coba.

Unduh Dannex Download Manager