加入派对：Super Agent Party的社区支持、贡献指南与未来路线图-二趣网

加入派对：Super Agent Party的社区支持、贡献指南与未来路线图

【免费下载链接】super-agent-party⭐全能型AI伴侣！AI桌面女友 + AI虚拟主播 + AI即时通讯机器人 + AI浏览器 + AI智能家居 + AI游戏等你能想到的一切功能！项目地址: https://gitcode.com/heshengtao/super-agent-party

Super Agent Party 是一款全能型 AI 伴侣，集 AI 桌面女友、AI 虚拟主播、AI 即时通讯机器人、AI 浏览器、AI 智能家居与 AI 游戏于一身。本文是它的社区支持入口、贡献指南与未来路线图，无论你只是想遇到问题时找人帮忙，还是想贡献代码、开发自己的扩展，都可以在这里快速上手。

一、为什么值得加入这场派对

Super Agent Party 不是一个"装完就结束"的工具，而是一个持续生长的平台：桌面伴侣、任务中心、IM 机器人、直播机器人、AI 浏览器、扩展系统……几乎每个模块都开放给社区参与。你提出的想法、写的小扩展，都可能出现在下一个版本的官方扩展列表里。

二、如何加入社区：快速找到组织

项目维护了多个官方支持渠道，遇到问题时建议先搜后问，能更快获得解答：

渠道	说明
QQ 群（2群）	群号`902882342`（1群`931057213`已满），中文用户的首选交流地
Discord	面向国际用户的英文社区，可在 README 中获取入群入口
官方使用指南	中文飞书文档 + 英文 Notion 文档，覆盖各功能的使用细节
B站 / YouTube	官方教程视频频道，跟着视频一步步上手
官方扩展列表	浏览器端插件市场，可在应用内【开发者】→【扩展】直接查看和安装

📌提问小技巧：把操作系统、安装方式（整合包 / 桌面版 / Docker）、已尝试的步骤一起贴出来，维护者复现问题会快得多。

三、贡献指南：从环境搭建到提交代码

1. 五分钟搭建源码开发环境

项目前端基于 Electron，后端是 Python 服务，用uv管理依赖。克隆仓库后三条命令即可跑起来：

git clone https://gitcode.com/heshengtao/super-agent-party cd super-agent-party uv sync npm install npm run dev

⭐ 依赖必须用uv sync而不是pip install，以和官方版本保持完全一致（README_AGENT.md 中有说明）。

更省事的方式是仓库自带的开发脚本，直接双击或执行即可启动开发模式：

开发启动脚本：start_with_dev.sh、start_with_dev.bat
Steam 环境版本：start_with_dev_steam.sh
Docker 用户可参考：Dockerfile、docker-compose.yml

2. 贡献者许可协议（CLA）要点

CONTRIBUTING.md 是一份贡献者许可协议，提交代码前建议花两分钟了解这 4 点：

授权范围：你的贡献授予项目方永久、全球、免版税的版权与专利许可；
商用条款：贡献可能被用于项目的商业运营及未来商业版本；
双重许可：项目默认遵循AGPLv3，同时保留商业授权模式（完整协议见 LICENSE）；
即视为接受：提交 Pull Request 即表示你已接受该协议，最终是否合并由维护者决定。

有授权或商业合作问题，可联系维护者：hst97@qq.com。

3. 项目结构速览：改代码前先认识地图

目录 / 文件	职责
py/	Python 后端：IM/直播机器人管理（qq_bot_manager.py、live_router.py）、MCP 客户端、工具链等
static/js/	前端核心：renderer.js 渲染逻辑、locales/ 多语言资源
skills/	内置 Agent Skills：扩展创建、技能创建、办公 CLI
config/	设置模板 settings_template.json、语言包 locales.json
vrm/	VRM 模型、动画与 3D 场景资源
LICENSE-third-party/	第三方组件的许可证声明

项目支持 10 种语言的 README（简体中文、English、日本語、한국어 等），补充或修正翻译文档也是很好的新手贡献切入点。

四、写你的第一个扩展：用 AI 快速完成

Super Agent Party 的扩展分两种：

静态扩展：纯 HTML/CSS/JS 前端，适合聊天界面、展示类小工具；
Node.js 扩展：带 Express 后端，适合需要接口调用、文件处理的场景。

好消息是：你几乎不用手写模板。内置的 sap-extension-creator 技能可以引导你完成从需求、骨架到 MCP 工具注册的全流程，它附带了两套开箱即用的模板：

静态模板：skills/sap-extension-creator/assets/static-template/
Node.js 模板：skills/sap-extension-creator/assets/node-template/

扩展的规范细节都写在技能参考文档里，例如字段定义见 package-json-spec.md。完成后在【开发者】→【扩展】中安装到你的派对里测试，再把扩展添加到官方扩展列表——官方目前已有 18 个扩展（AI 编辑器、AI 表格、Live2D、AI PPT、远程访问等），每一个都是从社区开始的。

想给 AI 写"专业技能"（Skills）而非扩展？参考 skills/skill-creator/SKILL.md 的技能创建工作流即可。

五、未来路线图：下一站支持什么

从官方 README 的功能矩阵中，可以读出这几条明确的演进方向：

方向	现状	规划
消息平台机器人	已支持 QQ、微信、飞书、钉钉、Telegram、Discord、Slack	后续接入更多平台
直播机器人	已支持 B站、YouTube、Twitch，含 360° 全景直播	后续接入更多平台
播报机器人	长文播报、多音色、EPUB 解析	后续开发分章节转录
扩展生态	18 个官方扩展 + 扩展创建器	社区扩展持续扩充
开发者接口	OpenAI 兼容 API + MCP 双通道	面向第三方智能体持续开放

💡 路线图不是固定承诺，社区的高票讨论会直接影响优先级——这也是加入 QQ 群 / Discord 的最大价值。

六、常见问题 FAQ

问题	解答
安装失败 / 找不到最新下载地址	看 README_ZH.md「快速开始」，或让 CLI Agent 读取 README_AGENT.md 引导安装
硬件要求高吗	不高：2 核 CPU + 2GB 内存即可，模型均可选配云服务
数据会上传吗	不会，Docker 数据默认缓存在本地文件夹
可以商用吗	默认 AGPLv3；闭源商用需商业授权，联系 hst97@qq.com
扩展开发卡住了	先读 sap-extension-creator，再到群里问

写在最后

给项目点个 Star 就是最直接的鼓励。无论你是想找个答疑组织的新手，还是准备提交第一个 PR 的开发者，Super Agent Party 的派对都为你留了位置——打开 QQ 群902882342或 Discord，说一句"我来啦"，就是加入的第一步。🎉

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析