Files
BoosAPI/desktop/website/docs/ar/guide/getting-started.md
T
boos e0a5f57793 feat(desktop): embed BoosAPI Desktop client as a subproject
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as
a monorepo subdirectory under desktop/. Source only — node_modules,
dist, Cargo target and the upstream .git history are excluded.

desktop/ keeps its own independent Cargo workspace (desktop/src-tauri
with crates/*); it is not part of the backend boosapi crate, so a
`cargo check` at the metapi root still compiles only the backend. Build
the desktop app from desktop/src-tauri per desktop/README.md.

Note: app icons are still placeholder assets pending the final BoosAPI
logo. The updater signing keys live outside the repo and are not
included.
2026-06-22 11:32:57 +08:00

4.5 KiB

البدء السريع

التثبيت

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

macOS

الشريحة الملف
Apple Silicon (M1 / M2 / M3 / M4) BoosApi_x.x.x_aarch64.dmg
Intel BoosApi_x.x.x_x64.dmg
  1. افتح .dmg واسحب BoosApi إلى مجلد Applications.
  2. أطلق BoosApi. إذا حظرت macOS التطبيق، اذهب إلى إعدادات النظام ← الخصوصية والأمان وانقر فتح على أي حال.

::: warning macOS: "التطبيق تالف" أو "لا يمكن التحقق من المطوّر" إذا رأيت أياً من هذه الرسائل، افتح Terminal ونفّذ:

xattr -c /Applications/BoosApi.app

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

Windows

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

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

Linux

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

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

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

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

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

أطلق BoosApi وانقر على أيقونة الترس في أسفل الشريط الجانبي، أو اضغط 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. يبثّ BoosApi الاستجابة في الوقت الفعلي. النماذج التي تدعم كتل التفكير (مثل 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

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

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

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

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