
#### #### ## مقدمة ### 🚀 **رفيق مكتب يعمل بالذكاء الاصطناعي بإمكانيات لا نهائية!** #### الرفيق المكتبي: يدعم نماذج VRM مخصصة، وإجراءات، ومشاهد ثلاثية الأبعاد، ومتوافق مع [إضافات live2D](https://github.com/heshengtao/sap-live2d)  #### ربط VTS: التحكم في نماذج Live2D في Vtube Studio، مع دعم الإجراءات المخصصة والتحكم في التعابير  #### واجهة محادثة عالية الحرية: صور خلفية مخصصة، حزم رموز تعبيرية، شخصيات، صور رمزية ثنائية الأبعاد قائمة على THA، وأدوات MCP للشخصيات لمحادثة أكثر غامرة  #### مركز المهام: تمكين وكلاء الذكاء الاصطناعي من تنفيذ أي مهام متقدمة في الخلفية، والتحكم تلقائيًا في جهاز الكمبيوتر الخاص بك لإنجاز العمل، مع دعم MCP ومهارات الوكيل.  #### التحكم في الكمبيوتر: من خلال الرؤية المكتبية المقترنة بمجموعة أدوات للتحكم في الماوس ولوحة المفاتيح والطرفية، يمكن لوكلاء الذكاء الاصطناعي إنجاز أي مهمة على الكمبيوتر! الصورة أدناه تظهر ذكاء اصطناعي يلعب Wordle.  #### أوضاع نوافذ متعددة: تدعم واجهة الدردشة الإرساء بحجم الهاتف وحجم الكبسولة على سطح المكتب  #### الدردشة الجماعية متعددة الأدوار: تدعم بطاقات شخصيات tavern والذاكرة طويلة المدى، مما يتيح لك الدردشة مع شخصيات متعددة في وقت واحد!  #### بوت المراسلة الفورية: يدعم النشر بنقرة واحدة إلى QQ وWeChat وFeishu وDingTalk وTelegram وDiscord وSlack  #### بوت البث المباشر: يدعم النشر بنقرة واحدة إلى Bilibili وYouTube وTwitch، ويتيح البث المباشر البانورامي بزاوية 360 درجة.  #### متصفح الذكاء الاصطناعي: يزود وكلاء الذكاء الاصطناعي بمتصفح خاص بهم، مع دعم التحكم التلقائي  #### نظام الإضافات: يدعم تثبيت الإضافات وإنشاء إضافات جديدة. الصورة أدناه تظهر إضافة galgame. يمكن فتح جميع الإضافات إما في نافذة مستقلة أو في شريط جانبي. يمكنك حتى استخدام مهارة الوكيل [sap-extension-creator](skills/sap-extension-creator) لإنشاء إضافات SAP جديدة، مما يحقق التمهيد الذاتي لحزب الوكيل!  #### صديق المطورين: يقدم واجهات برمجة تطبيقات OpenAI مفتوحة وواجهات MCP، مما يسمح بتوصيل الوكلاء خارجيًا  ## بداية سريعة ### إذا كنت وكيل CLI يحتاج وكيل CLI إلى مراجعة التوثيق في [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md). يُرجى الرجوع إلى هذا المستند لتوجيه المستخدمين خلال تثبيت هذا البرنامج! ### إذا كنت إنسانًا يستخدم وكيل CLI أرسل هذا الرابط إلى ذكائك الاصطناعي، وسيقوم الذكاء الاصطناعي بتوجيهك لتثبيت هذا البرنامج! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### حزمة Windows المحمولة (موصى بها! نسخة المصدر بدون تثبيت، تدعم المزامنة بنقرة واحدة لأحدث إصدار من المستودع، لا حاجة لانتظار تعبئة إصدار سطح المكتب) 👉 [انقر للتحميل](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ ملاحظة! يمكنك النقر双击 على `一键更新(update).bat` لتحديث البرنامج، أو النقر双击 على `一键启动(start).bat` لبدء تشغيل البرنامج. يجب أن يكون نظام التشغيل **Windows 10/11، Windows Server 2025**، أو إصدار أحدث! ### تثبيت سطح المكتب لنظام Windows 👉 [انقر للتحميل](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ ملاحظة! اختر التثبيت للمستخدم الحالي فقط أثناء التثبيت، وإلا ستكون صلاحيات المسؤول مطلوبة للبدء. يجب أن يكون نظام التشغيل **Windows 10/11، Windows Server 2025**، أو إصدار أحدث! ### حزمة MacOS المتكاملة (تدعم حاليًا شرائح M فقط، نسخة المصدر بدون تثبيت، تدعم المزامنة بنقرة واحدة لأحدث إصدار من المستودع، لا حاجة لانتظار تعبئة إصدار سطح المكتب) > **مناسبة للمطورين/المستخدمين المتقدمين**: نسخة المصدر بدون تثبيت، تدعم المزامنة بنقرة واحدة لأحدث إصدار من المستودع، لا حاجة لانتظار تعبئة إصدار سطح المكتب. 👉 [انقر للتحميل](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 خطوات الاستخدام **1. إزالة الحجر الصحي لتنزيلات الشبكة (هام)** بعد التنزيل والفك، افتح الطرفية، أدخل الأمر التالي (لاحظ وجود مسافة في النهاية)، ثم اسحب **المجلد الذي تم فكه** إلى نافذة الطرفية واضغط Enter: ```shell sudo xattr -rd com.apple.quarantine ``` *(ملاحظة: المعامل `-rd` يزيل سمات الحجر الصحي بشكل متكرر لجميع المكونات داخل المجلد؛ وإلا فقد لا تعمل بيئة Python بشكل صحيح.)* **2. منح صلاحيات تنفيذ البرنامج النصي** انتقل إلى المجلد في الطرفية ونفذ: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. تشغيل البرنامج** - **الاستخدام الأول/التحديث:** يُوصى بتنفيذ `./一键更新(update).sh` أولاً لضمان مزامنة التبعيات إلى الأحدث. - **بدء التشغيل اليومي:** قم بتنفيذ `./一键启动(start).sh` مباشرة. ### تثبيت سطح المكتب لنظام MacOS (تدعم حاليًا شرائح M فقط.) 👉 [انقر للتحميل](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐تنبيه! بعد التنزيل، اسحب ملف التطبيق من ملف dmg إلى دليل `/Applications`، ثم افتح الطرفية، ونفذ الأمر التالي وأدخل كلمة مرور الجذر لإزالة سمة الحجر الصحي المرتبطة من تنزيل الشبكة: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### تثبيت سطح المكتب لنظام Linux `.AppImage` هو تنسيق تطبيقات Linux لا يتطلب التثبيت ويمكن استخدامه فورًا. مناسب لمعظم توزيعات Linux. 👉 [Linux-AppImage-X86_64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-x86_64.AppImage) 👉 [Linux-AppImage-Arm64](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Linux-arm64.AppImage) ### نشر Docker (يمكن مشاهدة هذا الإصدار من الحيوان الأليف المكتبي فقط من خلال المتصفح) ```shell docker pull ailm32442/super-agent-party:latest docker run -d -p 3456:3456 -v ./super-agent-data:/app/data ailm32442/super-agent-party:latest ``` ⭐ ملاحظة! يمكن استبدال `./super-agent-data` بأي مجلد محلي. بعد بدء Docker، سيتم تخزين جميع البيانات في هذا المجلد المحلي ولن يتم تحميلها إلى أي مكان. **جاهز للاستخدام:** قم بزيارة http://localhost:3456/ --- ### نشر Docker Compose (يمكن مشاهدة هذا الإصدار من الحيوان الأليف المكتبي فقط من خلال المتصفح، وسيتم تشغيل حاوية بوابة إضافية لإدارة تسجيل الدخول) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ ملاحظة! اسم المستخدم الافتراضي هو `root`، وكلمة المرور الافتراضية هي `pass`. يُرجى تغيير كلمة المرور بعد تسجيل الدخول الأول. **جاهز للاستخدام:** قم بزيارة http://localhost:3456/ **إدارة مفتاح API:** قم بزيارة http://localhost:3456/token.html ### العميل الخفيف المطابق لإصدار Docker الخاص بك، يحول Docker إلى تطبيق مكتبي 👉 [SAP-lite-Windows-exe](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-Setup-0.1.2.exe) 👉 [SAP-lite-MacOS-dmg](https://github.com/heshengtao/desktop-for-sap/releases/download/v0.1.2/super-agent-party-lite-0.1.2-Mac.dmg) ### نشر كود المصدر ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## الإضافات تمت إضافة نظام إضافات جديد بالكامل. يمكنك التحقق من الإضافات المتاحة في [قائمة الإضافات](https://super-agent-party.github.io/plugins.html)، أو عرضها وتثبيتها مباشرة في الحزب من خلال 【Developer】->【Extensions】. يمكنك أيضًا إضافة الإضافات التي طورتها بنفسك إلى قائمة الإضافات الرسمية على [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)! ### الإضافات الموجودة | الاسم | المؤلف | الوصف | رابط المستودع | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | Super Agent Party Example | heshengtao | إضافة مثال لـ Super Agent Party، توضح بنية الإضافة وإمكانياتها. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | هذا مثال لواجهة محادثة أمامية مع بيئة nodeJS | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | إضافة تتيح وظيفة المعاينة على الويب لـ Super Agent Party. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | إضافة مغامرات قصصية تفاعلية تولد محتوى القصة والخيارات باستخدام الذكاء الاصطناعي. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | هذه إضافة Live 2D | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | هذا محرر ذكاء اصطناعي | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | هذه إضافة galgame تعمل بالذكاء الاصطناعي | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | هذه إضافة قارئ تاروت بالذكاء الاصطناعي | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | هذه إضافة جداول بيانات بالذكاء الاصطناعي | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | هذه إضافة drawio بالذكاء الاصطناعي | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | هذه إضافة محرر mermaid بالذكاء الاصطناعي | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | هذه إضافة قارئ RSS بالذكاء الاصطناعي لـ Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | كشف Super Agent Party للإنترنت العام بنقرة واحدة | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | إضافة IDE لـ Super Agent Party | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | إضافة CLI لـ Super Agent Party | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | قم بتوصيل super agent party بـ LX Music API، دع الرفيق الذكي يتحكم في تشغيل الموسيقى! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | إضافة عروض تقديمية بالذكاء الاصطناعي لـ Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | إضافة شخصية الساحر النجمي — تثبيت بنقرة واحدة لبطاقة الشخصية ونموذج THA والملصقات والخلفية | https://github.com/heshengtao/sap-lyra-extension | ## المتطلبات التقنية - المعالج: نواتان أو أكثر - الذاكرة: 2 جيجابايت أو أكثر **لأن جميع النماذج اختيارية، يمكنك الوصول إلى محرك النشر المحلي، أو يمكنك استخدام واجهة مزود الخدمة السحابية بالكامل، لذا فإن متطلبات الأجهزة قليلة. تم اختبار إصدار docker على خادم سحابي ثنائي النواة و 2 جيجابايت من الذاكرة وكان يعمل بشكل جيد** ## الاستخدام - سطح المكتب: انقر على أيقونة سطح المكتب للاستخدام الفوري. - الويب أو docker: الوصول إلى http://localhost:3456/ بعد التشغيل. - استدعاء API: صديق للمطورين، متوافق تمامًا مع تنسيق OpenAI، يمكنه الإخراج في الوقت الفعلي، ولا يؤثر على سرعة استجابة API الأصلية. لا حاجة لتعديل كود الاستدعاء: ```python from openai import OpenAI client = OpenAI( api_key="super-secret-key", base_url="http://localhost:3456/v1" ) response = client.chat.completions.create( model="super-model", messages=[ {"role": "user", "content": "What is Super Agent Party?"} ] ) print(response.choices[0].message.content) ``` - استدعاء MCP: بعد التشغيل، يمكنك استدعاء خدمة MCP المحلية عن طريق كتابة المحتوى التالي في ملف التكوين: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp", } } } ``` - أوامر الاختصار: في مربع الدردشة أو أي منصة مراسلة فورية متصلة (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk)، اكتب الأوامر أدناه للتحكم السريع في المساعد. يمكنك تبديلها وعرض القائمة الكاملة في **System Settings → Shortcut Commands**. | الأمر | الأسماء المستعارة | النطاق | الوصف | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | الدردشة + IM | عرض جميع أوامر الاختصار المتاحة | | `/new` | `/reset` `/重启` `/新建` `/restart` | الدردشة + IM | مسح المحادثة الحالية والبدء من جديد | | `/stop` | `/停止` | الدردشة + IM | إيقاف الرد الذي يتم إنشاؤه حاليًا | | `/retry` | `/重试` | الدردشة فقط | إعادة إنشاء آخر رد | | `/model [provider:model]` | `/模型` | الدردشة + IM | عرض أو تبديل النموذج (IM يعرض فقط) | | `/personality [name]` | `/角色` `/persona` | الدردشة + IM | عرض أو تبديل الشخصية | | `/skills` | `/技能` | الدردشة + IM | تصفح قائمة المهارات المتاحة | | `/id` | - | IM فقط | عرض ChatID للجلسة/القناة الحالية | | `/sub` | `/订阅` | IM فقط | إضافة الجلسة الحالية إلى قائمة الرسائل الاستباقية | | `/unsub` | `/取消订阅` | IM فقط | إزالة الجلسة الحالية من قائمة الرسائل الاستباقية | | `/plan` * | `/计划` | الدردشة + IM | التبديل إلى وضع التخطيط (للقراءة فقط) | | `/read` * | `/只读` | الدردشة + IM | التبديل إلى وضع القراءة فقط (تأكيد كل إجراء) | | `/edit` * | `/编辑` | الدردشة + IM | التبديل إلى وضع قبول التعديلات | | `/yolo` * | - | الدردشة + IM | التبديل إلى وضع Yolo (استقلالية كاملة) | | `/cowork` * | `/协作` | الدردشة + IM | التبديل إلى وضع العمل المشترك (تعاون الوكيل الفرعي) | | `/goal` * | `/目标` | الدردشة + IM | التبديل إلى وضع الهدف (حلقة مستقلة) | | `/