
#### #### ## Einführung ### 🚀 **Ein KI-Desktop-Begleiter mit unendlichen Möglichkeiten!** #### Desktop-Begleiter: Unterstützt benutzerdefinierte VRM-Modelle, Aktionen, 3D-Szenen und ist kompatibel mit [live2D-Erweiterungen](https://github.com/heshengtao/sap-live2d)  #### Link VTS: Steuern Sie Live2D-Modelle in Vtube Studio mit benutzerdefinierten Aktionen und Ausdruckssteuerung  #### Hochflexible Chat-Oberfläche: Benutzerdefinierte Hintergrundbilder, Emoji-Pakete, Charakter-Personas, THA-basierte 2D-Charakter-Avatare und Charakter-MCP-Tools für ein immersiveres Gespräch  #### Aufgabencenter: Lassen Sie Ihre KI-Agenten beliebige komplexe Aufgaben im Hintergrund ausführen, steuern Sie automatisch Ihren Computer, um Arbeiten zu erledigen, mit Unterstützung für MCP und Agent Skills.  #### Computersteuerung: Durch Desktop-Vision kombiniert mit einer Toolchain zur Steuerung von Maus, Tastatur und Terminal können KI-Agenten jede Aufgabe auf einem Computer erledigen! Das Bild unten zeigt eine KI beim Spielen von Wordle.  #### Mehrere Fenstermodi: Die Chat-Oberfläche unterstützt telefon- und kapselgroße Andockmöglichkeiten auf dem Desktop  #### Multi-Rollen-Gruppenchat: Unterstützt Tavernen-Charakterkarten und Langzeitgedächtnis, sodass Sie mit mehreren Charakteren gleichzeitig chatten können!  #### Instant-Messaging-Bot: Unterstützt Ein-Klick-Bereitstellung für QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack  #### Live-Streaming-Bot: Unterstützt Ein-Klick-Bereitstellung für Bilibili, YouTube, Twitch und ermöglicht 360-Grad-Panorama-Live-Streaming.  #### KI-Browser: Statten Sie Ihre KI-Agenten mit einem eigenen Browser aus, der automatische Steuerung unterstützt  #### Erweiterungssystem: Unterstützt die Installation von Erweiterungen und das Erstellen neuer. Das Bild unten zeigt eine Galgame-Erweiterung. Alle Erweiterungen können entweder in einem unabhängigen Fenster oder in einer Seitenleiste geöffnet werden. Sie können sogar die Agenten-Fertigkeit [sap-extension-creator](skills/sap-extension-creator) verwenden, um neue SAP-Erweiterungen zu erstellen und so das Bootstrap der Agenten-Party zu erreichen!  #### Entwicklerfreundlich: Bietet offene OpenAI-API-Schnittstellen und MCP-Schnittstellen, sodass Agenten extern angebunden werden können  ## Schnellstart ### Wenn Sie ein CLI-Agent sind CLI-Agenten müssen die Dokumentation unter [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md) überprüfen. Bitte verwenden Sie dieses Dokument, um Benutzer durch die Installation dieser Software zu führen! ### Wenn Sie ein Mensch sind, der einen CLI-Agent verwendet Senden Sie diesen Link an Ihre KI, und die KI wird Sie durch die Installation dieser Software führen! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Windows portables Paket (Empfohlen! Installationsfreie Quellversion, unterstützt Ein-Klick-Synchronisation mit der neuesten Repository-Version, kein Warten auf die Desktop-Paketerstellung erforderlich) 👉 [Zum Download](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ Hinweis! Sie können `一键更新(update).bat` doppelklicken, um die Software zu aktualisieren, oder `一键启动(start).bat` doppelklicken, um die Software zu starten. Das Betriebssystem muss **Windows 10/11, Windows Server 2025** oder eine neuere Version sein! ### Windows Desktop-Installation 👉 [Zum Download](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ Hinweis! Wählen Sie bei der Installation die Option „Nur für den aktuellen Benutzer installieren", da sonst Administratorrechte zum Starten erforderlich sind. Das Betriebssystem muss **Windows 10/11, Windows Server 2025** oder eine neuere Version sein! ### MacOS Integriertes Paket (Derzeit nur M-Chips, installationsfreie Quellcode-Version, unterstützt Ein-Klick-Synchronisation mit der neuesten Repository-Version, kein Warten auf Desktop-Paketerstellung erforderlich) > **Geeignet für Entwickler/Fortgeschrittene Benutzer**: Installationsfreie Quellcode-Version, unterstützt Ein-Klick-Synchronisation mit der neuesten Repository-Version, kein Warten auf Desktop-Paketerstellung erforderlich. 👉 [Zum Download](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 Verwendungsschritte **1. Netzwerk-Download-Quarantäne entfernen (Wichtig)** Nach dem Herunterladen und Entpacken öffnen Sie das Terminal, geben Sie den folgenden Befehl ein (achten Sie auf das Leerzeichen am Ende), ziehen Sie dann den **entpackten Ordner** in das Terminal-Fenster und drücken Sie die Eingabetaste: ```shell sudo xattr -rd com.apple.quarantine ``` *(Hinweis: Der Parameter `-rd` entfernt rekursiv die Quarantäne-Attribute für alle Komponenten im Ordner; andernfalls funktioniert die Python-Umgebung möglicherweise nicht richtig.)* **2. Skriptausführungsberechtigungen erteilen** Navigieren Sie im Terminal zum Ordner und führen Sie Folgendes aus: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. Software ausführen** - **Erstverwendung/Update:** Es wird empfohlen, zuerst `./一键更新(update).sh` auszuführen, um sicherzustellen, dass die Abhängigkeiten auf dem neuesten Stand sind. - **Täglicher Start:** Führen Sie direkt `./一键启动(start).sh` aus. ### macOS Desktop-Installation (Derzeit nur M-Chips unterstützt) 👉 [Zum Download](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ Achtung! Ziehen Sie nach dem Download die App aus der DMG-Datei in das Verzeichnis `/Applications`. Öffnen Sie dann das Terminal, führen Sie den folgenden Befehl aus und geben Sie das Root-Passwort ein, um die Quarantäne-Attribute des Netzwerk-Downloads zu entfernen: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Linux Desktop-Installation `.AppImage` ist ein Linux-Anwendungsformat, das keine Installation erfordert und sofort verwendet werden kann. Geeignet für die meisten Linux-Distributionen. 👉 [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-Bereitstellung (Diese Version des Desktop-Pets kann nur über einen Browser angezeigt werden) ```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 ``` ⭐ Hinweis! `./super-agent-data` kann durch jeden lokalen Ordner ersetzt werden. Nach dem Docker-Start werden alle Daten in diesem lokalen Ordner zwischengespeichert und nicht hochgeladen. **Sofort einsatzbereit:** Besuchen Sie http://localhost:3456/ --- ### Docker Compose-Bereitstellung (Diese Version des Desktop-Pets kann nur über einen Browser angezeigt werden, und ein zusätzlicher Gateway-Container wird für die Anmeldeverwaltung gestartet) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ Hinweis! Der Standard-Benutzername ist `root`, und das Standard-Passwort ist `pass`. Bitte ändern Sie das Passwort nach der ersten Anmeldung. **Sofort einsatzbereit:** Besuchen Sie http://localhost:3456/ **API-Schlüsselverwaltung:** Besuchen Sie http://localhost:3456/token.html ### Lite-Client passend zu Ihrer Docker-Version, der Docker in eine Desktop-App verwandelt 👉 [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) ### Quellcode-Bereitstellung ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## Erweiterungen Ein brandneues Erweiterungssystem wurde hinzugefügt. Sie können verfügbare Plugins in der [Plugin-Liste](https://super-agent-party.github.io/plugins.html) überprüfen oder direkt in der Party unter 【Entwickler】→【Erweiterungen】 anzeigen und installieren. Sie können auch Ihre eigenen entwickelten Erweiterungen zur offiziellen Plugin-Liste unter [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io) hinzufügen! ### Vorhandene Erweiterungen | Name | Autor | Beschreibung | Repository-URL | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | Super Agent Party Example | heshengtao | Beispiel-Plugin für Super Agent Party, das die Plugin-Architektur und -Fähigkeiten demonstriert. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | Ein Chat-Frontend-Beispiel mit NodeJS-Umgebung | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | Ein Plugin, das Web-Vorschaufunktionen für Super Agent Party ermöglicht. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | Ein interaktives Story-Adventure-Plugin, das mit KI Geschichteninhalte und Optionen generiert. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Eine Live-2D-Erweiterung | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | Ein KI-Editor | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | Eine KI-Galgame-Erweiterung | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | Eine KI-Tarotkartenleser-Erweiterung | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | Eine KI-Tabellenkalkulations-Erweiterung | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | Eine KI-Drawio-Erweiterung | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | Eine KI-Mermaid-Editor-Erweiterung | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Eine KI-RSS-Reader-Erweiterung für Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Super Agent Party mit einem Klick ins öffentliche Internet freigeben | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | IDE-Erweiterung für Super Agent Party | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | CLI-Erweiterung für Super Agent Party | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | Verbinden Sie Super Agent Party mit der LX Music API und lassen Sie Ihren KI-Begleiter die Musikwiedergabe steuern! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | KI-PPT-Erweiterung für Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | Sternenlicht-Magier-Charaktererweiterung — mit einem Klick Charakterkarte, THA-Modell, Sticker und Hintergrund installieren | https://github.com/heshengtao/sap-lyra-extension | ## Systemvoraussetzungen - CPU: 2 Kerne oder mehr - Arbeitsspeicher: 2 GB oder mehr **Da alle Modelle optional sind — Sie können entweder auf eine lokale Bereitstellungs-Engine zugreifen oder vollständig Cloud-Dienst-Schnittstellen nutzen — sind die Hardwareanforderungen gering. Die Docker-Version wurde auf einem 2-Kern-2-GB-Cloud-Server getestet und funktioniert einwandfrei.** ## Verwendung - Desktop: Klicken Sie auf das Desktop-Symbol, um sofort zu beginnen. - Web oder Docker: Rufen Sie nach dem Start http://localhost:3456/ auf. - API-Aufruf: Entwicklerfreundlich, vollständig kompatibel mit dem OpenAI-Format, Echtzeit-Ausgabe möglich, ohne die Antwortgeschwindigkeit der ursprünglichen API zu beeinträchtigen. Keine Änderung des aufrufenden Codes erforderlich: ```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": "Was ist Super Agent Party?"} ] ) print(response.choices[0].message.content) ``` - MCP-Aufruf: Nach dem Start können Sie den lokalen MCP-Dienst aufrufen, indem Sie den folgenden Inhalt in die Konfigurationsdatei schreiben: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp" } } } ``` - Schnellbefehle: Geben Sie in der Chat-Box oder auf einer beliebigen verbundenen IM-Plattform (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk) die folgenden Befehle ein, um den Assistenten schnell zu steuern. Sie können sie in **Systemeinstellungen → Schnellbefehle** umschalten und die vollständige Liste anzeigen. | Befehl | Aliase | Bereich | Beschreibung | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | Chat + IM | Alle verfügbaren Schnellbefehle auflisten | | `/new` | `/reset` `/重启` `/新建` `/restart` | Chat + IM | Aktuelle Unterhaltung löschen und neu beginnen | | `/stop` | `/停止` | Chat + IM | Die aktuell generierte Antwort stoppen | | `/retry` | `/重试` | Nur Chat | Die letzte Antwort neu generieren | | `/model [provider:model]` | `/模型` | Chat + IM | Modell anzeigen oder wechseln (IM nur anzeigen) | | `/personality [name]` | `/角色` `/persona` | Chat + IM | Persönlichkeit anzeigen oder wechseln | | `/skills` | `/技能` | Chat + IM | Liste der verfügbaren Fähigkeiten durchsuchen | | `/id` | - | Nur IM | Aktuelle Sitzung/Channel-ChatID anzeigen | | `/sub` | `/订阅` | Nur IM | Aktuelle Sitzung zur proaktiven Nachrichtenliste hinzufügen | | `/unsub` | `/取消订阅` | Nur IM | Aktuelle Sitzung aus der proaktiven Nachrichtenliste entfernen | | `/plan` * | `/计划` | Chat + IM | In den Plan-Modus wechseln (schreibgeschützt) | | `/read` * | `/只读` | Chat + IM | In den Nur-Lese-Modus wechseln (jede Aktion bestätigen) | | `/edit` * | `/编辑` | Chat + IM | In den Bearbeitungsmodus wechseln | | `/yolo` * | - | Chat + IM | In den Yolo-Modus wechseln (volle Autonomie) | | `/cowork` * | `/协作` | Chat + IM | In den Cowork-Modus wechseln (Sub-Agenten-Zusammenarbeit) | | `/goal` * | `/目标` | Chat + IM | In den Ziel-Modus wechseln (autonome Schleife) | | `/