# Ollama والكتابة دون اتصال

اربط نموذجًا محليًا وجهّز سير عمل كتابة يمكنك استخدامه دون اتصال بالشبكة.

يشغّل Ollama النماذج المنزّلة على حاسوبك. اربطه بـ Oleafly لاستخدام الذكاء الاصطناعي المحلي إلى جانب مخطوطتك. جهّز النموذج وتبعيات المستند بينما لديك اتصال، ثم اختبر سير العمل الذي تنوي استخدامه دون اتصال.

## تثبيت Ollama وتشغيله

ثبّت Ollama من [صفحة التنزيل الرسمية](https://ollama.com/download) الخاصة به. افتح Ollama، أو شغّل خادمه المحلي من الطرفية:

```sh
ollama serve
```

إذا كان Ollama يعمل أصلًا، فاستخدم ذلك الخادم القائم. نزّل نموذجًا يناسب حاسوبك. مثلًا:

```sh
ollama pull qwen3:8b
ollama list
```

الأمر الأول ينزّل نموذجًا، والثاني يعرض قائمة النماذج المحلية. يؤثر حجم النموذج والذاكرة المتاحة وطول السياق في السرعة. تصف [وثائق](https://docs.ollama.com/) Ollama النماذج المدعومة وإعداد النظام.

## التحقق من وجود Ollama

![Settings → AI Assistant → Providers and keys. وسّع Ollama (local) في أسفل قائمة المزودين للتحقق من الخادم واختيار نموذج.](https://cdn.oleafly.com/images/screenshots/desktop/docs/settings-providers-dark-window-v2.png#view=519,89,883,902)

1. افتح **Settings → AI Assistant → Providers and keys**.
2. وسّع **Ollama**.
3. اختر **Check for Ollama**.
4. افحص الحالة وقائمة النماذج المثبتة.

إذا وجد التطبيق نسخة Ollama مثبتة لكنها متوقفة، فإن **Start Ollama** يشغّلها. اختر **Re-check** بعد بدء الخادم أو بعد تنزيل نموذج آخر.

## اختيار نموذج محلي

حدد نموذجًا من القائمة المكتشفة واستخدم إجراء البطاقة لتطبيقه. افتح المساعد وتأكد من تحديد النموذج المحلي قبل إرسال رسالة.

جرّب هذا مع مستند تدريبي:

> اشرح بنية هذا المستند. اذكر أقسامه دون تغيير أي ملفات.

للتحرير أو التجميع، استخدم نموذجًا يدعم سلوك الأدوات الذي يحتاجه Oleafly. تحقق من نتيجة قدرات النموذج؛ فالنموذج القادر على المحادثة ليس تلقائيًا قادرًا على تنفيذ سير عمل أدوات موثوق.

## تغيير المضيف

اختر **Change host (advanced)** لتعديل عنوان خادم Ollama. المضيف المحلي المعتاد هو `http://127.0.0.1:11434`. استخدم بطاقة Ollama المدمجة مع مضيف الخادم؛ فاللاحقة `/v1` تخص إعداد نقطة نهاية متوافقة مع OpenAI.

الخادم الذي يعمل على حاسوب آخر هو اتصال شبكي. استخدم عنوان الاسترجاع المحلي عندما تريد أن تبقى المعالجة على هذا الحاسوب.

## استخدام مزود متوافق بدلًا من ذلك

للحصول على اتصال مخصص متوافق مع OpenAI، استخدم نقطة نهاية Ollama التالية `http://localhost:11434/v1/`. يقبل Ollama حقل مفتاح API المطلوب من عميل التوافق دون التعامل معه بوصفه بيانات اعتماد سحابية. راجع [دليل التوافق الخاص بـ Ollama](https://docs.ollama.com/api/openai-compatibility) و[المزودين المخصصين](/docs/ai-setup/#add-a-custom-endpoint).

## تجهيز التجميع للعمل دون اتصال

افتح المستند وجمّعه بنجاح أثناء وجود اتصال. ينزّل Tectonic حزم TeX الناقصة عند الحاجة ويخزّنها مؤقتًا، ويفعل Typst الأمر نفسه لحزم Typst Universe. بعد ذلك فعّل **Settings → General → Offline mode** وجمّع مرة أخرى للتحقق من أن ذاكرة التخزين المؤقت كافية. يغطي وضع عدم الاتصال كلًا من LaTeX وTypst.

يمكن لمشروع Typst أيضًا الاحتفاظ بحزمه الخاصة. افتح **Typst packages** من شريط أدوات Typst واختر **Vendor packages into project**. ينسخ Oleafly الحزم التي يستوردها المشروع إلى مجلد `typst-packages`، فيُجمَّع المشروع دون اتصال وعلى حواسيب أخرى.

لمحرك TeX النظامي، ثبّت التوزيعة والحزم المطلوبة قبل قطع الاتصال. أبقِ الصور وملفات المراجع والأقسام المضمّنة والخطوط المطلوبة متاحة محليًا.

## الاختبار دون اتصال بالشبكة

1. افتح المشروع الذي ستستخدمه.
2. تأكد من أن Ollama يعمل مع تحديد النموذج المنزّل.
3. اقطع الاتصال بالشبكة.
4. جمّع المستند.
5. اطلب من النموذج المحلي شرح فقرة.
6. جرّب سير التحرير أو الأدوات المحدد الذي تحتاجه وافحص النتيجة.

يمكن أن تستمر الكتابة والملفات المحلية والتجميع المخزّن مؤقتًا وطلبات النموذج المحلي. أما اكتشاف المصادر عبر الإنترنت ومزامنة GitHub والنماذج السحابية وخدمات MCP الشبكية فتحتاج إلى اتصالاتها الخاصة. يتحكم وضع عدم الاتصال في Oleafly بالتجميع المخزّن مؤقتًا والبحث عن الاستشهادات؛ وهو ليس جدار حماية شبكيًا على مستوى النظام.

## فصل Ollama

استخدم **Disconnect** في بطاقة المزود لإزالة الاتصال الذي حفظه Oleafly. لا يؤدي هذا إلى حذف النماذج المثبتة في Ollama.

## استكشاف الأخطاء وإصلاحها

### لا يعمل

شغّل Ollama، وتأكد من المضيف والمنفذ، ثم اختر Re-check. إذا أبلغ الخادم عن أن منفذه قيد الاستخدام بالفعل، فافحص النسخة القائمة قبل بدء أخرى.

### لا توجد نماذج مثبتة

شغّل `ollama list`. نزّل نموذجًا، وانتظر انتهاء التنزيل، ثم اختر Re-check في Oleafly.

### يجيب النموذج لكنه لا يستخدم الأدوات

افحص حالة قدراته وجرّب نموذجًا يدعم الأدوات. ابدأ بطلب صغير يقرأ المشروع قبل طلب تسلسل طويل من التحرير والتجميع.

### لا علاقة للرد بالسؤال

على الأرجح سياق النموذج صغير جدًا. تشغل تعليمات مشروع Oleafly وأدواته مساحة قبل أن تشغلها رسالتك، ويمكن لسياق من 4,096 رمزًا أن يقطع حتى طلبًا قصيرًا. شغّل خادم Ollama بسياق لا يقل عن 16,384 رمزًا، مثلًا:

```sh
OLLAMA_CONTEXT_LENGTH=16384 ollama serve
```

في Windows PowerShell، شغّل `$env:OLLAMA_CONTEXT_LENGTH = "16384"` ثم `ollama serve`. أغلق أي نسخة Ollama تعمل قبل ذلك. ينتمي هذا الإعداد إلى خادم Ollama لا إلى Oleafly. المحادثات الأطول والمشاريع الأكبر تحتاج إلى سياق أكبر، والسياق الأكبر يستخدم ذاكرة أكبر. يتضمن [دليل طول السياق](https://docs.ollama.com/context-length) الخاص بـ Ollama التفاصيل.

### الاستجابة المحلية بطيئة

جرّب نموذجًا أصغر أو طلبًا أقصر وأكثر تركيزًا. أرفق الملف أو القسم المعني بدلًا من طلب مراجعة أطروحة كاملة دفعة واحدة.