MDeX v2.2.1 (macOS · Windows · Linux · Tauri v2)

MDeX · يُنطق "em-dex" (/ˌemˈdɛks/) — الحرف M يتبعه "dex"، مقطعان لفظيان.

قارئ ومحرر Markdown متعدد اللغات يركّز على الخصوصية والمساعدة عبر AI. تتم معالجة كل ملف محلياً — افتراضياً لا شبكة، لا رفع للملفات، لا مزامنة سحابية، بدون إعلانات، بدون قياس عن بعد؛ الحفظ الذري (المقاوم للأعطال) يمنع فقدان البيانات عند الانهيار أو انقطاع التيار. اعتباراً من v2.0، يقدّم MDeX أيضاً ميزة اختيارية لتحرير بمساعدة الذكاء الاصطناعي — ويمكنه البقاء دون اتصال بالكامل: النموذج المحلي (مثل Ollama) لا يحتاج إلى إنترنت؛ فقط خدمة AI عبر الإنترنت (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi إلخ) تُجري الطلب، وذلك فقط عند تهيئتها وتشغيلها.

• واجهة أمامية بملف HTML واحد مكتفٍ ذاتياً (بدون Vue / React)؛ يوفر Tauri v2 القشرة الأصلية فقط (النوافذ، القوائم، حوارات الملفات).
• صفر طلبات شبكة أثناء التشغيل: marked / KaTeX / highlight.js / DOMPurify / mermaid / jsPDF / html2canvas-pro / turndown / @retorquere/bibtex-parser وجميع خطوط KaTeX بصيغة woff2 مُضمَّنة / مُضمَّنة بـ base64 داخل ملف index.html واحد.
• يدعم الصيغ .md / .markdown / .html؛ ويمكن تعيينه كالتطبيق الافتراضي لفتح .md — انقر مرتين للفتح.

🌐 Languages

تأتي الواجهة بـ 17 لغة: English, 简体中文, Français, Deutsch, Español, Português, Italiano, Русский, 日本語, 한국어, العربية, हिन्दी, ਪੰਜਾਬੀ, Tiếng Việt, Bahasa Indonesia, اردو, Монгол (Кирилл).

• بدِّل اللغة في أي وقت من قائمة اللغات في شريط الأدوات؛ ويتم تذكُّر اختيارك عبر الجلسات.
• تُعرض العربية من اليمين إلى اليسار (RTL) تلقائياً — ينعكس نص المتن، والعناوين، وعلامات القوائم، وكامل شريط الأدوات إلى اليمين؛ أما كتل الشيفرة المُضمَّنة، وصيغ الرياضيات LaTeX، والمصطلحات الإنجليزية، وأرقام الإصدارات فتبقى من اليسار إلى اليمين ولا تنعكس أبداً.
• تُرجم ملف README هذا نفسه إلى جميع اللغات الـ 17 — استخدم المُنتقي أعلى هذه الصفحة.

✨ الميزات

