
#### #### ## Introdução ### 🚀 **Um companheiro de desktop com inteligência artificial com possibilidades infinitas!** #### Companheiro de Desktop: Suporta modelos VRM personalizados, ações, cenas 3D e é compatível com [extensões live2D](https://github.com/heshengtao/sap-live2d)  #### Link VTS: Controle modelos Live2D no Vtube Studio, suportando ações personalizadas e controle de expressões  #### Interface de chat de alta liberdade: imagens de fundo personalizadas, pacotes de emojis, personas de personagens, avatares de personagens 2D baseados em THA e ferramentas MCP de personagens para uma conversa mais imersiva  #### Central de Tarefas: Permita que seus agentes de IA executem qualquer tarefa avançada em segundo plano, controlem automaticamente seu computador para realizar trabalhos, com suporte a MCP e Agent Skills.  #### Controle de Computador: Através da visão do desktop combinada com uma cadeia de ferramentas para controlar o mouse, teclado e terminal, os agentes de IA podem realizar qualquer tarefa em um computador! A imagem abaixo mostra uma IA jogando Wordle.  #### Múltiplos Modos de Janela: A interface de chat suporta encaixe no desktop em tamanho de telefone e tamanho cápsula  #### Bate-papo em Grupo com Múltiplos Papéis: Suporta cartões de personagem do Tavern e memória de longo prazo, permitindo conversar com vários personagens simultaneamente!  #### Bot de Mensagens Instantâneas: Suporta implantação com um clique em QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack  #### Bot de Live Streaming: Suporta implantação com um clique em Bilibili, YouTube, Twitch e permite transmissão ao vivo panorâmica de 360 graus.  #### Navegador de IA: Equipa seus agentes de IA com seu próprio navegador, suportando controle automático  #### Sistema de Extensões: Suporta a instalação de extensões e a criação de novas. A imagem abaixo mostra uma extensão galgame. Todas as extensões podem ser abertas em uma janela independente ou em uma barra lateral. Você pode até usar a skill de agente [sap-extension-creator](skills/sap-extension-creator) para criar novas extensões SAP, alcançando a auto-inicialização da agent party!  #### Amigável para Desenvolvedores: Oferece interfaces de API OpenAI abertas e interfaces MCP, permitindo que agentes sejam conectados externamente  ## Início rápido ### Se você é um agente CLI O agente CLI precisa verificar a documentação em [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md). Consulte este documento para orientar os usuários na instalação deste software! ### Se você é um humano usando um agente CLI Envie este link para sua IA, e a IA irá guiá-lo na instalação deste software! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Pacote portátil Windows (Recomendado! Versão sem instalação, suporta sincronização com um clique para a versão mais recente do repositório, sem necessidade de aguardar o empacotamento da versão desktop) 👉 [Clique para baixar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-win-v0.4.2.zip) ⭐ Nota! Você pode clicar duas vezes em `一键更新(update).bat` para atualizar o software, ou clicar duas vezes em `一键启动(start).bat` para iniciar o software. O sistema operacional deve ser **Windows 10/11, Windows Server 2025** ou uma versão posterior! ### Instalação Windows Desktop 👉 [Clique para baixar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-Setup-0.4.2.exe) ⭐ Nota! Escolha instalar apenas para o usuário atual durante a instalação, caso contrário, privilégios de administrador serão necessários para iniciar. O sistema operacional deve ser **Windows 10/11, Windows Server 2025** ou uma versão posterior! ### Pacote Integrado MacOS (Atualmente suporta apenas chips M, versão sem instalação, suporta sincronização com um clique para a versão mais recente do repositório, sem necessidade de aguardar o empacotamento da versão desktop) > **Adequado para desenvolvedores/usuários avançados**: Versão sem instalação, suporta sincronização com um clique para a versão mais recente do repositório, sem necessidade de aguardar o empacotamento da versão desktop. 👉 [Clique para baixar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/super-agent-party-mac-v0.4.2.zip) #### 🚀 Passos de Uso **1. Remover a Quarentena de Download de Rede (Importante)** Após baixar e extrair, abra o Terminal, digite o seguinte comando (observe que há um espaço no final), então arraste a **pasta extraída** para a janela do Terminal e pressione Enter: ```shell sudo xattr -rd com.apple.quarantine ``` *(Nota: O parâmetro `-rd` remove recursivamente os atributos de quarentena para todos os componentes dentro da pasta; caso contrário, o ambiente Python pode não funcionar corretamente.)* **2. Conceder Permissões de Execução de Script** Navegue até a pasta no Terminal e execute: ```shell chmod +x 一键更新(update).sh 一键启动(start).sh ``` **3. Executar o Software** - **Primeiro uso/Atualização:** Recomenda-se executar primeiro `./一键更新(update).sh` para garantir que as dependências estejam sincronizadas com as mais recentes. - **Inicialização diária:** Execute diretamente `./一键启动(start).sh`. ### Instalação MacOS Desktop (Atualmente suporta apenas chips M) 👉 [Clique para baixar](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ Atenção! Após o download, arraste o aplicativo do arquivo dmg para o diretório `/Applications`, então abra o terminal, execute o seguinte comando e digite a senha de root para remover o atributo de Quarentena anexado ao download de rede: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Instalação Linux Desktop `.AppImage` é um formato de aplicativo Linux que não requer instalação e pode ser usado imediatamente. Adequado para a maioria das distribuições 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) ### Implantação Docker (Esta versão do animal de estimação desktop só pode ser visualizada através do navegador) ```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 ``` ⭐ Nota! `./super-agent-data` pode ser substituído por qualquer pasta local. Após o Docker iniciar, todos os dados serão armazenados em cache nesta pasta local e não serão carregados em nenhum outro lugar. **Pronto para usar:** Visite http://localhost:3456/ --- ### Implantação Docker Compose (Esta versão do animal de estimação desktop só pode ser visualizada através do navegador, e um contêiner gateway adicional será iniciado para gerenciamento de login) ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party docker-compose up -d ``` ⭐ Nota! O nome de usuário padrão é `root` e a senha padrão é `pass`. Altere a senha após o primeiro login. **Pronto para usar:** Visite http://localhost:3456/ **Gerenciamento de chave de API:** Visite http://localhost:3456/token.html ### Cliente Lite compatível com sua versão Docker, transformando Docker em um aplicativo desktop 👉 [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) ### Implantação a partir do código-fonte ```shell git clone https://github.com/heshengtao/super-agent-party.git cd super-agent-party uv sync npm install npm run dev ``` ## Extensões Adicionado um sistema de extensões totalmente novo. Você pode verificar os plugins disponíveis na [lista de plugins](https://super-agent-party.github.io/plugins.html), ou visualizá-los e instalá-los diretamente na party em 【Desenvolvedor】->【Extensões】. Você também pode adicionar suas próprias extensões desenvolvidas à lista oficial de plugins em [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)! ### Extensões existentes | Nome | Autor | Descrição | URL do repositório | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | Super Agent Party Example | heshengtao | Plugin de exemplo para o Super Agent Party, demonstrando a arquitetura e capacidades do plugin. | https://github.com/heshengtao/sap-example | | Super Agent Party Example With NodeJS | heshengtao | Este é um exemplo de frontend de chat com ambiente NodeJS | https://github.com/heshengtao/sap-example-with-node | | Web Preview | heshengtao | Um plugin que permite funcionalidade de pré-visualização web para o Super Agent Party. | https://github.com/heshengtao/sap-web-preview | | Story Adventure | heshengtao | Um plugin de aventura interativa que gera conteúdo de história e opções usando IA. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Esta é uma extensão Live 2D | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | Este é um Editor de IA | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | Esta é uma extensão de galgame com IA | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | Esta é uma extensão de leitura de tarô com IA | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | Esta é uma extensão de planilha com IA | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | Esta é uma extensão de drawio com IA | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | Esta é uma extensão de editor mermaid com IA | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Esta é uma extensão de leitor RSS com IA para o Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Exponha o Super Agent Party à internet pública com um clique | https://github.com/heshengtao/sap-remote | | Code Server | heshengtao | Extensão de IDE para o Super Agent Party | https://github.com/heshengtao/sap-code-server | | CLI | heshengtao | Extensão de CLI para o Super Agent Party | https://github.com/heshengtao/sap-cli | | LX-music | heshengtao | Conecte o super agent party à API do LX Music, deixe seu companheiro IA controlar a reprodução de música! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | Extensão de PPT com IA para o Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | Extensão de personagem mago estelar — instala com um clique o cartão de personagem, modelo THA, adesivos e fundo | https://github.com/heshengtao/sap-lyra-extension | ## Requisitos de hardware - CPU: 2 núcleos ou mais - Memória: 2 GB ou mais **Como todos os modelos são opcionais, você pode acessar o mecanismo de implantação local ou usar interfaces de provedores de serviços em nuvem, portanto, há poucos requisitos de hardware. Testamos a versão Docker em um servidor de nuvem com 2 núcleos e 2 GB e funcionou perfeitamente.** ## Uso - Desktop: Clique no ícone da área de trabalho para usar imediatamente. - Web ou Docker: Acesse http://localhost:3456/ após a inicialização. - Chamada de API: Amigável para desenvolvedores, perfeitamente compatível com o formato OpenAI, pode gerar saída em tempo real e não afeta a velocidade de resposta da API original. Não é necessário modificar o código de chamada: ```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": "O que é o Super Agent Party?"} ] ) print(response.choices[0].message.content) ``` - Chamada MCP: Após a inicialização, você pode invocar o serviço MCP local escrevendo o seguinte conteúdo no arquivo de configuração: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp" } } } ``` - Comandos rápidos: Na caixa de chat ou em qualquer plataforma de IM conectada (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk), digite os comandos abaixo para controlar rapidamente o assistente. Você pode ativá-los/desativá-los e visualizar a lista completa em **Configurações do Sistema → Comandos Rápidos**. | Comando | Aliases | Escopo | Descrição | | --- | --- | --- | --- | | `/help` | `/帮助` `/?` | Chat + IM | Listar todos os comandos rápidos disponíveis | | `/new` | `/reset` `/重启` `/新建` `/restart` | Chat + IM | Limpar a conversa atual e começar de novo | | `/stop` | `/停止` | Chat + IM | Parar a resposta que está sendo gerada | | `/retry` | `/重试` | Chat apenas | Regenerar a última resposta | | `/model [provider:model]` | `/模型` | Chat + IM | Mostrar ou trocar o modelo (IM mostra apenas) | | `/personality [name]` | `/角色` `/persona` | Chat + IM | Mostrar ou trocar a personalidade | | `/skills` | `/技能` | Chat + IM | Navegar pela lista de habilidades disponíveis | | `/id` | - | IM apenas | Mostrar o ChatID da sessão/canal atual | | `/sub` | `/订阅` | IM apenas | Adicionar a sessão atual à lista de mensagens proativas | | `/unsub` | `/取消订阅` | IM apenas | Remover a sessão atual da lista de mensagens proativas | | `/plan` * | `/计划` | Chat + IM | Alternar para modo de plano (somente leitura) | | `/read` * | `/只读` | Chat + IM | Alternar para modo somente leitura (confirmar cada ação) | | `/edit` * | `/编辑` | Chat + IM | Alternar para modo de aceitar edições | | `/yolo` * | - | Chat + IM | Alternar para modo Yolo (autonomia total) | | `/cowork` * | `/协作` | Chat + IM | Alternar para modo de colaboração (sub-agentes) | | `/goal` * | `/目标` | Chat + IM | Alternar para modo de objetivo (loop autônomo) | | `/