كيف تتكامل أجزاء برنامج Dannex Download Manager معا.
الصناديق (Crates)
| المسار | الصندوق (Crate) | الدور |
|---|---|---|
crates/engine |
mdm-engine |
ينزل ملفا واحدا عبر HTTP(S) أو FTP(S): فحص، مخطط تجزئة، عمال اتصال، حالة استئناف، قيود لكل مضيف، محدد سرعة، مجاميع اختبارية، نصوص وكيل |
crates/app |
mdm-app |
تطبيق سطح المكتب (dannexdownloadmanager.exe، egui): القائمة، الفئات، قوائم الانتظار، المجدول، مربعات الحوار، علبة النظام، الإعدادات. |
crates/cli |
mdm-cli |
تنزيلات بدون واجهة مع التقدم (get، resume)، ومقاطع الفيديو، والتورنت، وأوامر واجهة برمجة التطبيقات للأتمتة: مكتبة يشغلها برنامج التطبيق (dannexdownloadmanager --cli …)، وdannexdownloadmanager-cli، وهو مشغل صغير يبدأ تشغيلها بنفس الوسائط والطرفية ورمز الخروج |
crates/mcp |
mdm-mcp |
خادم MCP (dannexdownloadmanager-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) رابط موقع الاستضافة إلى رابط مباشر يحمله المحرك |
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 الخاصة (الرئيسية، التنزيل، الميزات، السمات، الأسئلة الشائعة)؛ 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/ (جوجل درايف: 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يسمي شكل كل عنصر تحكم (مربعات النصوص، مربعات الاختيار، الأزرار، أشرطة التقدم، أشرطة التمرير، علامة التركيز، شريط العنوان)؛ تختار سمات النمط (Metro، 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ملونة بلون النص) حيث يرسم المظهر الكلاسيكي أيقوناته الخاصة؛ الحاجة التي تفتقر إليها المجموعة تحتفظ بالأيقونة الكلاسيكية. - أنماط أيقونات شريط الأدوات. عرض → شريط الأدوات → نمط خطي (المخططات، بحبر تحدده السمة) أو النمط ثلاثي الأبعاد: صور DDM اللامعة الخاصة (
assets/icons/toolbar3d، يرسمهاtools/icon/toolbar_3d.pyبحجم من 16 إلى 64 بكسل، الأنسب للحجم المعروض؛ ويجعلهاicons.rsرمادية عند تعطيل الزر). تطبق حيث لا تملك السمة أيقونة خاصة لزر وتلون أيقوناتها بألوانها هي؛ أما السمة ذات مجموعة أيقونات، أو التي تلون الأيقونات بلون واحد (تباين عال)، فتحتفظ بأيقوناتها.
يبقى موضع عناصر التحكم في النافذة كما هو. وكذلك الأيقونات قبل أسماء الملفات (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 ثوان (ثم يبدأ 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). يقرأ مضيف المستعرض نفس الملف لقواعد الالتقاط، لذا فإن التغيير في الخيارات ينطبق على التنزيل الملتقط التالي.
توجد أسرار تسجيل الدخول (حسابات debrid، وكلمات مرور تسجيلات دخول المواقع والوكيل) في سلسلة مفاتيح النظام (secrets.rs، #44): مدير بيانات اعتماد Windows (win32.rs)، خدمة الأسرار على 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 والإجراءات من واجهة الأتمتة، تطلب عبر المضيف مع ضبط browser: يجيب البرنامج عنها أيا كان مفتاح الواجهة، كما يجيب عن قائمة جودة زر الفيديو، ولا يشغل المضيف البرنامج من أجلها أبدا. لا يسأل الملحق إلا والنافذة المنبثقة مفتوحة أو التنزيلات جارية.
يخدم المضيف ملحق 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 (حقل لا يمكن لسطر الطلب تعيينه) ويتم تسليمه إلى التطبيق عبر نفس القناة مثل سطر الأوامر؛ يجيب التطبيق عليه في إطاره التالي، كما يجيب على واجهة برمجة تطبيقات الأتمتة. يتم بناء صفحته داخليا (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 بكسل). يأخذ كل مكان يعرضها الرسمة المناسبة لحجمها على الشاشة (logo.rs): على Windows أيقونتا شريط عنوان كل نافذة وشريط المهام بمقياس شاشتها (win32::crisp_icons، الذي يبقيهما أيضا عند النقل إلى شاشة أخرى)، وأيقونة علبة النظام بمقياس شريط المهام. يعرضها عرض → DDM أيقونة علبة النظام بكامل ألوانها (النمط ثلاثي الأبعاد) أو العلامة وحدها بحبر شريط المهام (نمط مسطح: أبيض على شريط مهام داكن، وداكن على فاتح؛ وصورة قالب على macOS)، مع شريط رفيع عند قدمها أثناء جريان التنزيلات.
تأتي صور صفحات التعليمات (docs/images/help/) من قائمة واحدة، tools/shots/shots.toml: يفتح tools/shots/make.py كل نافذة عبر سطر أوامر /show <window> الخاص بـ DDM في مثيل اختبار خارج الشاشة، ويقصها ويضيف إليها التعليقات التوضيحية من شجرة إمكانية الوصول للنافذة، ويكتب 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/.
تقاس إطارات النوافذ ولا تخمن (crates/app/src/framestats.rs): يسجل MDM_FRAME_STATS=1 كل ثانية مرات رسم النافذة الرئيسية، وكم منها جاء من الإدخال، وكلفتها (النافذة الرئيسية ونوافذ التقدم وتخطيطها)، وأي أسطر شيفرة طلبت الباقي؛ ويضيف MDM_SYNTHETIC_LIST=10000 (مع MDM_DATA_DIR تجريبي) هذا العدد من الصفوف المصطنعة؛ ويمرر MDM_BENCH_SCROLL=10 القائمة بنفسه عشر ثوان ويسجل أزمنة الإطارات. النافذة الخاملة لا إطارات لها إلا إطار ساعتها (واحد كل ثانيتين)؛ وترسم القائمة الصفوف المرئية فقط.
مجاني، مفتوح المصدر، بدون إعلانات، بدون فترة تجريبية.
تنزيل Dannex Download Manager