• نوافذ متعددة وعلامات متعددة: افتح عدة ملفات في آن واحد؛ التغييرات غير المحفوظة تُعلَّم بنقطة، ويُطلب منك التأكيد قبل الإغلاق؛ انقر زر الماوس الأوسط على علامة لإغلاقها. النقر المزدوج على ملف .md يفتح نافذة خاصة به (نافذة واحدة لكل ملف)؛ والنقر المزدوج على ملف مفتوح أصلاً ينقل التركيز إلى تلك النافذة بدلاً من فتحه من جديد.
• معاينة مقسَّمة حيَّة: اسحب الفاصل لتغيير الحجم؛ زر شريط الأدوات يتنقل بين المقسَّم / المحرر / المعاينة.
• النقر للتموضع: انقر في المحرر لتمرير المعاينة؛ وانقر في المعاينة للقفز بالمؤشر في المحرر.
• البحث والاستبدال: بحث، واستبدال فردي أو شامل، مع عدد التطابقات.
• الرياضيات: سطري $…$ وكتلي $$…$$ (أيضاً \(...\), \[...\])، يُعرض عبر KaTeX؛ المعادلات الطويلة تُلتف عند عوامل التشغيل أو تتقلص تلقائياً.
• تلوين الشيفرة: يُكتشف اللغة تلقائياً؛ المستندات الكبيرة تُلوَّن بكسلًا حسب الإطار الظاهر لتبقى سلسة.
• مخططات Mermaid: كتلة ```mermaid تُعرض كمخطط انسيابي / تسلسل / أصناف / حالات / Gantt / دائري، وغيرها؛ انقر على مخطط لفتح نافذة عرض مستقلة (تكبير / تحريك / ملء الشاشة) تتحدث مباشرة أثناء التحرير.
• الصور: لصق / إفلات / اختيار — تُحفَظ في مجلد <اسم الملف>_images/ بجانب المستند مع مرجع نسبي نظيف (بدون base64 مضمَّن); المسودات تستخدم مجلداً مؤقتاً يُرحَّل عند الحفظ; «حفظ باسم» يُسطِّح الصور إلى الهدف; تُوسَّط افتراضياً.
• تكبير الخط: كبِّر خطوط المحرر والمعاينة بشكل مستقل (عناصر تحكم −/نسبة مئوية/+، أو ⌘/Ctrl + =/−/0); يبقى عبر إعادة التشغيل.
• الجداول: جداول GFM؛ الجداول الضيقة تُوسَّط حسب المحتوى، والعريضة تُمرَّر أفقياً دون قص.
• الاستشهادات (BibTeX): الصياغة [@key] / \cite{key}، بنمط رقمي؛ ويُولَّد قائمة المراجع في النهاية، مع قفزات ثنائية الاتجاه بين [n] في النص والبند المقابل؛ ويدعم كتلة ```bibtex مُضمَّنة أو ملف .bib يُحمَّل على حدة.
• دعم HTML: افتح ملفات .html للعرض؛ وحوِّل بين HTML وMarkdown.
• السمة / اللغة: داكنة / فاتحة، 17 لغة واجهة (中文, English, Français, Deutsch, Русский, Italiano, 日本語, 한국어, Español, Português, العربية — العربية, हिन्दी, ਪੰਜਾਬੀ, Tiếng Việt, Bahasa Indonesia, اردو, Монгол (Кирилл) — العربية والأردية تلقائياً من اليمين إلى اليسار).
• المسودة التلقائية: يُحفظ المحتوى دورياً ويُستعاد بعد إغلاق غير متوقع / انهيار.
• عدّ الكلمات: يعرض شريط الحالة الأحرف / الأسطر / الكلمات لحظياً، إضافة إلى الصف والعمود الحاليين.
• السحب والإفلات: أفلت ملف .md على النافذة لفتحه؛ وأفلت صورة لإدراجها.
• التصدي: احفظ بصيغة Markdown / HTML / PDF (متجه) / LaTeX.
• لون النص: لوحة الشريط تحيط التحديد بـ <span style="color:…">.
• تحرير بمساعدة الذكاء الاصطناعي: حدِّد بعض النص واضغط ⌘/Ctrl + J (أو زر شريط الأدوات) لينقَّحه الذكاء الاصطناعي أو يوسِّعه أو يُعدِّل نبرته؛ يعمل مع الخدمات عبر الإنترنت (OpenAI / DeepSeek / Anthropic / GLM / Gemini / Kimi إلخ) ومع نموذج محلي مثل Ollama للاستخدام دون اتصال بالكامل؛ تُعاين النتيجة قبل أن تستبدل الأصل، ولا يُخزَّن مفتاح API إلا محلياً.
• رجوع / للأمام: سجل موحد للمستندات ومواضع المؤشر؛ زرّا ◀ ▶، Alt+←/→.
• اتباع الروابط: النقر على رابط في المعاينة يفتح الهدف في تبويب جديد (http في متصفح النظام)؛ لا يُستبدل المستند الحالي.

⌨️ اختصارات لوحة المفاتيح

استخدم ⌘ على macOS، وCtrl على Windows / Linux.

عند فتح عدة نوافذ، تؤثر الاختصارات على النافذة المُركَّزة فقط. عندما تكون نافذة عارض الصور مفتوحة، يقوم ⌘/Ctrl + =/−/0 بتكبير الصورة بدلاً من ذلك.

