📚 التوثيق

كل ميزة، كل إعداد.

كل ما يفعله التطبيق وكل إعداد فيه — مكتوب للنسخة التي تشغّلها. من شريط القوائم إلى سجل المهارات، هذا هو الدليل الكامل.

بدء سريع

1. التثبيت. حمّل ملف .dmg واسحب Telebot AI إلى مجلد التطبيقات. البناء غير موقّع بعد، فإذا أظهر macOS تحذيراً، انقر بزر الفأرة الأيمن (Control-click) على التطبيق واختر فتح — مرة واحدة.
2. أنشئ بوتاً. راسل @BotFather على تيليجرام، ونفّذ /newbot، وانسخ الرمز. رمز واحد لكل بوت — يمكنك تشغيل عدة.
3. أضف الرمز. افتح Telebot AI من شريط القوائم، وافتح الإعدادات، والصق الرمز في حقل الرمز الخاص بالبوت. يُحفظ فور كتابته — لا يوجد زر حفظ.
4. وصّل عقلاً. في تبويب النموذج، عيّن عنوان الخادم (http://localhost:11234 لـmlx-serve، http://localhost:11434 لـOllama) واسم النموذج، أو استخدم أي واجهة سحابية متوافقة مع OpenAI. اضغط اختبار للتحقق من الاتصال.
5. ابدأ البوت. عُد إلى شريط القوائم واختر بدء البوت. راسل بوتك على تيليجرام — سيجيبك من تلك اللحظة.

جديد على النماذج المحلية؟ اقرأ الدليل — يغطي mlx-serve وOllama وLM Studio، وكم ذاكرة يحتاج كل نموذج.

تطبيق شريط القوائم

يعيش Telebot AI في شريط القوائم (أيقونة ⌘). تمنحك القائمة:

• بدء / إيقاف / إعادة تشغيل — لكل بوت ولكل البوتات دفعة واحدة. تعمل البوتات كـ LaunchAgents: دائمة التشغيل، بعيدة عن طريقك.
• فتح الإعدادات — نافذة الإعدادات.
• السجلات — تتبّع سجل البوت لترى ما يفعله أو لتصحح مشكلة.
• إنهاء — يوقف كل شيء (ويعطّل LaunchAgents حتى تبدأ من جديد).

الإعدادات، مشروحة

نافذة الإعدادات فيها شريط جانبي بنوعين من الصفحات:

• الافتراضي — النموذج، تيليجرام، التطبيق، المهارات & الميزات، سجل المهارات، حول، التحديثات. قيم يرثها كل بوت.
• البوتات — صفحة لكل بوت. كل حقل يُظهر ما يستخدمه هذا البوت فعلاً: القيمة تتجاوز الافتراضي، والحقل الفارغ يرثه (الشرح أسفل كل صف يوضح ذلك). لهذا لا توجد مربعات «استخدام العام» — الحقل الفارغ هو «استخدام العام».

كل شيء يُحفظ تلقائياً أثناء الكتابة أو التبديل. تعيش الإعدادات في ~/.mlx-serve/config.json.

الافتراضي → النموذج

الافتراضي → تيليجرام

صفحات كل بوت

لكل بوت في الشريط الجانبي صفحته الخاصة. الحقول الفارغة ترث الافتراضي؛ والشرح أسفل كل صف يوضح ما يرثه.

الافتراضي → التطبيق

المهارات & الميزات

قدرات البوت مهارات مدفوعة بالنموذج — تعليمات واضحة يتبعها النموذج بأدواته، فيمكنك وصف ما تريده بلغة عادية بدلاً من حفظ الأوامر. لكل مجموعة مفتاح رئيسي؛ ويمكن تشغيل أو إيقاف كل مهارة على حدة.

سجل المهارات

يسمح لك تبويب السجل بتثبيت مهارات جاهزة من كتالوج anthropics/skills العام — معالجة PDF والمستندات، جداول البيانات، العروض التقديمية، اختبار تطبيقات الويب، بناء خوادم MCP، الفنون والمزيد. حمّل الكتالوج، واختر مهارة، وستظهر في تبويب المهارات & الميزات كأي مهارة أخرى.

التحديثات

يتحقق تبويب التحديثات من بيان الموقع مقابل النسخة المثبّتة لديك ويعرض أحدث إصدار مع رابط تنزيل. التحقق صامت — عدم الاتصال أو عدم الوصول يعني ببساطة «لديك أحدث إصدار». للتحديث: حمّل ملف .dmg الجديد واسحبه فوق التطبيق القديم في مجلد التطبيقات. الإعدادات والبوتات والذكريات تعيش خارج التطبيق، فتبقى كما هي دون تغيير.

البيانات & الخصوصية

• أين تعيش الأشياء: الإعداد وذاكرة الدردشات والتذكيرات والمهارات والسجلات تبقى كلها في مجلد البيانات لديك (الافتراضي ~/.mlx-serve).
• ما يغادر ماكك: واجهة تيليجرام نفسها، وأي خادم نموذج توجّه البوت إليه، وإحصائيات استخدام مجهولة (إطلاق التطبيق وإجراءات القوائم). لا محتوى دردشات ولا رموز ولا بيانات شخصية.

استكشاف الأخطاء

• «لا يمكن لـ Apple التحقق من عدم وجود برمجيات خبيثة» — متوقع: انقر بزر الفأرة الأيمن (Control-click) على التطبيق في مجلد التطبيقات → فتح → فتح مرة أخرى. مرة واحدة، ثم يعمل بشكل طبيعي.
• البوت لا يجيب. افتح الإعدادات → صفحة البوت: هل الرمز صحيح؟ ثم الافتراضي → النموذج → اختبار المزوّد. ثم افحص السجل (شريط القوائم → السجلات، أو تبويب التطبيق → فتح السجل).
• الردود بطيئة أو البوت صامت. مزودو الخطة المجانية قد يتجمدون لدقيقة فأكثر — ارفع مهلة API، وأضف نماذج احتياطية ليستمر البوت عند تقييد المزوّد الأساسي.
• الخادم المحلي لا يستجيب. تأكد من أن الخادم يعمل فعلاً (mlx-serve، Ollama…) قبل الاختبار في تبويب النموذج.
• التحديثات تقول «لديك أحدث إصدار» بشكل غريب. التحقق صامت بالتصميم — إذا كان البيان غير قابل للوصول فإنه يبلغ بأنك محدَّث.
• مشكلة أخرى؟ أرسل ملاحظاتك — كل رسالة تصل إلى تيليجرام المطوّر وتنال رداً حقيقياً.

تنزيل Telebot AI · أعجبك؟ اشترِ لي قهوة ☕