البدء السريع

التثبيت

نزّل أحدث مثبّت من صفحة التنزيل أو GitHub Releases.

macOS

الشريحة	الملف
Apple Silicon (M1 / M2 / M3 / M4)	AQBot_x.x.x_aarch64.dmg
Intel	AQBot_x.x.x_x64.dmg

1. افتح .dmg واسحب AQBot إلى مجلد Applications.
2. أطلق AQBot. إذا حظرت macOS التطبيق، اذهب إلى إعدادات النظام ← الخصوصية والأمان وانقر فتح على أي حال.

macOS: "التطبيق تالف" أو "لا يمكن التحقق من المطوّر"

إذا رأيت أياً من هذه الرسائل، افتح Terminal ونفّذ:

xattr -c /Applications/AQBot.app

ثم أعد تشغيل التطبيق.

Windows

البنية	الملف
x64 (معظم الأجهزة)	AQBot_x.x.x_x64-setup.exe
ARM64	AQBot_x.x.x_arm64-setup.exe

شغّل المثبّت واتبع المعالج.

Linux

# Debian / Ubuntu
sudo dpkg -i AQBot_x.x.x_amd64.deb

# Fedora / openSUSE
sudo rpm -i AQBot_x.x.x_x86_64.rpm

# AppImage
chmod +x AQBot_x.x.x_amd64.AppImage
./AQBot_x.x.x_amd64.AppImage

---

الإعداد الأولي

1. فتح الإعدادات

أطلق AQBot وانقر على أيقونة الترس في أسفل الشريط الجانبي، أو اضغط Cmd/Ctrl+,.

2. إضافة مزوّد

انتقل إلى الإعدادات ← المزوّدون وانقر على زر +.

1. أدخل اسماً للعرض (مثلاً OpenAI).
2. اختر نوع المزوّد (OpenAI أو Anthropic أو Google Gemini، إلخ).
3. الصق مفتاح API الخاص بك.
4. أكّد Base URL — الطرف الرسمي مُملوء مسبقاً للأنواع المدمجة.

TIP

يمكنك إضافة أي عدد من المزوّدين. كل مزوّد يدير مفاتيح API ونماذجه بشكل مستقل.

3. جلب النماذج

انقر جلب النماذج للحصول على قائمة النماذج المتاحة من API المزوّد. يمكنك أيضاً إضافة معرّفات النماذج يدوياً إذا لزم.

4. ضبط النموذج الافتراضي

اذهب إلى الإعدادات ← النموذج الافتراضي واختر المزوّد والنموذج الذي تستخدمه المحادثات الجديدة افتراضياً.

---

محادثتك الأولى

1. انقر محادثة جديدة في الشريط الجانبي (أو اضغط Cmd/Ctrl+N).
2. اختر نموذجاً من محدد النماذج في أعلى المحادثة.
3. اكتب رسالة واضغط Enter.
4. يبثّ AQBot الاستجابة في الوقت الفعلي. النماذج التي تدعم كتل التفكير (مثل Claude وDeepSeek R1) تعرض عملية الاستدلال في قسم قابل للطي.

---

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

الاختصار	الإجراء
Cmd/Ctrl+Shift+A	إظهار / إخفاء النافذة الحالية
Cmd/Ctrl+Shift+Alt+A	إظهار / إخفاء جميع النوافذ
Cmd/Ctrl+Shift+W	إغلاق النافذة
Cmd/Ctrl+N	محادثة جديدة
Cmd/Ctrl+,	فتح الإعدادات
Cmd/Ctrl+K	لوحة الأوامر
Cmd/Ctrl+Shift+G	تبديل بوابة API

---

البيانات والنسخ الاحتياطي

دلائل البيانات

المسار	المحتوى
~/.aqbot/	حالة التطبيق — قاعدة البيانات ومفاتيح التشفير وقاعدة البيانات المتجهة وشهادات SSL
~/Documents/aqbot/	ملفات المستخدم — الصور والمستندات والنسخ الاحتياطية

---

الخطوات التالية

• إعداد المزوّدين — إضافة وإدارة مزوّدي AI
• خوادم MCP — توصيل أدوات خارجية لتوسيع قدرات AI
• بوابة API — كشف مزوّديك كخادم API محلي