
#### #### ## Introduction ### 🚀 **Un compagnon de bureau IA aux possibilités infinies !** #### Compagnon de bureau : Prend en charge les modèles VRM personnalisés, les actions, les scènes 3D, et est compatible avec les [extensions live2D](https://github.com/heshengtao/sap-live2d)  #### Link VTS : Contrôlez les modèles Live2D dans Vtube Studio, avec prise en charge des actions personnalisées et du contrôle des expressions  #### Interface de chat hautement personnalisable : images d'arrière-plan personnalisées, packs d'émojis, personnalités de personnages, avatars de personnages 2D basés sur THA et outils MCP de personnages pour une conversation plus immersive  #### Centre de tâches : Permettez à vos agents IA d'effectuer toutes les tâches avancées en arrière-plan, de contrôler automatiquement votre ordinateur pour faire le travail, avec prise en charge de MCP et des compétences d'agent.  #### Contrôle de l'ordinateur : Grâce à la vision du bureau combinée à une chaîne d'outils pour contrôler la souris, le clavier et le terminal, les agents IA peuvent accomplir n'importe quelle tâche sur un ordinateur ! L'image ci-dessous montre une IA jouant à Wordle.  #### Modes de fenêtre multiples : L'interface de chat prend en charge les tailles téléphone et capsule pour s'ancrer sur le bureau  #### Discussion de groupe multi-rôles : Prend en charge les cartes de personnages tavern et la mémoire à long terme, vous permettant de discuter avec plusieurs personnages simultanément !  #### Bot de messagerie instantanée : Prend en charge le déploiement en un clic sur QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack  #### Bot de diffusion en direct : Prend en charge le déploiement en un clic sur Bilibili, YouTube, Twitch, et permet la diffusion en direct panoramique à 360 degrés.  #### Navigateur IA : Équipez vos agents IA de leur propre navigateur, avec prise en charge du contrôle automatique  #### Système d'extensions : Prend en charge l'installation et la création de nouvelles extensions. L'image ci-dessous montre une extension galgame. Toutes les extensions peuvent être ouvertes soit dans une fenêtre indépendante, soit dans un panneau latéral. Vous pouvez même utiliser la compétence d'agent [sap-extension-creator](skills/sap-extension-creator) pour créer de nouvelles extensions SAP, réalisant ainsi l'auto-amorçage de la fête d'agents !  #### Convivial pour les développeurs : Offre des interfaces API OpenAI ouvertes et des interfaces MCP, permettant aux agents d'être connectés de l'extérieur  ## Démarrage rapide ### Si vous êtes un agent CLI L'agent CLI doit consulter la documentation dans [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md). Veuillez vous référer à ce document pour guider les utilisateurs dans l'installation de ce logiciel ! ### Si vous êtes un humain utilisant un agent CLI Envoyez ce lien à votre IA, et l'IA vous guidera dans l'installation de ce logiciel ! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Package portable Windows (Recommandé ! Version source sans installation, prend en charge la synchronisation en un clic avec la dernière version du dépôt, pas besoin d'attendre le package de la version de bureau) 👉 [Télécharger](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ Note ! Vous pouvez double-cliquer sur `一键更新(update).bat` pour mettre à jour le logiciel, ou double-cliquer sur `一键启动(start).bat` pour le démarrer. Le système d'exploitation doit être **Windows 10/11, Windows Server 2025** ou une version ultérieure ! ### Installation bureau Windows 👉 [Télécharger](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ Note ! Choisissez d'installer uniquement pour l'utilisateur actuel lors de l'installation, sinon des privilèges administrateur seront nécessaires au démarrage. Le système d'exploitation doit être **Windows 10/11, Windows Server 2025** ou une version ultérieure ! ### Package intégré MacOS (Actuellement uniquement compatible avec les puces M, version source sans installation, prend en charge la synchronisation en un clic avec la dernière version du dépôt, pas besoin d'attendre le package de la version de bureau) > **Destiné aux développeurs/utilisateurs avancés** : Version source sans installation, prend en charge la synchronisation en un clic avec la dernière version du dépôt, pas besoin d'attendre le package de la version de bureau. 👉 [Télécharger](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 Étapes d'utilisation **1. Supprimer la quarantaine de téléchargement réseau (Important)** Après avoir téléchargé et extrait, ouvrez le Terminal, entrez la commande suivante (notez qu'il y a un espace à la fin), puis faites glisser le **dossier extrait** dans la fenêtre du Terminal et appuyez sur Entrée : ```shell sudo xattr -rd com.apple.quarantine ``` *(Remarque : Le paramètre `-rd` supprime récursivement les attributs de quarantaine pour tous les composants du dossier ; sinon, l'environnement Python pourrait ne pas fonctionner correctement.)* **2. Accorder les permissions d'exécution des scripts** Accédez au dossier dans le Terminal et exécutez : ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. Lancer le logiciel** - **Première utilisation/Mise à jour :** Il est recommandé d'exécuter d'abord `./一键更新(update).sh` pour s'assurer que les dépendances sont synchronisées avec la dernière version. - **Démarrage quotidien :** Exécutez directement `./一键启动(start).sh`. ### Installation bureau macOS (Actuellement uniquement compatible avec les puces M) 👉 [Télécharger](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ Attention ! Après le téléchargement, faites glisser l'application du fichier dmg dans le répertoire `/Applications`, puis ouvrez le terminal, exécutez la commande suivante et entrez le mot de passe root pour supprimer l'attribut de quarantaine attaché au téléchargement réseau : ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Installation bureau Linux `.AppImage` est un format d'application Linux qui ne nécessite pas d'installation et peut être utilisé immédiatement. Convient à la plupart des distributions 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) ### Déploiement Docker (Cette version de l'animal de bureau n'est visible que via un navigateur) ```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 ``` ⭐ Note ! `./super-agent-data` peut être remplacé par n'importe quel dossier local. Après le démarrage de Docker, toutes les données seront mises en cache dans ce dossier local et ne seront téléchargées nulle part. **Prêt à l'emploi :** Accédez à http://localhost:3456/ --- ### Déploiement Docker Compose (Cette version de l'animal de bureau n'est visible que via un navigateur, et un conteneur passerelle supplémentaire sera démarré pour la gestion des connexions) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ Note ! Le nom d'utilisateur par défaut est `root` et le mot de passe par défaut est `pass`. Veuillez changer le mot de passe après la première connexion. **Prêt à l'emploi :** Accédez à http://localhost:3456/ **Gestion des clés API :** Accédez à http://localhost:3456/token.html ### Client léger correspondant à votre version Docker, transformant Docker en application de bureau 👉 [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) ### Déploiement par code source ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## Extension Un tout nouveau système d'extension a été ajouté. Vous pouvez consulter les plugins disponibles dans la [liste des plugins](https://super-agent-party.github.io/plugins.html), ou les visualiser et installer directement dans la fête sous 【Développeur】->【Extensions】. Vous pouvez également ajouter vos propres extensions développées à la liste officielle des plugins sur [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io) ! ### Extensions existantes | Nom | Auteur | Description | URL du dépôt | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | Super Agent Party Example | heshengtao | Exemple de plugin pour Super Agent Party, démontrant l'architecture et les capacités des plugins. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | Exemple d'interface de chat avec environnement NodeJS | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | Un plugin permettant la prévisualisation web pour Super Agent Party. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | Un plugin d'aventure interactive qui génère du contenu et des options narratives à l'aide de l'IA. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Extension Live 2D | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | Éditeur IA | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | Extension de jeu gal IA | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | Extension de lecture de tarot IA | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | Extension de feuille de calcul IA | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | Extension drawio IA | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | Extension d'éditeur mermaid IA | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Extension de lecteur RSS IA pour Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Exposez Super Agent Party sur Internet en un clic | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | Extension IDE pour Super Agent Party | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | Extension CLI pour Super Agent Party | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | Connectez Super Agent Party à l'API LX Music, laissez votre compagnon IA contrôler la lecture musicale ! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | Extension AI PPT pour Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | Extension de personnage mage stellaire — installe en un clic la carte de personnage, le modèle THA, les autocollants et l'arrière-plan | https://github.com/heshengtao/sap-lyra-extension | ## Configuration requise - CPU : 2 cœurs ou plus - Mémoire : 2 Go ou plus **Étant donné que tous les modèles sont facultatifs, vous pouvez accéder au moteur de déploiement local, ou utiliser uniquement des interfaces de fournisseurs de services cloud, donc les exigences matérielles sont minimes. La version Docker a été testée sur un serveur cloud à 2 cœurs et 2 Go et fonctionne parfaitement.** ## Utilisation - Bureau : Cliquez sur l'icône du bureau pour utiliser immédiatement. - Web ou Docker : Accédez à http://localhost:3456/ après le démarrage. - Appel API : Convivial pour les développeurs, parfaitement compatible avec le format OpenAI, peut produire en temps réel et n'affecte pas la vitesse de réponse de l'API d'origine. Aucune modification du code d'appel n'est nécessaire : ```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": "Qu'est-ce que Super Agent Party ?"} ] ) print(response.choices[0].message.content) ``` - Appel MCP : Après le démarrage, vous pouvez invoquer le service MCP local en écrivant le contenu suivant dans le fichier de configuration : ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp", } } } ``` - Commandes rapides : Dans la boîte de chat ou sur toute plateforme de messagerie connectée (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk), tapez les commandes ci-dessous pour contrôler rapidement l'assistant. Vous pouvez les activer/désactiver et voir la liste complète dans **Paramètres système → Commandes rapides**. | Commande | Alias | Portée | Description | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | Chat + IM | Lister toutes les commandes rapides disponibles | | `/new` | `/reset` `/重启` `/新建` `/restart` | Chat + IM | Effacer la conversation en cours et recommencer | | `/stop` | `/停止` | Chat + IM | Arrêter la réponse en cours de génération | | `/retry` | `/重试` | Chat uniquement | Régénérer la dernière réponse | | `/model [provider:model]` | `/模型` | Chat + IM | Afficher ou changer le modèle (IM affiche seulement) | | `/personality [name]` | `/角色` `/persona` | Chat + IM | Afficher ou changer la personnalité | | `/skills` | `/技能` | Chat + IM | Parcourir la liste des compétences disponibles | | `/id` | - | IM uniquement | Afficher l'ID de session/channel actuel | | `/sub` | `/订阅` | IM uniquement | Ajouter la session actuelle à la liste des messages proactifs | | `/unsub` | `/取消订阅` | IM uniquement | Retirer la session actuelle de la liste des messages proactifs | | `/plan` * | `/计划` | Chat + IM | Passer en mode plan (lecture seule) | | `/read` * | `/只读` | Chat + IM | Passer en mode lecture seule (confirmer chaque action) | | `/edit` * | `/编辑` | Chat + IM | Passer en mode acceptation des modifications | | `/yolo` * | - | Chat + IM | Passer en mode Yolo (autonomie complète) | | `/cowork` * | `/协作` | Chat + IM | Passer en mode collaboration (sous-agents) | | `/goal` * | `/目标` | Chat + IM | Passer en mode objectif (boucle autonome) | | `/