النقاط الرئيسية
- طوّرها المطوّر المستقل HugoValim كإضافة مفتوحة المصدر من المجتمع — وليست منتجًا رسميًا من Joplin
- الترخيص: MIT، وفق مستودع GitHub
- تتصل عبر نقطة نهاية HTTP/SSE عامة متوافقة مع OpenAI — دون حزمة SDK خاصة بمزوّد — وعنوان URL الأساسي الافتراضي هو المنفذ المحلي الافتراضي لـOllama (
http://localhost:11434/v1) - تعمل أيضًا مع LM Studio أو واجهة برمجة تطبيقات OpenAI بتغيير عنوان URL الأساسي في الإعدادات
- تتطلب Joplin 3.6 أو أحدث؛ مخصّصة لأجهزة الحاسوب المكتبية فقط — لا تدعم صراحةً تطبيق Joplin للجوال
- يُعرض كل تعديل على ملاحظة أو ملف كمستند فروقات مؤقت للمراجعة قبل تطبيقه — لا شيء يُكتب بصمت
- يحتفظ التراجع بما يصل إلى عشر عمليات تشغيل لمدة تصل إلى سبعة أيام؛ ويعتمد التزامن على كشف التعارض بالطابع الزمني
- يتطلب البحث الدلالي الاختياري في الملاحظات (RAG) إصدار Joplin 3.7 أو أحدث
📍 في جملة واحدة
Joplin AI Agent إضافة من المجتمع تضيف إلى Joplin وكيل محادثة بالذكاء الاصطناعي يخضع للمراجعة، وتتصل بأي نقطة نهاية متوافقة مع OpenAI بما في ذلك خوادم Ollama وLM Studio المحلية بالكامل.
💬 بعبارات بسيطة
تضيف داخل Joplin لوحة محادثة بالذكاء الاصطناعي يمكنها قراءة ملاحظاتك، ولا تُعدّلها إلا بعد موافقتك على فروقات معروضة. تربطها بنموذج يعمل على جهازك الخاص عبر Ollama أو LM Studio بدلًا من اشتراك سحابي، بحيث يمكن أن تبقى ملاحظاتك بالكامل على جهازك.
📌ملاحظة: هذه المراجعة هي المكمّل المتعمّق لمدخل Joplin AI Agent في دليل برمجيات نماذج اللغة المحلية — راجع تلك الصفحة لمقارنة سريعة مع عشرات الأدوات الأخرى القادرة على الذكاء الاصطناعي المحلي.
ما هي Joplin AI Agent؟
Joplin AI Agent إضافة من المجتمع لتطبيق Joplin، تطبيق الملاحظات مفتوح المصدر متعدد المنصات، طوّرها المطوّر المستقل HugoValim ووزّعها كبرمجية مفتوحة المصدر بموجب ترخيص MIT. وفق مستودع GitHub الخاص بها، تضيف وكيل ذكاء اصطناعي بصلاحية قراءة وكتابة قائمة على الأدوات على الملاحظات والدفاتر وملفات النصوص داخل ملف تعريف Joplin، مع مرور كل تعديل مقترح بخطوة مراجعة قبل تطبيقه.
- معرّف الإضافة:
com.hugovalim.joplin-ai-agent - الإصدار 0.7.0 وقت كتابة هذه المراجعة — راجع المستودع مباشرة للاطلاع على الإصدار الحالي، لأن إصدارات الإضافة تتغيّر بشكل مستقل عن هذا المقال
- الوظيفة الأساسية: وكيل محادثة في الشريط الجانبي يمكنه البحث والقراءة، وبعد مراجعتك، تعديل الملاحظات والدفاتر وملفات النصوص داخل ملف تعريف Joplin الخاص بك
- الاستدلال المحلي: لا يوجد محرك استدلال مدمج — ترسل الإضافة الطلبات إلى خادم متوافق مع OpenAI يعمل بشكل منفصل (Ollama أو LM Studio أو واجهة برمجة تطبيقات سحابية) بدلًا من تضمين أوزان النموذج نفسها
- المطوّر: HugoValim، مطوّر مستقل يوزّع الإضافة كبرمجية مفتوحة المصدر، دون أي علاقة بالقائمين على صيانة Joplin
- المستودع الرسمي: github.com/HugoValim/joplin-ai-plugin
ماذا يمكنك أن تفعل بـ Joplin AI Agent؟
تجمع Joplin AI Agent بين محادثة مدركة لخزينة الملاحظات، ووصول إلى الملفات قائم على الأدوات، وخطوة مراجعة قبل أي كتابة، وفق ملف README الخاص بها.
- سجلات محادثة دائمة — تحتفظ المحادثات بإعدادات السياق وملخصات التشغيل عبر الجلسات، بدلًا من إعادة التصفير مع كل محادثة جديدة
- بحث اختياري في الملاحظات (RAG) — بحث دلالي في ملاحظاتك بحيث تستخدم الإجابات محتوى الخزينة كسياق؛ تتطلب هذه الميزة تحديدًا إصدار Joplin 3.7 أو أحدث
- قواعد لمنع الحقن والتلفيق — توثّق الإضافة قواعد مصمّمة لمنع حقن التعليمات عبر محتوى الملاحظات وتقليل الاستشهادات الملفّقة عندما يكتب الوكيل عن ملاحظاتك
- وصول قراءة وكتابة قائم على الأدوات — يمكن للوكيل قراءة الملاحظات والدفاتر وملفات النصوص العادية واقتراح تعديلات عليها، لا مجرّد الحديث عنها
- مقترحات تعديل تتطلب مراجعة — يُعرض أي تعديل مقترح كمستند فروقات مؤقت قبل تطبيقه، بحيث توافق أو ترفض التعديل الدقيق بدلًا من أن يُكتب بصمت
- كشف تعارض بالطابع الزمني — تتحقق الإضافة من طوابع تعديل الملاحظات قبل تطبيق أي تغيير، لرصد التعديلات المتزامنة
- سجل تراجع — يحتفظ بما يصل إلى عشر عمليات تشغيل لمدة تصل إلى سبعة أيام، بحيث يمكن التراجع لاحقًا عن تعديل سيء أجراه الوكيل
- واجهة شريط جانبي مع اختصارات لوحة مفاتيح — تعيش لوحة المحادثة في الشريط الجانبي لـJoplin مع اختصارات لوحة مفاتيح، وتقسّم السجلات الطويلة إلى صفحات بواقع 100 رسالة لكل صفحة
- دعم مساحة عمل مجلد خارجي — يمكنها العمل مع ملفات في مجلد خارجي خارج ملف تعريف Joplin، مع احترام ملف
.gitignoreالخاص بذلك المجلد
كيف تربط Joplin AI Agent بنموذج محلي؟
تتحدث Joplin AI Agent مع أي نقطة نهاية HTTP/SSE متوافقة مع OpenAI — لا توجد حزمة SDK خاصة بمزوّد يجب إعدادها. عنوان URL الأساسي الافتراضي، http://localhost:11434/v1، يطابق منفذ الخادم المحلي الافتراضي لـOllama، لذا يعمل تثبيت Ollama القياسي دون أي تغيير في العنوان على الإطلاق.
عنوان URL الأساسي
مفتاح API
- ما يجب إدخاله:
- اختياري في معظم الخوادم المحلية؛ مطلوب لدى مزوّدي الخدمات السحابية الذين يفرضونه.
اسم النموذج
- ما يجب إدخاله:
- معرّف النموذج الدقيق كما تُبلغ عنه الخلفية (مثل وسم نموذج Ollama سبق أن سحبته).
موجّه النظام، درجة الحرارة، رموز الإخراج، المهلة الزمنية
- ما يجب إدخاله:
- حقول اختيارية لضبط سلوك الوكيل — اتركها على القيم الافتراضية ما لم يكن لديك سبب محدد لتغييرها.
يوجد كل الإعداد ضمن إعدادات Joplin ← "Joplin AI Agent". ولأن الإضافة تتحدث بروتوكولًا عامًا متوافقًا مع OpenAI بدلًا من استدعاء حزمة SDK خاصة بمزوّد معيّن، فمن المفترض أن يعمل أي خادم محلي أو مستضاف ذاتيًا يعرض نفس شكل واجهة البرمجة بمجرد تغيير عنوان URL الأساسي فقط.
الحصول على Joplin AI Agent
تُثبَّت Joplin AI Agent كإضافة داخل Joplin، وليست تطبيقًا مستقلًا — يجب أن يكون Joplin نفسه مثبّتًا مسبقًا. وقت كتابة هذه المراجعة، لم يتأكد ظهور الإضافة في بحث إضافات المجتمع داخل تطبيق Joplin، لذا ثبّتها يدويًا من ملف .jpl المنشور على GitHub Releases.
تثبيت يدوي من GitHub Releases (موصى به)
- كيفية التثبيت:
- نزّل
com.hugovalim.joplin-ai-agent.jplمن صفحة GitHub Releases. في Joplin، افتح الإعدادات ← الإضافات، واستخدم خيار "التثبيت من ملف" واختر ملف.jplالذي نزّلته. أعد تشغيل Joplin إذا طُلب منك ذلك، ثم فعّل الإضافة إذا لم تكن مفعّلة بالفعل.
البناء من الكود المصدري
- كيفية التثبيت:
- استنسخ github.com/HugoValim/joplin-ai-plugin واتبع تعليمات البناء الخاصة بالمستودع نفسه — مفيد إن كنت بحاجة إلى تعديل محدد أو ترغب في المساهمة بتغييرات.
تتطلب Joplin 3.6 أو أحدث. Joplin AI Agent مخصّصة لأجهزة الحاسوب المكتبية فقط — لا تدعم صراحةً تطبيقات Joplin للجوال، لذا ثبّتها فقط على نسخة مكتبية من Joplin على Windows أو macOS أو Linux.
كيف تحمي Joplin AI Agent ملاحظاتك عند الكتابة؟
يظهر أي تعديل على ملاحظة أو ملف تقترحه Joplin AI Agent أولًا كمستند فروقات مؤقت، وليس كتعديل صامت. تراجع التعديل الدقيق قبل أن تقرر تطبيقه — لا يقوم الوكيل بالكتابة فوق ملاحظة من تلقاء نفسه.
- كتابة تعتمد على الفروقات أولًا — يُعرض التعديل المقترح كمستند فروقات مؤقت يوضّح بدقة ما سيتغيّر، قبل تطبيق أي شيء على الملاحظة الفعلية
- كشف تعارض بالطابع الزمني — تتحقق الإضافة من الطابع الزمني لآخر تعديل على الملاحظة قبل تطبيق أي تغيير، لرصد الحالات التي عدّلت فيها أنت أو جهاز آخر الملاحظة بعد قراءة الوكيل لها
- نافذة تراجع — يبقى ما يصل إلى عشر عمليات تشغيل قابلة للاسترجاع لمدة تصل إلى سبعة أيام، بحيث يمكن التراجع لاحقًا عن تعديل غير مرغوب فيه، لا مجرّد رفضه قبل تطبيقه فقط
- قواعد لمنع الحقن والتلفيق — وفق وثائقها الخاصة، تطبّق الإضافة قواعد تهدف إلى منع حقن التعليمات عبر محتوى الملاحظات وتقليل الاستشهادات الملفّقة عندما يشير الوكيل إلى ملاحظاتك
من يجب أن يستخدم Joplin AI Agent؟
يعتمد ملاءمة Joplin AI Agent لك على ما إذا كنت تستخدم بالفعل Joplin كتطبيق ملاحظات وتريد وكيل ذكاء اصطناعي يمكنه قراءة تلك الخزينة، وتعديلها بعد مراجعتك، باستخدام خلفية تتحكم بها بنفسك.
المنافسون والبدائل
تنافس Joplin AI Agent بشكل مباشر أكثر إضافات وكيل ذكاء اصطناعي أخرى مصمّمة لتطبيق ملاحظات معيّن بدلًا من واجهة محادثة مستقلة. أقرب مقارنة نشرتها PromptQuorum حتى الآن تخص تطبيقًا مضيفًا مختلفًا.
- مراجعة Copilot for Obsidian — إضافة وكيل ذكاء اصطناعي من نفس الفئة، لكن لتطبيق Obsidian بدلًا من Joplin. تشترك في نفس الفكرة الأساسية (وكيل ذكاء اصطناعي يقرأ خزينة ملاحظاتك ويعدّلها، مع دعم النماذج المحلية)، وهي مفيدة لمقارنة كيفية تعامل تطبيقي ملاحظات مختلفين مع نفس المشكلة.
- مراجعة Smart Connections — نوع مختلف من الأدوات ضمن نفس الفئة الأوسع "الذكاء الاصطناعي داخل تطبيق ملاحظاتك": إضافة بحث دلالي محلي واكتشاف روابط لـObsidian، وليست وكيلًا يعدّل الملفات.
أخطاء شائعة عند تقييم Joplin AI Agent
ينشأ معظم الالتباس حول Joplin AI Agent من افتراض أنها ميزة رسمية من Joplin، أو من توقّع أنها تعمل على الجوال بنفس طريقة عملها على الحاسوب المكتبي.
الأسئلة الشائعة
ما هي Joplin AI Agent؟
Joplin AI Agent إضافة طوّرها المجتمع لتطبيق الملاحظات Joplin، تضيف وكيل محادثة بالذكاء الاصطناعي بصلاحية قراءة قائمة على الأدوات، وبعد المراجعة، صلاحية كتابة على ملاحظاتك ودفاترك وملفات النصوص. يطوّرها بشكل مستقل HugoValim.
هل تعمل Joplin AI Agent مع نماذج ذكاء اصطناعي محلية؟
نعم. تتصل بأي نقطة نهاية HTTP/SSE متوافقة مع OpenAI، وعنوان URL الأساسي الافتراضي (http://localhost:11434/v1) يطابق خادم Ollama المحلي، فتعمل مع نموذج محلي بالكامل دون أي تغيير في الكود. كما تعمل مع LM Studio أو خادم آخر متوافق مع OpenAI بمجرد تغيير عنوان URL الأساسي.
هل Joplin AI Agent من صنع فريق Joplin؟
لا. إنها إضافة مجتمعية مستقلة يطوّرها ويصونها HugoValim، ولا يطوّرها القائمون على صيانة Joplin ولا يدعمونها رسميًا.
ما الترخيص الذي تُنشر بموجبه Joplin AI Agent؟
ترخيص MIT، وفق مستودع GitHub الخاص بالإضافة على github.com/HugoValim/joplin-ai-plugin.
كيف أثبّت Joplin AI Agent؟
نزّل ملف com.hugovalim.joplin-ai-agent.jpl من صفحة GitHub Releases الخاصة بالإضافة، ثم افتح في Joplin الإعدادات ← الإضافات واستخدم "التثبيت من ملف" لاختياره. لم يتأكد أنها قابلة للبحث ضمن سوق الإضافات المدمج في Joplin، لذا فإن هذا التثبيت اليدوي هو الطريقة الموثّقة.
هل تعمل Joplin AI Agent على تطبيق Joplin للجوال؟
لا. لا تدعم الإضافة صراحةً تطبيق Joplin للجوال — فهي مخصّصة لأجهزة الحاسوب المكتبية فقط، لتثبيتات Joplin على Windows وmacOS وLinux.
ما إصدار Joplin الذي تتطلبه Joplin AI Agent؟
Joplin 3.6 أو أحدث للإضافة نفسها. أما ميزتها الاختيارية للبحث في الملاحظات (RAG) فتتطلب تحديدًا Joplin 3.7 أو أحدث.
هل تعدّل Joplin AI Agent ملاحظاتي تلقائيًا؟
لا. يُعرض كل تعديل مقترح كمستند فروقات مؤقت لمراجعتك قبل تطبيقه — لا يكتب الوكيل على ملاحظة بصمت.
هل يمكنني التراجع عن تعديل أجرته Joplin AI Agent؟
نعم. تحتفظ الإضافة بما يصل إلى عشر عمليات تشغيل لمدة تصل إلى سبعة أيام، بحيث يمكن التراجع لاحقًا عن تعديل حديث أجراه الوكيل.
ما خلفيات الذكاء الاصطناعي التي تدعمها Joplin AI Agent؟
وفق وثائقها الخاصة، أي نقطة نهاية HTTP/SSE متوافقة مع OpenAI — ويشمل ذلك Ollama (الافتراضي) وLM Studio وواجهة برمجة تطبيقات OpenAI، لأنها تستخدم شكل واجهة برمجة تطبيقات عامًا بدلًا من حزمة SDK خاصة بمزوّد معيّن.