1. الرئيسية
  2. تعليمات
  3. البنية الداخلية

البنية الداخلية

How Matt Download Manager's pieces fit together.

الصناديق (Crates)

المسار الصندوق (Crate) الدور
crates/engine mdm-engine ينزل ملفا واحدا عبر HTTP(S) أو FTP(S): فحص، مخطط تجزئة، عمال اتصال، حالة استئناف، قيود لكل مضيف، محدد سرعة، مجاميع اختبارية، نصوص وكيل
crates/app mdm-app تطبيق سطح المكتب (mattdownloadmanager.exe، egui): القائمة، الفئات، قوائم الانتظار، المجدول، مربعات الحوار، علبة النظام، الإعدادات.
crates/cli mdm-cli تنزيلات بدون واجهة مع التقدم (get، resume)، ومقاطع الفيديو، والتورنت، وأوامر واجهة برمجة التطبيقات للأتمتة: مكتبة يشغلها برنامج التطبيق (mattdownloadmanager --cli …)، وmattdownloadmanager-cli، وهو مشغل صغير يبدأ تشغيلها بنفس الوسائط والطرفية ورمز الخروج
crates/mcp mdm-mcp خادم MCP (mattdownloadmanager-mcp): مساعدو الذكاء الاصطناعي يسردون ويضيفون ويتحكمون في تنزيلات التطبيق قيد التشغيل عبر واجهة برمجة تطبيقات الأتمتة.
crates/remote mdm-remote التحكم عن بعد (#141): خادم HTTPS الذي يستخدمه هاتف أو كمبيوتر مقترن على الشبكة المحلية (صفحته، رموز الاقتران، رموز الجهاز، الشهادة الموقعة ذاتيا)؛ يصبح كل طلب أمرا لواجهة برمجة تطبيقات الأتمتة يستجيب له التطبيق
crates/nmhost mdm-nmhost مضيف الرسائل الأصلية للمتصفح: يأخذ التنزيلات الملتقطة من الإضافة ويسلمها إلى التطبيق.
crates/ipc mdm-ipc قناة المثيل الواحد (مقبس محلي محمي برمز)، مجلد البيانات، وقواعد الالتقاط المشتركة بين التطبيق والمضيف.
crates/debrid mdm-debrid حسابات Debrid (العدد 44): تحول واجهات برمجة التطبيقات الرسمية للخدمات (Real-Debrid وAllDebrid وPremiumize وTorBox وMega-Debrid) رابط موقع الاستضافة إلى رابط مباشر يقوم المحرك بتنزيله.
crates/cnl mdm-cnl Click'n'Load 2 (العدد 37): المستمع على 127.0.0.1:9666 الذي يقرأ منشورات موقع الروابط ويحولها إلى حزم لـ«ملتقط الروابط»، مع قيود على ما يأخذه.
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 موقع خادم التنزيل (#140): جدول نطاق IP إلى بلد مبني من بيانات DB-IP Lite (tools/geo/build.py)، يتم البحث فيه على هذا الكمبيوتر فقط، وأعلام البلدان
crates/tools mdm-tools صفحات الفيديو عبر yt-dlp و ffmpeg، ومعارض الصور عبر gallery-dl (تعمل كبرامج منفصلة)؛ بينما يتم اختيار محول شبكة، تمر اتصالاتها عبر وكيل MDM على 127.0.0.1 يربطها به (relay.rs)؛ يعمل كل منها في مجلد يمكنه الكتابة فيه، وهو أيضا مجلد TEMP الخاص به (workdir.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/ — 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

تتجه التبعيات إلى الداخل: 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

عند الانتهاء من كل جزء، يتم فحص الملف الجزئي مقابل الحجم المتوقع وإعادة تسميته إلى مكانه؛ يمكن أن يتبع تاريخ الملف تاريخ الخادم.

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 و FTPS (ftp.rs) عبر نفس المخطط والعمال والحالة: التجزئة هي REST + RETR على جلسة تحكم بدلا من GET ذات النطاق، SIZE و MDTM تحل محل الرؤوس، ويتم تجميع الجلسات لكل تنزيل وإعادة استخدامها بين التجزئات.

التطبيق

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.

السمات

كل لون وحجم يتم رسم عنصر التحكم به يأتي من السمة النشطة (#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 يرسم MDM بعد ذلك شريط العنوان بنفسه (أدوار 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 ملونة بلون النص) حيث يرسم المظهر الكلاسيكي أيقوناته الخاصة؛ الحاجة التي تفتقر إليها المجموعة تحتفظ بالأيقونة الكلاسيكية.

يبقى موضع عناصر التحكم في النافذة كما هو. وكذلك الأيقونات قبل أسماء الملفات (fileicons.rs): قوائم صور نظام Windows shell، قوائم macOS Finder (NSWorkspace)، سمة أيقونات سطح مكتب Linux (xdgicons.rs، shared-mime-info ومواصفات سمة الأيقونات). يتم البحث عن كل نوع مرة واحدة لكل حجم بكسل، على خيط خلفي. أيقونات Tango (المضمنة) تحل محلها حتى تصبح أيقونة النظام جاهزة، وفي أي مكان لا يملك فيه النظام أيقونة.

الرسم

ترسم النوافذ باستخدام OpenGL (توهج eframe) أو باستخدام واجهة برمجة تطبيقات الرسوميات الخاصة بالنظام عبر wgpu الخاص بـ eframe، مع هذا الواجهة الخلفية فقط: Direct3D 12 على Windows (الافتراضي هناك)، Vulkan على Linux، Metal على macOS (خيارات هناك؛ يبقى OpenGL هو الافتراضي حتى تجربها بطاقات الرسوميات الحقيقية، #206). يختار عرض → الرسم باستخدام واحدة، من البدء التالي. مسار رمز واحد يقوم بذلك على كل نظام (crates/app/src/renderer.rs): عندما لا يمكن بدء التشغيل المختار، يتم تجربة الآخر، بحيث تفتح النوافذ دائما. يترك البدء المراقب باستخدام واجهة برمجة تطبيقات النظام علامة حتى يتم رسم إطاره الأول: يتم تذكر البدء الذي ينتهي قبله (تعطل داخل برنامج التشغيل)، أو الذي لا يأتي إطاره الأول في غضون 10 ثوان (ثم يبدأ MDM مرة أخرى باستخدام OpenGL)، أو بطاقة رسوميات فقدت مرتين في 10 دقائق مع سببها، والذي تظهره القائمة.

عرض → حجم الواجهة (scale.rs، #262) هو عامل تكبير egui على مقياس الشاشة الخاص: يتم ترتيب كل نافذة بالنقاط، لذا تفتح بهذا الحجم الأكبر؛ النافذة الأكبر من الشاشة يتم تمريرها.

البيانات

يتم حفظ قائمة التنزيلات والإعدادات بشكل ذري في مجلد البيانات (downloads.json): %APPDATA%\mattdownloadmanager\ على Windows، ~/.local/share/mattdownloadmanager على Linux، ~/Library/Application Support/mattdownloadmanager على macOS، مجلد data بجانب نسخة محمولة، أو MDM_DATA_DIR (mdm_ipc::data_dir). يقرأ مضيف المستعرض نفس الملف لقواعد الالتقاط، لذا فإن التغيير في الخيارات ينطبق على التنزيل الملتقط التالي.

توجد أسرار تسجيل الدخول (حسابات debrid، وكلمات مرور تسجيلات دخول المواقع والوكيل) في سلسلة مفاتيح النظام (secrets.rs، #44): مدير بيانات اعتماد Windows (win32.rs)، خدمة الأسرار على Linux أو سلسلة مفاتيح macOS (unix.rs). تحتفظ الإعدادات بمرجع keychain:<service>/<scope>/<key> في مكانها، ولا يكتب إلا بعد أن تؤكد سلسلة المفاتيح السر؛ بدون سلسلة مفاتيح (أو مع سلسلة مفاتيح مقفلة، لم تفتح لـ MDM أبدا) يبقى السر في الإعدادات كما كان من قبل.

موقع خادم التنزيل (#140) هو بلد العنوان الذي اتصل به، ويتم البحث عنه في جدول mdm-geo على هذا الكمبيوتر (countries.rs يسميه بلغة الواجهة)؛ تعيد مهمة الإصدار بناء الجدول من بيانات الشهر (tools/geo/build.py --release).

تكامل المتصفح

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

يطلب الملحق من المضيف أنواع الملفات التي يجب أخذها، ويتحقق من كل تنزيل مقابلها، ويلغي تنزيل المستعرض فقط بعد أن يقبله التطبيق؛ وإلا يحتفظ المستعرض به، ويذكر الملحق السبب.

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.

يخدم المضيف ملحق MDM الخاص فقط. توجد معرفاته في مكان واحد، 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 (حقل لا يمكن لسطر الطلب تعيينه) ويتم تسليمه إلى التطبيق عبر نفس القناة مثل سطر الأوامر؛ يجيب التطبيق عليه في إطاره التالي، كما يجيب على واجهة برمجة تطبيقات الأتمتة. يتم بناء صفحته داخليا (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).

الصور

تأتي صور صفحات التعليمات (docs/images/help/) من قائمة واحدة، tools/shots/shots.toml: يفتح tools/shots/make.py كل نافذة عبر سطر أوامر /show <window> الخاص بـ MDM في مثيل اختبار خارج الشاشة، ويقصها ويضيف إليها التعليقات التوضيحية من شجرة إمكانية الوصول للنافذة، ويكتب WebP بدون فقدان؛ يحافظ make.py check (CI) على القائمة والصفحات والملفات متزامنة. تؤخذ الصور المنشورة على GitHub's Windows runner (docs-shots.yml).

المساهمون

tools/contributors.pyيقرأ من فتح طلبات السحب والمشكلات، ومن علق، من واجهة برمجة تطبيقات 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/.

مجاني، مفتوح المصدر، بدون إعلانات، بدون فترة تجريبية.

تنزيل Matt Download Manager