feat(docs): add API gateway, MCP server, and getting started guides

Author: Licoy

README-AR.md

@@ -0,0 +1,124 @@
+[简体中文](./README.md) | [繁體中文](./README-ZH-TW.md) | [English](./README-EN.md) | [日本語](./README-JA.md) | [한국어](./README-KO.md) | [Français](./README-FR.md) | [Deutsch](./README-DE.md) | [Español](./README-ES.md) | [Русский](./README-RU.md) | [हिन्दी](./README-HI.md) | **العربية**
+
+[![AQBot](https://socialify.git.ci/AQBot-Desktop/AQBot/image?description=1&font=JetBrains+Mono&forks=1&issues=1&logo=https%3A%2F%2Fgithub.com%2FAQBot-Desktop%2FAQBot%2Fblob%2Fmain%2Fsrc%2Fassets%2Fimage%2Flogo.png%3Fraw%3Dtrue&name=1&owner=1&pattern=Floating+Cogs&pulls=1&stargazers=1&theme=Auto)](https://github.com/AQBot-Desktop/AQBot)
+
+## لقطات الشاشة
+
+![](.github/images/1.png)
+![](.github/images/2.png)
+![](.github/images/3.png)
+![](.github/images/4.png)
+![](.github/images/5.png)
+
+## الميزات
+
+### الدردشة والنماذج
+
+- **دعم متعدد المزودين** — متوافق مع OpenAI وAnthropic Claude وGoogle Gemini وجميع واجهات برمجة التطبيقات المتوافقة مع OpenAI
+- **إدارة النماذج** — جلب قوائم النماذج عن بُعد، وتخصيص المعاملات (درجة الحرارة، الحد الأقصى للرموز المميزة، Top-P، إلخ)
+- **تدوير متعدد المفاتيح** — تكوين مفاتيح API متعددة لكل مزود مع التدوير التلقائي لتوزيع ضغط حد المعدل
+- **الإخراج المتدفق** — عرض في الوقت الفعلي رمزاً بعد رمز مع كتل تفكير قابلة للطي
+- **إصدارات الرسائل** — التبديل بين إصدارات متعددة للاستجابة لكل رسالة لمقارنة تأثيرات النموذج أو المعاملات
+- **تفريع المحادثة** — إنشاء فروع جديدة من أي عقدة رسالة، مع مقارنة الفروع جنباً إلى جنب
+- **إدارة المحادثات** — التثبيت والأرشفة والعرض المجمّع حسب الوقت والعمليات الجماعية
+- **ضغط المحادثة** — ضغط المحادثات الطويلة تلقائياً مع الحفاظ على المعلومات الرئيسية لتوفير مساحة السياق
+- **استجابة متزامنة لنماذج متعددة** — طرح نفس السؤال على نماذج متعددة في آنٍ واحد، مع مقارنة الإجابات جنباً إلى جنب
+
+### عرض المحتوى
+
+- **عرض Markdown** — دعم كامل لتمييز الكود وصيغ الرياضيات LaTeX والجداول وقوائم المهام
+- **محرر كود Monaco** — Monaco Editor مضمّن في كتل الكود مع تمييز بناء الجملة والنسخ ومعاينة diff
+- **عرض المخططات** — عرض مدمج لمخططات تدفق Mermaid ومخططات بنية D2
+- **لوحة Artifact** — مقتطفات الكود ومسودات HTML وملاحظات Markdown والتقارير قابلة للعرض في لوحة مخصصة
+- **دردشة صوتية في الوقت الفعلي** — (قريباً) صوت في الوقت الفعلي قائم على WebRTC مع دعم OpenAI Realtime API
+
+### البحث والمعرفة
+
+- **بحث الويب** — متكامل مع Tavily وZhipu WebSearch وBocha والمزيد، مع تعليقات توضيحية لمصادر الاستشهاد
+- **قاعدة المعرفة المحلية (RAG)** — يدعم قواعد معرفة متعددة؛ تحميل المستندات لتحليل وتقطيع وفهرسة تلقائية، مع الاسترداد الدلالي للمقاطع ذات الصلة أثناء المحادثات
+- **نظام الذاكرة** — يدعم ذاكرة المحادثة متعددة مساحات الأسماء، مع إدخال يدوي أو استخراج تلقائي بالذكاء الاصطناعي (الاستخراج التلقائي قريباً)
+- **إدارة السياق** — إرفاق مرفقات الملفات ونتائج البحث ومقاطع قاعدة المعرفة وإدخالات الذاكرة ومخرجات الأدوات بمرونة
+
+### الأدوات والامتدادات
+
+- **بروتوكول MCP** — تطبيق كامل لـ Model Context Protocol يدعم نقلَي stdio وHTTP
+- **الأدوات المدمجة** — أدوات MCP مدمجة جاهزة للاستخدام مثل `@aqbot/fetch`
+- **لوحة تنفيذ الأدوات** — عرض مرئي لطلبات استدعاء الأدوات والنتائج المُعادة
+
+### بوابة API
+
+- **بوابة API محلية** — خادم API محلي مدمج مع دعم أصلي لواجهات متوافقة مع OpenAI وClaude وGemini، قابل للاستخدام كخلفية لأي عميل متوافق
+- **إدارة مفاتيح API** — توليد مفاتيح الوصول وإلغاؤها وتمكينها/تعطيلها مع ملاحظات وصفية
+- **تحليلات الاستخدام** — تحليل حجم الطلبات واستخدام الرموز المميزة حسب المفتاح والمزود والتاريخ
+- **دعم SSL/TLS** — توليد شهادات موقّعة ذاتياً مدمج، مع دعم الشهادات المخصصة
+- **سجلات الطلبات** — تسجيل كامل لجميع طلبات واستجابات API المارة عبر البوابة
+- **قوالب التكوين** — قوالب تكامل مسبقة البناء لأدوات CLI الشائعة مثل Claude وCodex وOpenCode وGemini
+
+### البيانات والأمان
+
+- **تشفير AES-256** — مفاتيح API والبيانات الحساسة مشفرة محلياً بـ AES-256؛ المفتاح الرئيسي مخزّن بأذونات 0600
+- **أدلة بيانات معزولة** — حالة التطبيق في `~/.aqbot/`؛ ملفات المستخدم في `~/Documents/aqbot/`
+- **النسخ الاحتياطي التلقائي** — نسخ احتياطية تلقائية مجدولة إلى أدلة محلية أو تخزين WebDAV
+- **استعادة النسخ الاحتياطي** — استعادة بنقرة واحدة من النسخ الاحتياطية التاريخية
+- **تصدير المحادثات** — تصدير المحادثات كلقطات PNG أو Markdown أو نص عادي أو JSON
+
+### تجربة سطح المكتب
+
+- **تبديل السمة** — سمات داكنة/فاتحة تتبع تفضيلات النظام أو يمكن ضبطها يدوياً
+- **لغة الواجهة** — دعم كامل للصينية المبسطة والصينية التقليدية والإنجليزية واليابانية والكورية والفرنسية والألمانية والإسبانية والروسية والهندية والعربية، قابلة للتبديل في أي وقت من الإعدادات
+- **صينية النظام** — التصغير إلى صينية النظام عند إغلاق النافذة دون مقاطعة الخدمات الخلفية
+- **دائماً في المقدمة** — تثبيت النافذة الرئيسية فوق جميع النوافذ الأخرى
+- **اختصارات عالمية** — اختصارات لوحة مفاتيح عالمية قابلة للتخصيص لاستدعاء النافذة الرئيسية في أي وقت
+- **التشغيل التلقائي** — إطلاق اختياري عند بدء تشغيل النظام
+- **دعم الوكيل** — تكوين وكيل HTTP وSOCKS5
+- **التحديث التلقائي** — يتحقق تلقائياً من الإصدارات الجديدة عند بدء التشغيل ويطلب التحديث
+
+## دعم المنصات
+
+| المنصة | البنية |
+|--------|--------|
+| macOS | Apple Silicon (arm64), Intel (x86_64) |
+| Windows 10/11 | x86_64, arm64 |
+| Linux | x86_64 (AppImage/deb/rpm), arm64 (AppImage/deb/rpm) |
+
+## البدء
+
+توجه إلى صفحة [Releases](https://github.com/AQBot-Desktop/AQBot/releases) وقم بتنزيل المثبّت الخاص بمنصتك.
+
+## الأسئلة الشائعة
+
+### macOS: «التطبيق تالف» أو «لا يمكن التحقق من المطور»
+
+نظراً لأن التطبيق غير موقّع من Apple، قد يعرض macOS أحد الرسائل التالية:
+
+- «AQBot» تالف ولا يمكن فتحه
+- لا يمكن فتح «AQBot» لأن Apple لا تستطيع التحقق منه بحثاً عن البرامج الضارة
+
+**خطوات الحل:**
+
+**1. السماح بالتطبيقات من «أي مكان»**
+
+```bash
+sudo spctl --master-disable
+```
+
+ثم انتقل إلى **إعدادات النظام ← الخصوصية والأمان ← الأمان** وحدد **أي مكان**.
+
+**2. إزالة سمة الحجر الصحي**
+
+```bash
+sudo xattr -dr com.apple.quarantine /Applications/AQBot.app
+```
+
+> تلميح: يمكنك سحب أيقونة التطبيق إلى الطرفية بعد كتابة `sudo xattr -dr com.apple.quarantine `.
+
+**3. خطوة إضافية لـ macOS Ventura والإصدارات الأحدث**
+
+بعد إتمام الخطوات أعلاه، قد يظل الإطلاق الأول محجوباً. انتقل إلى **إعدادات النظام ← الخصوصية والأمان**، ثم انقر على **فتح على أي حال** في قسم الأمان. هذا يحتاج إلى تنفيذه مرة واحدة فقط.
+
+## المجتمع
+- [LinuxDO](https://linux.do)
+
+## الترخيص
+
+هذا المشروع مرخّص بموجب ترخيص [AGPL-3.0](LICENSE).

README-DE.md

@@ -0,0 +1,124 @@
+[简体中文](./README.md) | [繁體中文](./README-ZH-TW.md) | [English](./README-EN.md) | [日本語](./README-JA.md) | [한국어](./README-KO.md) | [Français](./README-FR.md) | **Deutsch** | [Español](./README-ES.md) | [Русский](./README-RU.md) | [हिन्दी](./README-HI.md) | [العربية](./README-AR.md)
+
+[![AQBot](https://socialify.git.ci/AQBot-Desktop/AQBot/image?description=1&font=JetBrains+Mono&forks=1&issues=1&logo=https%3A%2F%2Fgithub.com%2FAQBot-Desktop%2FAQBot%2Fblob%2Fmain%2Fsrc%2Fassets%2Fimage%2Flogo.png%3Fraw%3Dtrue&name=1&owner=1&pattern=Floating+Cogs&pulls=1&stargazers=1&theme=Auto)](https://github.com/AQBot-Desktop/AQBot)
+
+## Screenshots
+
+![](.github/images/1.png)
+![](.github/images/2.png)
+![](.github/images/3.png)
+![](.github/images/4.png)
+![](.github/images/5.png)
+
+## Funktionen
+
+### Chat & Modelle
+
+- **Multi-Anbieter-Unterstützung** — Kompatibel mit OpenAI, Anthropic Claude, Google Gemini und allen OpenAI-kompatiblen APIs
+- **Modellverwaltung** — Remote-Modelllisten abrufen, Parameter anpassen (Temperatur, maximale Tokens, Top-P usw.)
+- **Multi-Key-Rotation** — Mehrere API-Schlüssel pro Anbieter konfigurieren mit automatischer Rotation zur Verteilung des Rate-Limit-Drucks
+- **Streaming-Ausgabe** — Echtzeit-Token-für-Token-Rendering mit einklappbaren Denkblöcken
+- **Nachrichtenversionen** — Zwischen mehreren Antwortversionen pro Nachricht wechseln, um Modell- oder Parametereffekte zu vergleichen
+- **Gesprächsverzweigung** — Neue Zweige von einem beliebigen Nachrichtenknoten erstellen, mit seitenweisem Zweigvergleich
+- **Gesprächsverwaltung** — Anheften, Archivieren, zeitgruppierte Anzeige und Massenoperationen
+- **Gesprächskomprimierung** — Lange Gespräche automatisch komprimieren und dabei wichtige Informationen beibehalten, um Kontextraum zu sparen
+- **Simultane Multi-Modell-Antwort** — Dieselbe Frage gleichzeitig an mehrere Modelle stellen, mit seitenweisem Antwortvergleich
+
+### Inhaltsrendering
+
+- **Markdown-Rendering** — Vollständige Unterstützung für Code-Hervorhebung, LaTeX-Mathematikformeln, Tabellen und Aufgabenlisten
+- **Monaco Code-Editor** — Monaco Editor in Codeblöcken eingebettet mit Syntaxhervorhebung, Kopieren und Diff-Vorschau
+- **Diagramm-Rendering** — Integriertes Rendering von Mermaid-Flussdiagrammen und D2-Architekturdiagrammen
+- **Artifact-Panel** — Codeausschnitte, HTML-Entwürfe, Markdown-Notizen und Berichte in einem dedizierten Panel anzeigen
+- **Echtzeit-Sprachchat** — (Demnächst) WebRTC-basierte Echtzeit-Sprache mit Unterstützung der OpenAI Realtime API
+
+### Suche & Wissen
+
+- **Websuche** — Integriert mit Tavily, Zhipu WebSearch, Bocha und mehr, mit Quellenangaben
+- **Lokale Wissensbasis (RAG)** — Unterstützt mehrere Wissensbasen; Dokumente hochladen für automatisches Parsen, Chunking und Indexierung, mit semantischer Abrufung relevanter Abschnitte während Gesprächen
+- **Gedächtnissystem** — Unterstützt Multi-Namespace-Gesprächsgedächtnis, mit manueller Eingabe oder KI-gestützter automatischer Extraktion (automatische Extraktion demnächst)
+- **Kontextverwaltung** — Flexibles Anhängen von Dateianhängen, Suchergebnissen, Wissensbasisabschnitten, Gedächtniseinträgen und Werkzeugausgaben
+
+### Werkzeuge & Erweiterungen
+
+- **MCP-Protokoll** — Vollständige Model Context Protocol-Implementierung mit Unterstützung für stdio- und HTTP-Transporte
+- **Integrierte Werkzeuge** — Sofort einsatzbereite integrierte MCP-Werkzeuge wie `@aqbot/fetch`
+- **Werkzeugausführungs-Panel** — Visuelle Anzeige von Werkzeugaufruf-Anfragen und zurückgegebenen Ergebnissen
+
+### API-Gateway
+
+- **Lokales API-Gateway** — Integrierter lokaler API-Server mit nativer Unterstützung für OpenAI-kompatible, Claude- und Gemini-Schnittstellen, verwendbar als Backend für jeden kompatiblen Client
+- **API-Schlüsselverwaltung** — Zugriffsschlüssel generieren, widerrufen und aktivieren/deaktivieren mit Beschreibungsnotizen
+- **Nutzungsanalyse** — Anfragevolumen und Token-Nutzungsanalyse nach Schlüssel, Anbieter und Datum
+- **SSL/TLS-Unterstützung** — Integrierte Generierung selbstsignierter Zertifikate, mit Unterstützung für benutzerdefinierte Zertifikate
+- **Anfrage-Logs** — Vollständige Aufzeichnung aller API-Anfragen und -Antworten, die das Gateway passieren
+- **Konfigurationsvorlagen** — Vorgefertigte Integrationsvorlagen für beliebte CLI-Tools wie Claude, Codex, OpenCode und Gemini
+
+### Daten & Sicherheit
+
+- **AES-256-Verschlüsselung** — API-Schlüssel und sensible Daten werden lokal mit AES-256 verschlüsselt; Master-Schlüssel mit 0600-Berechtigungen gespeichert
+- **Isolierte Datenverzeichnisse** — Anwendungsstatus in `~/.aqbot/`; Benutzerdateien in `~/Documents/aqbot/`
+- **Automatisches Backup** — Geplante automatische Backups in lokale Verzeichnisse oder WebDAV-Speicher
+- **Backup-Wiederherstellung** — Ein-Klick-Wiederherstellung aus historischen Backups
+- **Gesprächsexport** — Gespräche als PNG-Screenshots, Markdown, Klartext oder JSON exportieren
+
+### Desktop-Erfahrung
+
+- **Themenwechsel** — Dunkle/helle Themes, die den Systemeinstellungen folgen oder manuell festgelegt werden können
+- **Oberflächensprache** — Vollständige Unterstützung für vereinfachtes Chinesisch, traditionelles Chinesisch, Englisch, Japanisch, Koreanisch, Französisch, Deutsch, Spanisch, Russisch, Hindi und Arabisch, jederzeit in den Einstellungen umschaltbar
+- **Systemtray** — Beim Schließen des Fensters in den Systemtray minimieren, ohne Hintergrunddienste zu unterbrechen
+- **Immer im Vordergrund** — Das Hauptfenster über allen anderen Fenstern anheften
+- **Globale Tastenkürzel** — Anpassbare globale Tastaturkürzel, um das Hauptfenster jederzeit aufzurufen
+- **Autostart** — Optionaler Start beim Systemstart
+- **Proxy-Unterstützung** — HTTP- und SOCKS5-Proxy-Konfiguration
+- **Automatische Updates** — Prüft beim Start automatisch auf neue Versionen und fordert zur Aktualisierung auf
+
+## Plattformunterstützung
+
+| Plattform | Architektur |
+|-----------|------------|
+| macOS | Apple Silicon (arm64), Intel (x86_64) |
+| Windows 10/11 | x86_64, arm64 |
+| Linux | x86_64 (AppImage/deb/rpm), arm64 (AppImage/deb/rpm) |
+
+## Erste Schritte
+
+Gehen Sie zur [Releases](https://github.com/AQBot-Desktop/AQBot/releases)-Seite und laden Sie das Installationsprogramm für Ihre Plattform herunter.
+
+## FAQ
+
+### macOS: „App ist beschädigt" oder „Entwickler kann nicht überprüft werden"
+
+Da die Anwendung nicht von Apple signiert ist, kann macOS eine der folgenden Meldungen anzeigen:
+
+- „AQBot" ist beschädigt und kann nicht geöffnet werden
+- „AQBot" kann nicht geöffnet werden, da Apple es nicht auf Schadsoftware überprüfen kann
+
+**Lösungsschritte:**
+
+**1. Apps aus „Beliebiger Herkunft" zulassen**
+
+```bash
+sudo spctl --master-disable
+```
+
+Gehen Sie dann zu **Systemeinstellungen → Datenschutz & Sicherheit → Sicherheit** und wählen Sie **Beliebige Herkunft**.
+
+**2. Das Quarantäne-Attribut entfernen**
+
+```bash
+sudo xattr -dr com.apple.quarantine /Applications/AQBot.app
+```
+
+> Tipp: Sie können das App-Symbol in das Terminal ziehen, nachdem Sie `sudo xattr -dr com.apple.quarantine ` eingegeben haben.
+
+**3. Zusätzlicher Schritt für macOS Ventura und höher**
+
+Nach Abschluss der obigen Schritte kann der erste Start immer noch blockiert werden. Gehen Sie zu **Systemeinstellungen → Datenschutz & Sicherheit** und klicken Sie im Sicherheitsbereich auf **Trotzdem öffnen**. Dies muss nur einmal durchgeführt werden.
+
+## Community
+- [LinuxDO](https://linux.do)
+
+## Lizenz
+
+Dieses Projekt ist unter der [AGPL-3.0](LICENSE)-Lizenz lizenziert.

README-EN.md

@@ -1,4 +1,4 @@
-[简体中文](./README.md) | English
+[简体中文](./README.md) | [繁體中文](./README-ZH-TW.md) | **English** | [日本語](./README-JA.md) | [한국어](./README-KO.md) | [Français](./README-FR.md) | [Deutsch](./README-DE.md) | [Español](./README-ES.md) | [Русский](./README-RU.md) | [हिन्दी](./README-HI.md) | [العربية](./README-AR.md)
 
 [![AQBot](https://socialify.git.ci/AQBot-Desktop/AQBot/image?description=1&font=JetBrains+Mono&forks=1&issues=1&logo=https%3A%2F%2Fgithub.com%2FAQBot-Desktop%2FAQBot%2Fblob%2Fmain%2Fsrc%2Fassets%2Fimage%2Flogo.png%3Fraw%3Dtrue&name=1&owner=1&pattern=Floating+Cogs&pulls=1&stargazers=1&theme=Auto)](https://github.com/AQBot-Desktop/AQBot)
 
@@ -65,7 +65,7 @@
 ### Desktop Experience
 
 - **Theme Switching** — Dark/light themes that follow the system preference or can be set manually
-- **Interface Language** — Full support for Simplified Chinese and English, switchable at any time in settings
+- **Interface Language** — Full support for Simplified Chinese, Traditional Chinese, English, Japanese, Korean, French, German, Spanish, Russian, Hindi, and Arabic, switchable at any time in settings
 - **System Tray** — Minimize to system tray on window close without interrupting background services
 - **Always on Top** — Pin the main window to stay above all other windows
 - **Global Shortcuts** — Customizable global keyboard shortcuts to summon the main window at any time