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.
This commit is contained in:
@@ -0,0 +1,5 @@
|
||||
---
|
||||
layout: page
|
||||
---
|
||||
|
||||
<DownloadHero />
|
||||
@@ -0,0 +1,52 @@
|
||||
# الميزات
|
||||
|
||||
BoosApi هو مساحة عمل AI مكتبية local-first. تم تحديث هذه الصفحة لـ v0.0.85 لتشمل import للمزوّدين، import للبيانات من التطبيقات الأخرى، MCP، HTML rendering، backup وgateway.
|
||||
|
||||
## الدردشة والنماذج
|
||||
|
||||
- **Multi-provider chat** — اربط OpenAI وClaude وGemini وDeepSeek وQwen وأي OpenAI-compatible endpoint مع Base URL وAPI Path وheaders وproxy rules.
|
||||
- **تهيئة المزوّدين** — استخدم boosapi:// provider links وCC Switch import لجلب provider profiles إلى BoosApi بعد تأكيد المستخدم.
|
||||
- **إدارة النماذج** — زامن remote model lists، ونظّم groups، واختبر latency، واضبط capabilities وcontext length وsampling defaults وreasoning profiles وper-model extra_body.
|
||||
- **مسارات المحادثة** — Streaming replies وthinking blocks وmessage versions وbranches وtitle-generation status وlong chat compression وmulti-model comparison.
|
||||
|
||||
## AI Agent
|
||||
|
||||
- **Agent mode** — يمكن للنموذج تعديل الملفات وتشغيل الأوامر وتحليل الكود داخل desktop workflow مضبوط.
|
||||
- **التحكم في الصلاحيات** — اختر standard review أو auto-accept edits أو full-access mode مع استمرار working-directory sandbox checks.
|
||||
- **الموافقة والتكلفة** — راجع tool calls لحظياً، واحفظ allow decisions، وتابع token/cost لكل session.
|
||||
|
||||
## عرض المحتوى
|
||||
|
||||
- **Markdown والمعادلات** — اعرض Markdown وcode highlighting وtables وtask lists وLaTeX formulas داخل streaming conversations.
|
||||
- **الكود والمخططات وArtifact** — استخدم Monaco code blocks وMermaid وD2 وArtifact panel للكود والملاحظات والتقارير والمعاينات.
|
||||
- **HTML fragments** — عاين generated HTML fragments بأمان مع أحدث streaming stability fixes.
|
||||
|
||||
## البحث والمعرفة
|
||||
|
||||
- **Web search** — يدعم Tavily وZhipu WebSearch وBocha مع cited sources وgenerated search queries.
|
||||
- **Local knowledge base** — افهرس private documents باستخدام sqlite-vec واضبط retrieval/rerank options وراجع retrieval feedback.
|
||||
- **Context management** — أضف files وsearch results وknowledge snippets وmemories وtool output إلى conversation context.
|
||||
|
||||
## الأدوات والامتدادات
|
||||
|
||||
- **MCP protocol** — شغّل Model Context Protocol servers عبر stdio أو SSE أو StreamableHTTP.
|
||||
- **Built-in tools** — استخدم @boosapi/fetch وfile search بدون تثبيت server منفصل.
|
||||
- **Tool loop limit** — اضبط MCP tool-call loop count واستعد بشكل أفضل من interrupted أو stuck tool sessions.
|
||||
|
||||
## API gateway
|
||||
|
||||
- **Local gateway** — اعرض OpenAI Chat Completions وOpenAI Responses وClaude-native وGemini-native endpoints من desktop app.
|
||||
- **الوصول والمراقبة** — أدر gateway keys وSSL/TLS certificates وrequest logs وusage analytics محلياً.
|
||||
- **Client templates** — Templates جاهزة لـ Claude Code وCodex CLI وOpenCode وGemini CLI وcustom clients.
|
||||
|
||||
## استيراد البيانات والنسخ الاحتياطي
|
||||
|
||||
- **Third-party imports** — استورد ChatGPT official exports وCherry Studio backups وKelivo backups مع preview counts وwarnings وduplicate handling.
|
||||
- **Provider and file migration** — يمكن لـ Cherry Studio/Kelivo import نقل linked providers وAPI keys وfile attachments اختيارياً.
|
||||
- **Backups** — انسخ واستعد البيانات عبر local folders أو WebDAV أو S3-compatible storage.
|
||||
|
||||
## سطح المكتب والأمان
|
||||
|
||||
- **Local encryption** — يُحفظ app state في ~/.boosapi/ وuser files في ~/Documents/boosapi/، وتُحمى API keys عبر AES-256 وlocal master key.
|
||||
- **Desktop integration** — Tray وalways-on-top وglobal shortcuts وauto-start وproxy settings وautomatic update checks.
|
||||
- **11 interface languages** — بدّل بين Simplified Chinese وTraditional Chinese وEnglish وJapanese وKorean وFrench وGerman وSpanish وRussian وHindi وArabic.
|
||||
@@ -0,0 +1,74 @@
|
||||
# بوابة API
|
||||
|
||||
## ما هي بوابة API؟
|
||||
|
||||
يتضمن BoosApi خادم API محلي مدمجاً يكشف مزوّديك المُكوَّنين كطرف **متوافق مع OpenAI** و**Claude الأصلي** و**Gemini الأصلي**. أي أداة أو عميل يستخدم أحد هذه البروتوكولات يمكنه استخدام BoosApi كخلفية — دون مفاتيح API منفصلة أو خدمات وسيطة مطلوبة.
|
||||
|
||||
حالات الاستخدام:
|
||||
|
||||
- تشغيل **Claude Code CLI** أو **OpenAI Codex CLI** أو **Gemini CLI** أو **OpenCode** عبر BoosApi.
|
||||
- تغذية امتدادات IDE الخاصة بك بطرف واحد مُدار محلياً.
|
||||
- مشاركة مجموعة من مفاتيح المزوّد عبر أدوات كثيرة مع تحديد معدل لكل مفتاح.
|
||||
|
||||
---
|
||||
|
||||
## البدء
|
||||
|
||||
1. افتح **الإعدادات ← بوابة API** (أو اضغط <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd>).
|
||||
2. انقر **ابدأ** لتشغيل خادم البوابة.
|
||||
3. بشكل افتراضي، يستمع الخادم على `127.0.0.1:8080` (HTTP).
|
||||
|
||||
::: tip
|
||||
فعّل **البدء التلقائي** في إعدادات البوابة لتشغيل الخادم تلقائياً عند إطلاق BoosApi.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## إدارة مفاتيح API
|
||||
|
||||
1. اذهب إلى تبويب **مفاتيح API**.
|
||||
2. انقر **إنشاء مفتاح جديد**.
|
||||
3. أضف اختيارياً **وصفاً** لتعريف كل مفتاح.
|
||||
4. انسخ المفتاح — يُعرض مرة واحدة فقط.
|
||||
|
||||
---
|
||||
|
||||
## قوالب التكوين
|
||||
|
||||
### Claude Code CLI
|
||||
|
||||
```bash
|
||||
claude config set --global apiUrl http://127.0.0.1:8080
|
||||
claude config set --global apiKey boosapi-xxxx
|
||||
```
|
||||
|
||||
### OpenAI Codex CLI
|
||||
|
||||
```bash
|
||||
export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
|
||||
export OPENAI_API_KEY=boosapi-xxxx
|
||||
codex
|
||||
```
|
||||
|
||||
### Gemini CLI
|
||||
|
||||
```bash
|
||||
export GEMINI_API_BASE=http://127.0.0.1:8080
|
||||
export GEMINI_API_KEY=boosapi-xxxx
|
||||
gemini
|
||||
```
|
||||
|
||||
### عميل مخصص
|
||||
|
||||
```
|
||||
Base URL: http://127.0.0.1:8080/v1
|
||||
API Key: boosapi-xxxx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## الخطوات التالية
|
||||
|
||||
- [البدء السريع](./getting-started) — العودة إلى دليل البدء السريع
|
||||
- [إعداد المزوّدين](./providers) — إضافة المزوّدين الأولين الذين توجّه إليهم البوابة
|
||||
- [خوادم MCP](./mcp) — توصيل أدوات خارجية لاستدعاء أدوات AI
|
||||
@@ -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 محلي
|
||||
@@ -0,0 +1,62 @@
|
||||
# خوادم MCP
|
||||
|
||||
## ما هو MCP؟
|
||||
|
||||
[بروتوكول Model Context Protocol (MCP)](https://modelcontextprotocol.io/) معيار مفتوح يتيح لنماذج AI التفاعل مع الأدوات ومصادر البيانات الخارجية. يعمل BoosApi كعميل MCP — تضيف خوادم MCP ويمكن لـ AI استدعاء الأدوات التي تكشفها خلال المحادثة.
|
||||
|
||||
---
|
||||
|
||||
## بروتوكولات النقل
|
||||
|
||||
| البروتوكول | الاتصال | حالة الاستخدام | التكوين |
|
||||
|-----------|---------|--------------|---------|
|
||||
| **Stdio** | عملية محلية | أدوات مثبّتة على جهازك، يتم إطلاقها عبر `npx` أو `uvx` أو `python`، إلخ | `command` + `args` + `env` اختياري |
|
||||
| **SSE** | خادم بعيد | طرف Server-Sent Events مستضاف على جهاز بعيد | `url` |
|
||||
| **StreamableHTTP** | خادم بعيد | طرف HTTP للبث، بديل أحدث لـ SSE | `url` |
|
||||
|
||||
---
|
||||
|
||||
## إضافة خوادم MCP
|
||||
|
||||
### الإنشاء عبر النموذج
|
||||
|
||||
1. اذهب إلى **الإعدادات ← خوادم MCP**.
|
||||
2. انقر **إضافة خادم MCP**.
|
||||
3. أدخل اسماً واختر بروتوكول النقل.
|
||||
4. امأ الحقول لبروتوكولك المختار.
|
||||
5. انقر **حفظ**.
|
||||
|
||||
### استيراد JSON
|
||||
|
||||
انقر **استيراد JSON** والصق كائن التكوين:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"fetch": {
|
||||
"command": "uvx",
|
||||
"args": ["mcp-server-fetch"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## الأدوات المدمجة
|
||||
|
||||
| الأداة | الوصف |
|
||||
|-------|-------|
|
||||
| **@boosapi/fetch** | جلب صفحات الويب وموارد HTTP |
|
||||
| **@boosapi/search-file** | البحث عن الملفات في نظام الملفات المحلي |
|
||||
|
||||
---
|
||||
|
||||
## Tool loop limit
|
||||
|
||||
في Settings -> MCP يمكن ضبط الحد الأقصى لعدد consecutive tool-call iterations داخل MCP-enabled response. اخفض الحد عند اختبار unknown servers، وارفعه للـ workflows التي تحتاج chaining لعدة tools.
|
||||
|
||||
## الخطوات التالية
|
||||
|
||||
- [بوابة API](./gateway) — كشف مزوّديك كخادم API محلي
|
||||
- [البدء السريع](./getting-started) — العودة إلى دليل البدء السريع
|
||||
@@ -0,0 +1,143 @@
|
||||
# إعداد المزوّدين
|
||||
|
||||
يتصل BoosApi بأي عدد من مزوّدي AI في آنٍ واحد. لكل مزوّد مفاتيح API الخاصة به وقائمة نماذج وإعدادات معاملات افتراضية.
|
||||
|
||||
## المزوّدون المدعومون
|
||||
|
||||
| المزوّد | نماذج مثال |
|
||||
|---------|-----------|
|
||||
| **OpenAI** | GPT-4o، GPT-4، o3، o4-mini |
|
||||
| **Anthropic** | Claude 4 Sonnet، Claude 4 Opus، Claude 3.5 Sonnet |
|
||||
| **Google** | Gemini 2.5 Pro، Gemini 2.5 Flash، Gemini 2.0 |
|
||||
| **DeepSeek** | DeepSeek V3، DeepSeek R1 |
|
||||
| **Alibaba Cloud** | سلسلة Qwen |
|
||||
| **Zhipu AI** | سلسلة GLM |
|
||||
| **xAI** | سلسلة Grok |
|
||||
| **API متوافق مع OpenAI** | Ollama، vLLM، LiteLLM، وسطاء الطرف الثالث، إلخ |
|
||||
|
||||
---
|
||||
|
||||
## إضافة مزوّد
|
||||
|
||||
1. اذهب إلى **الإعدادات ← المزوّدون**.
|
||||
2. انقر على زر **+** في أسفل اليسار.
|
||||
3. امأ تفاصيل المزوّد:
|
||||
|
||||
| الحقل | الوصف |
|
||||
|-------|-------|
|
||||
| **الاسم** | اسم العرض في الشريط الجانبي (مثلاً *OpenAI*) |
|
||||
| **النوع** | نوع المزوّد — يحدد Base URL الافتراضي |
|
||||
| **الأيقونة** | أيقونة اختيارية للتعرّف البصري |
|
||||
| **مفتاح API** | المفتاح السري من لوحة تحكم مزوّدك |
|
||||
| **Base URL** | طرف API (مملوء مسبقاً للأنواع المدمجة) |
|
||||
| **مسار API** | مسار الطلب — الافتراضي `/v1/chat/completions` |
|
||||
|
||||
---
|
||||
|
||||
## الاستيراد من رابط موقع ويب
|
||||
|
||||
يمكن لمواقع المزوّدين أو لوحات خدمات الوساطة أو منصات النماذج الخاصة أو صفحات البوابة المحلية توفير رابط **فتح في BoosApi**. عند النقر عليه يفتح المتصفح تطبيق BoosApi لسطح المكتب، وينتقل BoosApi إلى **الإعدادات ← المزوّدون**، ويعرض مربع تأكيد، ثم يستورد الإعدادات فقط بعد تأكيد المستخدم.
|
||||
|
||||
### تدفق الاستخدام
|
||||
|
||||
1. ثبّت وافتح إصداراً من BoosApi يدعم روابط المزوّدين.
|
||||
2. انقر على رابط **فتح في BoosApi** الذي يقدمه المزوّد في المتصفح.
|
||||
3. راجع في BoosApi اسم المزوّد و Base URL ونوع المزوّد وبادئة مفتاح API.
|
||||
4. يعيد BoosApi استخدام مزوّد موجود له نفس **Base URL + النوع**. إذا لم يوجد، ينشئ مزوّداً جديداً ويضيف مفتاح API فقط إذا لم يكن محفوظاً من قبل.
|
||||
|
||||
لا يتحقق BoosApi من المفتاح تلقائياً ولا يجلب النماذج تلقائياً. بعد الاستيراد، انقر **جلب النماذج** أو أضف النماذج يدوياً.
|
||||
|
||||
### صيغة الرابط
|
||||
|
||||
```text
|
||||
boosapi://providers?name=<name>&baseurl=<base-url>&apikey=<api-key>&type=<provider-type>
|
||||
```
|
||||
|
||||
مثال:
|
||||
|
||||
```text
|
||||
boosapi://providers?name=OpenAI&baseurl=https%3A%2F%2Fapi.openai.com&apikey=sk-xxx&type=openai
|
||||
```
|
||||
|
||||
### المعاملات
|
||||
|
||||
| المعامل | مطلوب | الوصف |
|
||||
|---------|--------|-------|
|
||||
| `name` | نعم | اسم العرض في BoosApi، مثل `OpenAI` أو `My Relay` |
|
||||
| `baseurl` | نعم | Base URL بعد ترميزه كرابط. يُقبل `http` و `https` فقط، ويتم رفض query و hash. |
|
||||
| `apikey` | نعم | مفتاح API المراد حفظه في BoosApi. يعرض BoosApi البادئة فقط في مربع التأكيد. |
|
||||
| `type` | نعم | نوع المزوّد. القيم المسموحة: `openai`، `openai_responses`، `anthropic`، `gemini`، `custom`. |
|
||||
|
||||
يمكن أن يستخدم `baseurl` لاحقة الإجبار الموجودة في BoosApi، مثل `https://example.com!`. عند الاستيراد عبر الرابط لا يتم تعيين `api_path`، ويواصل BoosApi استخدام المسار الافتراضي لنوع المزوّد المختار.
|
||||
|
||||
### إعداد الرابط في الموقع
|
||||
|
||||
قم بترميز كل القيم الديناميكية باستخدام `encodeURIComponent` أو `URLSearchParams`:
|
||||
|
||||
```html
|
||||
<a id="open-boosapi" href="#">فتح في BoosApi</a>
|
||||
|
||||
<script>
|
||||
const provider = {
|
||||
name: 'My Relay',
|
||||
baseurl: 'https://api.example.com',
|
||||
apikey: 'sk-user-key',
|
||||
type: 'openai',
|
||||
};
|
||||
|
||||
const params = new URLSearchParams({
|
||||
name: provider.name,
|
||||
baseurl: provider.baseurl,
|
||||
apikey: provider.apikey,
|
||||
type: provider.type,
|
||||
});
|
||||
|
||||
document.getElementById('open-boosapi').href = `boosapi://providers?${params.toString()}`;
|
||||
</script>
|
||||
```
|
||||
|
||||
إذا كانت خدمتك تتيح إنشاء مفاتيح API عبر الإنترنت، فأنشئ الرابط فقط بعد تسجيل دخول المستخدم واختياره أو إنشائه للمفتاح بوضوح.
|
||||
|
||||
::: warning الأمان
|
||||
قد يظهر مفتاح API الموجود في URL في سجل المتصفح أو السجلات أو الإضافات أو أدوات التحليلات. لا تضع مفاتيح حقيقية في صفحات عامة أو HTML ثابت أو روابط إعادة توجيه تابعة لطرف ثالث. من الأفضل إنشاء الرابط في صفحة حساب خاصة بعد تأكيد المستخدم.
|
||||
:::
|
||||
|
||||
::: tip الاختبار
|
||||
`boosapi://` بروتوكول مخصص يسجله تطبيق سطح المكتب المثبت في النظام. تشغيل الموقع أو خادم Vite فقط لا يسجل البروتوكول. إذا لم يفتح الرابط BoosApi، فثبّت أو أعد بناء أحدث تطبيق BoosApi لسطح المكتب أولاً.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## Import من CC Switch
|
||||
|
||||
يمكن لـ BoosApi فحص CC Switch provider configurations من Settings -> Providers. راجع كل candidate، اختر importable rows، ثم import providers وBase URLs وAPI keys وmodel lists إلى BoosApi. يتم تخطي OAuth-only entries أو entries التي لا تحتوي على reusable keys مع سبب واضح.
|
||||
|
||||
## Advanced model request body
|
||||
|
||||
يمكن لكل model تعريف extra_body، وهو JSON object يضاف بشكل flat إلى OpenAI-compatible Chat Completions requests. يفيد ذلك في vendor-specific options مثل enable_thinking. يتحقق BoosApi من JSON ويمنع overwrite للحقول model وmessages وstream وtools وbase sampling fields.
|
||||
|
||||
## تدوير مفاتيح متعددة
|
||||
|
||||
يدعم BoosApi مفاتيح API متعددة لكل مزوّد. انقر **إضافة مفتاح** في لوحة تفاصيل المزوّد.
|
||||
|
||||
---
|
||||
|
||||
## إدارة النماذج
|
||||
|
||||
انقر **جلب النماذج** للحصول على القائمة الكاملة للنماذج المتاحة. يمكنك أيضاً إضافة معرّفات النماذج يدوياً.
|
||||
|
||||
---
|
||||
|
||||
## Ollama (النماذج المحلية)
|
||||
|
||||
1. ثبّت وأطلق [Ollama](https://ollama.com/).
|
||||
2. في BoosApi، أنشئ مزوّداً جديداً من النوع **OpenAI**.
|
||||
3. اضبط **Base URL** على `http://localhost:11434`.
|
||||
4. انقر **جلب النماذج** لاكتشاف النماذج المحمّلة محلياً.
|
||||
|
||||
---
|
||||
|
||||
## الخطوات التالية
|
||||
|
||||
- [خوادم MCP](./mcp) — توصيل أدوات خارجية لتوسيع قدرات AI
|
||||
- [بوابة API](./gateway) — كشف مزوّديك كخادم API محلي
|
||||
@@ -0,0 +1,57 @@
|
||||
---
|
||||
layout: home
|
||||
title: "BoosApi — open-source AI desktop client وgateway"
|
||||
titleTemplate: false
|
||||
|
||||
head:
|
||||
- - meta
|
||||
- name: description
|
||||
content: "BoosApi هو free open-source AI desktop client يدعم multi-model chat وAgent وMCP وChatGPT/Cherry Studio/Kelivo import وlocal RAG وS3/WebDAV backup وbuilt-in AI gateway."
|
||||
|
||||
hero:
|
||||
name: BoosApi
|
||||
text: "مساحة عمل AI على سطح المكتب"
|
||||
tagline: "Multi-model chat وAgent وMCP tools وAPI gateway وimports وknowledge base وbackups داخل عميل local-first واحد"
|
||||
image:
|
||||
src: /logo.png
|
||||
alt: BoosApi
|
||||
actions:
|
||||
- theme: brand
|
||||
text: "البدء السريع"
|
||||
link: /ar/guide/getting-started
|
||||
- theme: alt
|
||||
text: "تحميل"
|
||||
link: /ar/download
|
||||
- theme: alt
|
||||
text: GitHub
|
||||
link: https://github.com/BoosApi-Desktop/BoosApi
|
||||
|
||||
features:
|
||||
- icon: robot
|
||||
title: "Multi-model chat"
|
||||
details: "OpenAI وClaude وGemini وDeepSeek وQwen وcompatible APIs مع key rotation وbranches وcompression وmulti-model answers."
|
||||
- icon: api
|
||||
title: "Provider setup"
|
||||
details: "boosapi:// provider links وCC Switch import وcustom headers وproxy settings وOpenAI Responses وper-model extra_body."
|
||||
- icon: thunderbolt
|
||||
title: "AI Agent"
|
||||
details: "File edits وcommands وcode analysis مع permission levels وworking-directory sandbox وapproval UI وcost tracking."
|
||||
- icon: edit
|
||||
title: "Rich rendering"
|
||||
details: "Markdown وLaTeX وMermaid وD2 وMonaco code blocks وHTML fragments وArtifact previews."
|
||||
- icon: search
|
||||
title: "Search وRAG"
|
||||
details: "Web search with citations وquery generation وlocal sqlite-vec knowledge bases وrerank settings وretrieval feedback."
|
||||
- icon: cloud-server
|
||||
title: "API gateway"
|
||||
details: "Local OpenAI-compatible وOpenAI Responses وClaude وGemini endpoints لـ Claude Code وCodex وOpenCode وcustom tools."
|
||||
- icon: book
|
||||
title: "Data import"
|
||||
details: "ChatGPT official exports وCherry Studio backups وKelivo backups مع duplicate handling وoptional provider migration."
|
||||
- icon: lock
|
||||
title: "Backup والأمان"
|
||||
details: "AES-256 encrypted local storage وdual-root data layout وlocal/WebDAV/S3 backups وrestore workflows."
|
||||
- icon: desktop
|
||||
title: "Desktop experience"
|
||||
details: "11 interface languages وtray mode وalways-on-top وglobal shortcuts وauto-start وproxy support وauto-update checks."
|
||||
---
|
||||
Reference in New Issue
Block a user