📝 ورقة مرجعية

Markdown: العناوين # / ## / ###، عريض **text**، مائل *text*، يتوسطه خط ~~text~~، شيفرة سطرية `code`، كتل شيفرة (ثلاث علامات خلفية، مع لغة اختيارية)، اقتباس > text، قوائم - / 1.، قائمة مهام - [ ] / - [x]، رابط [text](url)، صورة ![alt](url)، فاصل ---، جداول | A | B |.

الرياضيات: سطري $E = mc^2$؛ كتلي $$\int_0^1 x\,dx$$ (قد يمتد على عدة أسطر). يستخدم صياغة LaTeX، ويُعرض عبر KaTeX؛ الرمز $ داخل كتل الشيفرة لا يُعامل كفاصل رياضي. يدعم بيئات شائعة مثل align / aligned والمصفوفات وcases وغيرها.

الاستشهادات: اكتب [@key] أو [@a; @b] في النص (متوافق مع \cite{key} في LaTeX)، واضمِّن المكتبة عبر كتلة ```bibtex أو حمِّل ملف .bib عبر زر "Refs". تُولَّد قائمة المراجع في النهاية؛ ويمكن النقر على [n] في النص.

📤 التصدي (حفظ باسم)

انقر "حفظ باسم" واختر الصيغة:

• Markdown (.md): احفظ المصدر وحدِّث اسم / مسار العلامة الحالية.
• HTML (.html): ملف HTML مكتفٍ ذاتياً بـ CSS مُضمَّن وتلوين شيفرة؛ تُحفظ الرياضيات كنص $…$ حرفي، يُعرض تلقائياً عبر KaTeX مُضمَّن.
• PDF متجه: حوار طباعة النظام، خرج متجه، حاد عند أي مستوى تكبير. اختر "حفظ كـ PDF".
• LaTeX (.tex): يُحوَّل إلى مصدر .tex قابل للترجمة (مع documentclass والحزم؛ تُحفظ الرياضيات كما هي). يُصدِّر نسخة.

🔒 العمل دون اتصال والأمان

• صفر طلبات شبكة أثناء التشغيل. مخرجات البناء dist/index.html تُفحص ذاتياً: لا روابط خارجية src= / href= / url() / @import.
• CSP صارم (IPC محلي فقط، بلا WAN)؛ تُقرأ وتُكتب جميع الملفات محلياً، ولا يُرفع أي شيء.
• للتحقق: أوقف الـ Wi-Fi / افصل الكابل وشغِّل التطبيق — الرياضيات، والصور، وتلوين الشيفرة، وMermaid تعمل جميعاً.
• لا يزال dist/index.html يُظهر حوالي عشر سلاسل https://github.com/…؛ وجميعها داخل تعليقات الترخيص / المصدر لكل من marked / highlight.js وغيرها — نص عادي لا يُطلِب أي طلب أبداً؛ وتُركت سليمة احتراماً لتراخيص المصادر المفتوحة.

📦 التثبيت

التنزيلات الجاهزة

نزِّل المُثبِّت لمنصتك من أحد المصدرين:

• GitHub Releases: https://github.com/fwzheng/mdex/releases
• موقع مرآة: https://www.spinss.cn/

macOS (.dmg, universal arm64 + x86_64), Windows (.exe, NSIS installer), Linux (.deb / .rpm / .AppImage).

فتح التطبيق غير الموقَّع على macOS (تجاوز Gatekeeper)

هذا التطبيق غير موقَّع من المطوِّر وغير موثَّق (بيئات العمل دون اتصال لا تستطيع عادةً التوثيق عبر الشبكة). على macOS 12+، وخاصة macOS 26 (Tahoe)، يفشل تشغيله مباشرةً من الـ .dmg — أو من نسخة بناء حديثة — مع الرسالة "MDeX.app is damaged and can't be opened." هذا تصرُّف Gatekeeper وليس تلفًا حقيقيًا. أصلِحه في Terminal:

1. اسحب أولًا MDeX.app من الـ .dmg إلى /Applications — لا تشغِّله أبدًا مباشرةً من الـ dmg (ذلك يُفعِّل App Translocation وسمة com.apple.provenance، وهو السبب الحقيقي لرسالة "damaged" على macOS 26).
2. امسح السمات وأعِد التوقيع:

   xattr -cr /Applications/MDeX.app
   codesign --force --deep --sign - /Applications/MDeX.app

   com.apple.provenance محمي بواسطة SIP ولا يمكن إزالته حتى مع sudo؛ إعادة التوقيع تُعيد ضبط التوقيع فيسمح Gatekeeper بتشغيله. spctl يبقى يُبلغ عن rejected للتوقيع المُرتجل (ad-hoc) — هذا متوقَّع، ولا يُعيق open.

3. شغِّل عبر open /Applications/MDeX.app (أو عبر النقر المزدوج). قد يستمر الإطلاق الأول في طلب تأكيد مرة واحدة — أكِّد عبر إعدادات النظام ← الخصوصية والأمان ← فتح على أي حال، أو انقر بالزر الأيمن على التطبيق ← فتح.

🛠️ البناء من المصدر

الكود المصدري: https://github.com/fwzheng/mdex. اتبع تعليمات البناء في المستودع (الإعداد والتبعيات والأوامر موثقة هناك).

📁 بنية المشروع

markdown/
├── app-shell.html          # frontend shell (HTML+CSS); app logic lives in src/app.js
├── src/
│   ├── app.js              # application logic (// @ts-check; inlined into dist by build-html.mjs)
│   ├── i18n.js            # 17-language UI strings (pure data; window.I18N, split from app.js)
│   ├── help.js            # help-document data (HELP_STRINGS + SK/sc/CITE_HELP_*, window.HELP_DATA)
│   └── globals.d.ts        # vendor / Window type declarations for type-checking
├── tsconfig.json           # type-check config (tsc --noEmit; no bundler)
├── tools/
│   ├── fetch-vendor.mjs    # one-time: download deps into vendor/ + integrity lock (online only here)
│   ├── build-html.mjs      # inline vendor + src/app.js + i18n.js + help.js into dist/index.html (KaTeX fonts → base64)
│   └── test-pure.mjs       # frontend pure-function tests (npm test)
├── dist/index.html         # build output: self-contained single file (Tauri frontendDist)
├── vendor/                 # download cache + integrity.json (.gitignore)
├── package.json            # @tauri-apps/cli + typescript(dev) + scripts
└── src-tauri/
    ├── Cargo.toml          # tauri 2 + dialog / single-instance + encoding_rs
    ├── build.rs            # tauri_build::build()
    ├── tauri.conf.json     # 1200×750 window, strict CSP, icons, .md association, menu hooks
    ├── capabilities/default.json
    ├── icons/              # full icon set from `cargo tauri icon`
    └── src/{main.rs, lib.rs}   # menus + file IO + multi-window routing + atomic write / file ownership

🎨 التخصيص

📄 الترخيص

شيفرة المشروع نفسها مفتوحة المصدر تحت Apache License 2.0.

مكوِّنات الطرف الثالث: يستخدم المشروع بعض مكوِّنات الطرف الثالث (بما في ذلك على سبيل المثال لا الحصر marked وKaTeX وhighlight.js وDOMPurify وjsPDF وhtml2canvas-pro وturndown وmermaid و@retorquere/bibtex-parser وTauri وغيرها)؛ تُفصَّل إشعارات حقوق النشر والترخيص في ملفات المصدر الخاصة بكلٍّ منها. تُوزَّع هذه المكوِّنات تحت تراخيص MIT وBSD-3-Clause وApache-2.0 وMPL-2.0 وتراخيص مفتوحة المصدر أخرى.

متطلبات التوزيع: وفقًا لترخيص Apache-2.0، تتطلب إعادة توزيع هذا المشروع الاحتفاظ بملفي LICENSE وNOTICE؛ وإذا عدَّلت أي ملف مصدر فيجب الإشارة إلى التغييرات بوضوح في الملف المقابل.

📬 التواصل

للمشاكل أو الاقتراحات: 郑法伟 (Fawei Zheng) fwzheng@bit.edu.cn