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
parent d9c78ecc73
commit e0a5f57793
2305 changed files with 449355 additions and 0 deletions
@@ -0,0 +1,119 @@
+# البدء السريع
+
+## التثبيت
+
+نزّل أحدث مثبّت من [صفحة التنزيل](/ar/download) أو [GitHub Releases](https://github.com/BoosApi-Desktop/BoosApi/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 ونفّذ:
+
+```bash
+xattr -c /Applications/BoosApi.app
+```
+
+ثم أعد تشغيل التطبيق.
+:::
+
+### Windows
+
+| البنية | الملف |
+|--------|-------|
+| x64 (معظم الأجهزة) | `BoosApi_x.x.x_x64-setup.exe` |
+| ARM64 | `BoosApi_x.x.x_arm64-setup.exe` |
+
+شغّل المثبّت واتبع المعالج.
+
+### Linux
+
+```bash
+# 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 وانقر على **أيقونة الترس** في أسفل الشريط الجانبي، أو اضغط <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd>.
+
+### 2. إضافة مزوّد
+
+انتقل إلى **الإعدادات ← المزوّدون** وانقر على زر **+**.
+
+1. أدخل اسماً للعرض (مثلاً *OpenAI*).
+2. اختر نوع المزوّد (OpenAI أو Anthropic أو Google Gemini، إلخ).
+3. الصق مفتاح API الخاص بك.
+4. أكّد **Base URL** — الطرف الرسمي مُملوء مسبقاً للأنواع المدمجة.
+
+::: tip
+يمكنك إضافة أي عدد من المزوّدين. كل مزوّد يدير مفاتيح API ونماذجه بشكل مستقل.
+:::
+
+### 3. جلب النماذج
+
+انقر **جلب النماذج** للحصول على قائمة النماذج المتاحة من API المزوّد. يمكنك أيضاً إضافة معرّفات النماذج يدوياً إذا لزم.
+
+### 4. ضبط النموذج الافتراضي
+
+اذهب إلى **الإعدادات ← النموذج الافتراضي** واختر المزوّد والنموذج الذي تستخدمه المحادثات الجديدة افتراضياً.
+
+---
+
+## محادثتك الأولى
+
+1. انقر **محادثة جديدة** في الشريط الجانبي (أو اضغط <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd>).
+2. اختر نموذجاً من محدد النماذج في أعلى المحادثة.
+3. اكتب رسالة واضغط <kbd>Enter</kbd>.
+4. يبثّ BoosApi الاستجابة في الوقت الفعلي. النماذج التي تدعم كتل التفكير (مثل Claude وDeepSeek R1) تعرض عملية الاستدلال في قسم قابل للطي.
+
+---
+
+## اختصارات لوحة المفاتيح
+
+| الاختصار | الإجراء |
+|----------|---------|
+| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> | إظهار / إخفاء النافذة الحالية |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>A</kbd> | إظهار / إخفاء جميع النوافذ |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>W</kbd> | إغلاق النافذة |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> | محادثة جديدة |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> | فتح الإعدادات |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>K</kbd> | لوحة الأوامر |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | تبديل بوابة API |
+
+---
+
+## البيانات والنسخ الاحتياطي
+
+### دلائل البيانات
+
+| المسار | المحتوى |
+|--------|---------|
+| `~/.boosapi/` | حالة التطبيق — قاعدة البيانات ومفاتيح التشفير وقاعدة البيانات المتجهة وشهادات SSL |
+| `~/Documents/boosapi/` | ملفات المستخدم — الصور والمستندات والنسخ الاحتياطية |
+
+---
+
+## الخطوات التالية
+
+- [إعداد المزوّدين](./providers) — إضافة وإدارة مزوّدي AI
+- [خوادم MCP](./mcp) — توصيل أدوات خارجية لتوسيع قدرات AI
+- [بوابة API](./gateway) — كشف مزوّديك كخادم API محلي