
#### #### ## Введение ### 🚀 **Настольный AI-компаньон с безграничными возможностями!** #### Настольный компаньон: поддерживает кастомные VRM-модели, действия, 3D-сцены и совместим с [live2D-расширениями](https://github.com/heshengtao/sap-live2d)  #### Link VTS: управляйте Live2D-моделями в Vtube Studio с поддержкой кастомных действий и контролем выражений лица  #### Высокосвободный интерфейс чата: кастомные фоновые изображения, наборы стикеров, персонажи, THA-основанные 2D-аватары и MCP-инструменты персонажей для более погружающего общения  #### Центр задач: ваши AI-агенты могут выполнять любые сложные задачи в фоновом режиме, автоматически управлять вашим компьютером для выполнения работы, с поддержкой MCP и Agent Skills.  #### Управление компьютером: благодаря компьютерному зрению в сочетании с инструментарием для управления мышью, клавиатурой и терминалом AI-агенты могут выполнять любые задачи на компьютере! На изображении ниже AI играет в Wordle.  #### Несколько режимов окон: интерфейс чата поддерживает докинг на рабочем столе в размере телефона и капсулы  #### Многоролевой групповой чат: поддерживает карточки персонажей Tavern и долговременную память, позволяя общаться с несколькими персонажами одновременно!  #### Бот для мессенджеров: поддерживает развёртывание в один клик для QQ, WeChat, Feishu, DingTalk, Telegram, Discord, Slack  #### Бот для стримов: поддерживает развёртывание в один клик для Bilibili, YouTube, Twitch, а также 360-градусные панорамные трансляции.  #### AI-браузер: оснастите ваших AI-агентов собственным браузером с поддержкой автоматического управления  #### Система расширений: поддерживает установку и создание новых расширений. На изображении ниже показано расширение galgame. Все расширения можно открывать как в отдельном окне, так и на боковой панели. Вы также можете использовать навык агента [sap-extension-creator](skills/sap-extension-creator) для создания новых SAP-расширений, реализуя начальную загрузку агентной вечеринки!  #### Дружелюбность к разработчикам: предоставляет открытые API-интерфейсы OpenAI и MCP, позволяя подключать агентов извне  ## Быстрый старт ### Если вы CLI-агент CLI-агенту необходимо ознакомиться с документацией в [README_AGENT.md](https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md). Пожалуйста, используйте этот документ, чтобы помочь пользователям установить данное программное обеспечение! ### Если вы человек, использующий CLI-агента Отправьте эту ссылку вашему AI, и AI проведёт вас через процесс установки! ``` curl -fsSL https://raw.githubusercontent.com/heshengtao/super-agent-party/main/README_AGENT.md ``` ### Windows portable пакет (Рекомендуется! Версия без установки, поддержка одно-click синхронизации с последней версией репозитория, не нужно ждать сборки десктопной версии) 👉 [Скачать](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 Desktop Installation 👉 [Скачать](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 Integrated Package (В настоящее время поддерживает только M-чипы, версия без установки, поддержка одно-click синхронизации с последней версией репозитория, не нужно ждать сборки десктопной версии) > **Подходит для разработчиков/продвинутых пользователей**: версия без установки, поддержка одно-click синхронизации с последней версией репозитория, не нужно ждать сборки десктопной версии. 👉 [Скачать](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 Desktop (В настоящее время поддерживаются только M-чипы) 👉 [Скачать](https://github.com/heshengtao/super-agent-party/releases/download/v0.4.2/Super-Agent-Party-0.4.2-Mac.dmg) ⭐ Внимание! После загрузки перетащите приложение из dmg-файла в директорию `/Applications`, затем откройте Терминал, выполните следующую команду и введите root-пароль для снятия атрибута карантина: ```shell sudo xattr -dr com.apple.quarantine /Applications/Super-Agent-Party.app ``` ### Установка Linux Desktop `.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 Deployment (Эту версию десктопного питомца можно просматривать только через браузер) ```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 Deployment (Эту версию десктопного питомца можно просматривать только через браузер, также будет запущен дополнительный контейнер шлюза для управления входом) ```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 ### Lite клиент, превращающий 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) или напрямую просмотреть и установить их в вечеринке через 【Разработчик】→【Расширения】. Вы также можете добавить свои собственные расширения в официальный список плагинов на [super-agent-party.github.io](https://github.com/super-agent-party/super-agent-party.github.io)! ### Существующие расширения | Название | Автор | Описание | URL репозитория | |-----------------------|-------------------|--------------------------------------------------------------------|--------------------------------------------------| | 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 | Интерактивный плагин приключенческой истории, генерирующий сюжет и варианты с помощью AI. | https://github.com/heshengtao/sap-story-adventure | | Live 2D | heshengtao | Расширение Live 2D | https://github.com/heshengtao/sap-live2d | | AI Editor | heshengtao | AI-редактор | https://github.com/heshengtao/sap-aieditor | | AI galgame | heshengtao | Расширение AI galgame | https://github.com/heshengtao/sap-aigalgame | | AI tarot reader | heshengtao | Расширение AI таролога | https://github.com/heshengtao/sap-tarot | | AI sheet | heshengtao | Расширение AI таблиц | https://github.com/heshengtao/sap-ai-sheet | | AI drawio | heshengtao | Расширение AI drawio | https://github.com/heshengtao/sap-ai-drawio | | AI mermaid | heshengtao | Расширение редактора AI mermaid | https://github.com/heshengtao/sap-ai-mermaid | | AI RSS reader | heshengtao | Расширение AI RSS-ридера для Super Agent Party | https://github.com/heshengtao/sap-rss | | Remote | heshengtao | Одно-click публикация 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, позвольте AI-компаньону управлять воспроизведением музыки! | https://github.com/heshengtao/sap-lx-music | | AI PPT | heshengtao | AI PPT расширение для Super Agent Party | https://github.com/heshengtao/sap-ai-ppt | | Lyra 星莱 | heshengtao | Расширение персонажа Звёздный маг — одно-click установка карточки персонажа, THA-модели, стикеров и фона | https://github.com/heshengtao/sap-lyra-extension | ## Системные требования - CPU: 2 ядра или более - Память: 2 ГБ или более **Поскольку все модели являются опциональными, вы можете использовать локальный движок развёртывания или интерфейсы облачных провайдеров, поэтому аппаратные требования минимальны. Docker-версия была протестирована на 2-ядерном 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": "Что такое Super Agent Party?"} ] ) print(response.choices[0].message.content) ``` - MCP-вызов: после запуска вы можете вызвать локальный MCP-сервис, записав следующее содержимое в файл конфигурации: ```json { "mcpServers": { "super-agent-party": { "url": "http://127.0.0.1:3456/mcp", } } } ``` - Команды быстрого доступа: в поле ввода чата или в любой подключённой IM-платформе (Feishu, QQ, Telegram, Discord, Slack, WeChat, WeCom, DingTalk) введите указанные ниже команды для быстрого управления ассистентом. Вы можете включать/отключать их и просматривать полный список в **Настройки системы → Команды быстрого доступа**. | Команда | Псевдонимы | Область | Описание | | --- | --- | --- | --- | | `/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 | Переключиться в режим цели (автономный цикл) | | `/