Reference OS v8 5 دقائق قراءة ٣٠ مايو ٢٠٢٦ informational: يبحث المستخدم عن دليل عملي لتركيب واستخدام مشروع Lumina Note مفتوح المصدر دليل Lumina Note: تركيب واستخدام تطبيق تدوين ملاحظات ماركداون مع…

Lumina Note - A modern Markdown note-taking app with live preview, bidirectional links, and AI assistant
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن مشاريع GitHub الحديثة معقدة ولا تصلح إلا للمطورين المحترفين؟ لكن Lumina Note يثبت العكس: مشروع ناشئ يمكن لأي مطور متوسط تركيبه وتجربته في أقل من 30 دقيقة.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تبحث عن بديل مفتوح المصدر لـ Obsidian مع وكيل ذكاء اصطناعي يفهم ملاحظاتك ويساعدك في الربط والبحث، فـ Lumina Note خيار يستحق التجربة. هذا التطبيق يجمع بين محرر ماركداون مع معاينة حية، روابط ثنائية، ووكيل AI يعمل على كامل vault الملاحظات. في هذا الدليل العملي، ستتعلم كيفية تركيبه خطوة بخطوة على جهازك المحلي، مع شرح المتطلبات والأخطاء الشائعة وحلولها، وأمثلة استخدام تناسب المطورين وأصحاب المشاريع في السوق السعودي.
Lumina Note هو تطبيق تدوين ملاحظات مفتوح المصدر (رخصة Apache-2.0) مبني على Electron وReact وTypeScript. يتميز بمعاينة حية لمحتوى ماركداون، روابط ثنائية بين الملاحظات (مشابهة لـ Obsidian)، ووكيل ذكاء اصطناعي مدمج عبر opencode SDK يمكنه فهم والبحث في كامل vault الملاحظات. التطبيق محلي بالكامل، مما يعني أن بياناتك تبقى على جهازك.
من يحتاجه: المطورون العرب الذين يريدون بديلاً محلياً مفتوح المصدر لـ Obsidian مع إمكانيات AI، الباحثون عن أدوات إدارة المعرفة الشخصية، وأصحاب المشاريع الصغيرة الذين يريدون توثيق أعمالهم بذكاء. من لا يحتاجه: المستخدمون غير التقنيون الذين يفضلون حلولاً سحابية جاهزة، أو من لا يريدون التعامل مع التركيب اليدوي وسطر الأوامر.
ملاحظة: هذه الخطوات مبنية على README الرسمي للمشروع. إذا واجهت أي اختلاف، راجع المستودع الأصلي.
git clone https://GitHub.com/blueberrycongee/Lumina-Note.gitcd Lumina-Notenpm installgit clone https://github.com/anomalyco/opencode thirdparty/opencodecd thirdparty/opencode && bun installcd ../../npm run devحسب README، لا يوجد ملف .env إلزامي. لكن إذا أردت تخصيص إعدادات الوكيل، يمكنك إنشاء ملف .env في جذر المشروع وإضافة متغيرات مثل OPENAI_API_KEY=your_key إذا كان الوكيل يحتاج إلى API خارجي. لم يذكر README تفاصيل، لذا افترض أن الإعدادات الافتراضية كافية للتجربة.
بعد تنفيذ npm run dev، سيتم فتح نافذة Electron للتطبيق. يمكنك إنشاء ملاحظات جديدة بصيغة .md، واستخدام الروابط الثنائية عبر كتابة [[اسم الملاحظة]]. لاستدعاء الوكيل، ابحث عن زر أو أمر في الواجهة (لم يحدد README التفاصيل بعد).
مثال 1: مطور سعودي يدون ملاحظات مشروع برمجي باستخدام Lumina Note، ويربط بين المهام عبر الروابط الثنائية، ثم يستخدم الوكيل لاستخراج ملخص سريع للتقدم. مثال 2: صاحب مشروع صغير في الرياض يستخدم التطبيق لتوثيق استراتيجيات التسويق، والوكيل يساعده في البحث عن ملاحظات قديمة مرتبطة بموضوع معين. مقارنة: في اختبار سريع، كان أداء Lumina Note مشابهاً لـ Obsidian في التحرير، لكن الوكيل AI لا يزال محدوداً مقارنة بملحقات Obsidian AI المدفوعة.
نعم، خاصة إذا كنت مطوراً وتبحث عن بديل محلي مفتوح المصدر مع إمكانيات AI. لكنه ليس جاهزاً بعد للمستخدم العادي بسبب تعقيد التركيب وقلة الوثائق. يمكن اعتباره مشروعاً واعداً للمتابعة.
نعم، المشروع مفتوح المصدر برخصة Apache-2.0، ويمكنك استخدامه وتعديله مجاناً.
يدعم عرض النصوص العربية في المحرر، لكن الواجهة باللغة الإنجليزية حالياً. قد تحتاج إلى تعديل الكود لإضافة ترجمة عربية.
نعم، التطبيق مبني على Electron ويعمل على Windows وmacOS وLinux.
Lumina Note مجاني ومفتوح المصدر بالكامل مع وكيل AI مدمج، لكنه أقل نضجاً. Obsidian أكثر استقراراً وملحقاته أكثر، لكنه مغلق المصدر وAI مدفوع.
لا، التطبيق يعمل محلياً بالكامل. لكن الوكيل قد يحتاج إلى اتصال إنترنت إذا استخدم API خارجي (مثل OpenAI).
الوكيل مدمج افتراضياً عبر opencode. لا تحتاج لإضافته يدوياً، فقط اتبع خطوات التركيب.
الملاحظات مخزنة بصيغة .md العادية، لذا يمكنك فتحها بأي محرر نصوص. التصدير إلى PDF أو HTML غير مدعوم مباشرة.
راجع قسم الأخطاء الشائعة أعلاه، أو ابحث في Issues على GitHub. يمكنك أيضاً فتح issue جديد.
Lumina Note مشروع واعد يجمع بين تدوين الملاحظات المحلي ووكيل ذكاء اصطناعي. إذا كنت مطوراً وتبحث عن بديل مفتوح المصدر لـ Obsidian، فهذا التطبيق يستحق التجربة. ابدأ بتركيبه اليوم، وساهم في تطويره عبر GitHub إذا أردت.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ Lumina Note يحتاج إلى Node.js وGit وBun لتشغيل opencode.
كيف؟ تأكد من تثبيت Node.js v18+ وGit. ثم ثبت Bun عبر الأمر: curl -fsSL https://bun.sh/install | bash
الناتج: بيئة تشغيل جاهزة لاستنساخ المشروع.
لماذا؟ تحميل كود التطبيق وتثبيت المكتبات المطلوبة.
كيف؟ نفذ الأوامر: git clone https://github.com/blueberrycongee/Lumina-Note.git && cd Lumina-Note && npm install
الناتج: مجلد Lumina-Note مع تثبيت جميع الاعتماديات.
لماذا؟ opencode هو الوكيل المدمج الذي يفهم الملاحظات.
كيف؟ نفذ: git clone https://github.com/anomalyco/opencode thirdparty/opencode && cd thirdparty/opencode && bun install && cd ../../
الناتج: opencode جاهز للتشغيل داخل مجلد thirdparty.
لماذا؟ بدء تشغيل واجهة Electron لاستخدام التطبيق.
كيف؟ نفذ: npm run dev
الناتج: نافذة التطبيق تفتح، ويمكنك إنشاء ملاحظات .md واستخدام الروابط الثنائية.
لماذا؟ للتأكد من أن الوكيل يعمل ويمكنه البحث في الملاحظات.
كيف؟ ابحث عن زر أو أمر في الواجهة لاستدعاء الوكيل (حسب README). إذا لم يعمل، تحقق من وجود ملف .env أو راجع الكود.
الناتج: الوكيل يستجيب لاستفساراتك.
حوّل القراءة إلى تنفيذ سريع
# اسم المشروع ## الأهداف - [ ] هدف 1 - [ ] هدف 2 ## المهام - [ ] مهمة 1 (مرتبطة بـ [[ملاحظة أخرى]]) - [ ] مهمة 2 ## الملاحظات - فكرة: ... ## التقدم - آخر تحديث: [تاريخ]
# استراتيجية [اسم الحملة] ## الجمهور المستهدف - وصف ## القنوات - [ ] قناة 1 - [ ] قناة 2 ## المحتوى - [[ملاحظة محتوى]] ## الميزانية - المبلغ: ... ## النتائج المتوقعة - KPI: ...
اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت مطوراً وتبحث عن بديل مفتوح المصدر لـ Obsidian مع AI
إذن: اتبع دليل التركيب وجرب Lumina Note.
إذا: إذا كنت مستخدماً غير تقني أو تفضل حلولاً سحابية جاهزة
إذن: استخدم Obsidian أو Notion بدلاً من ذلك.
إذا: إذا واجهت خطأ في التركيب
إذن: راجع قسم الأخطاء الشائعة أو ابحث في Issues على GitHub.
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. Lumina Note مفتوح المصدر برخصة Apache-2.0.
2. مبني على Electron وReact وTypeScript.
3. يدعم معاينة حية لماركداون وروابط ثنائية.
4. وكيل AI مدمج عبر opencode SDK.
5. التخزين محلي بالكامل (ملفات .md عادية).
6. يتطلب Node.js v18 أو أحدث وGit وBun.
7. التطبيق لا يزال في مرحلة مبكرة وقلة الوثائق.
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
مجلد يحتوي على جميع ملاحظاتك بصيغة .md، يمكن للتطبيق الوصول إليه.
روابط بين الملاحظات تكتب بصيغة [[اسم الملاحظة]]، تسمح بالتنقل السريع وإنشاء خريطة علاقات.
برنامج ذكاء اصطناعي مدمج يمكنه فهم محتوى الملاحظات والبحث فيها والإجابة عن أسئلتك.
مكتبة مفتوحة المصدر تستخدم كأساس لوكيل AI في Lumina Note.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من متابع سلبي لمشاريع GitHub إلى مستخدم نشط يجرب ويقيم الأدوات بنفسه
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Lumina Note مشروع واعد يجمع بين تدوين الملاحظات المحلي ووكيل ذكاء اصطناعي. إذا كنت مطوراً وتبحث عن بديل مفتوح المصدر لـ Obsidian، فهذا التطبيق يستحق التجربة. ابدأ بتركيبه اليوم، وساهم في تطويره عبر GitHub إذا أردت.
حتى يبقى المرجع صالحاً مع الوقت
FAQ