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,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