Botgroup.chat：多个AI角色实时互动的群聊天应用

综合介绍

Botgroup.chat 是一个基于 React 和 Cloudflare Pages 开发的开源 AI 群聊应用，旨在为用户提供一个类似微信群聊的交互体验。它支持多个 AI 角色同时参与对话，用户可以通过简单的配置与多个智能机器人实时互动。该项目托管在 GitHub 上，由开发者 maojindao55 创建，允许用户免费一键部署到 Cloudflare Pages。无论是想体验多人 AI 聊天还是开发自定义聊天机器人，Botgroup.chat 都提供了灵活的解决方案，目前已有体验地址（https://botgroup.chat）供用户试用。

功能列表

• 多人 AI 群聊：支持多个 AI 角色同时参与对话，模拟真实群聊场景。
• 自定义 AI 角色：用户可定义角色的名称、性格、模型及头像，打造个性化智能体。
• 多种模型支持：兼容千问、混元、豆包等多种 AI 模型，满足不同需求。
• 一键部署：通过 Cloudflare Pages 实现快速部署，无需复杂配置。
• 实时互动：提供流畅的对话体验，适合娱乐、教育或测试场景。
• 开源代码：GitHub 上开放源代码，开发者可自由修改和扩展功能。

使用帮助

Botgroup.chat 是一个简单易用的 AI 群聊工具，用户可以通过访问现成的体验地址或自行部署来使用。以下是详细的操作指南，帮助你快速上手。

如何开始使用

方法一：直接体验

1. 打开浏览器，输入官方体验地址：https://botgroup.chat。
2. 进入页面后，你会看到一个聊天界面，默认已配置多个 AI 角色。
3. 在输入框中输入文字，点击发送，即可与多个 AI 角色互动。
4. 若需调整角色或设置，可查看页面提示或直接参考 GitHub 项目文档。

方法二：自行部署

如果想拥有自己的 Botgroup.chat 实例，可以通过以下步骤完成部署：

1. 准备工作
   • 确保你有一个 GitHub 账号和 Cloudflare 账号。
   • 安装 Git 用于本地克隆代码（可选）。
2. 获取代码
   • 访问 GitHub 项目地址：https://github.com/maojindao55/botgroup.chat。
   • 点击右上角的“Fork”按钮，将项目复制到你的 GitHub 仓库。
   • 或者直接点击“Code”按钮，下载 ZIP 文件到本地解压。
3. 配置环境变量
   • 在项目根目录找到 README.md 文件，查看环境变量配置说明。
   • 创建 .env 文件，填入必要的 API Key，例如：

     DASHSCOPE_API_KEY=xxx  # 千问模型密钥
     HUNYUAN_API_KEY=xxx    # 混元模型密钥
     ARK_API_KEY=xxx        # 豆包模型密钥
     

   • 根据需求选择支持的模型（qwen-plus、deepseek-v3 等），并填入对应的 API 密钥和 baseURL。
4. 部署到 Cloudflare Pages
   • 登录 Cloudflare 账号，进入“Pages”选项卡。
   • 点击“Create a project”，选择“Connect to Git”。
   • 链接你 Fork 的 GitHub 仓库，点击“Begin setup”。
   • 在“Build settings”中，选择框架为“React”，构建命令为 npm run build，输出目录为 dist。
   • 添加上一步的环境变量，点击“Save and Deploy”。
   • 部署完成后，Cloudflare 会提供一个访问 URL（如 https://your-project.pages.dev）。
5. 验证部署
   • 访问部署后的 URL，检查是否正常加载聊天界面。
   • 输入消息测试 AI 响应，确保模型调用正常。

主要功能操作流程

1. 创建和管理 AI 角色

• 操作步骤：
  1. 打开项目配置文件（通常在 src/config 文件夹内，例如 roles.json）。
  2. 添加新角色，格式如下：

     {
     "id": "role1",
     "name": "小智",
     "personality": "幽默风趣，喜欢讲笑话",
     "model": "qwen-plus",
     "avatar": "https://example.com/avatar1.png",
     "custom_prompt": "请用轻松的语气回答问题"
     }
     

  3. 保存后重新部署，刷新页面即可看到新角色。
• 注意事项：
  • 确保 model 值与环境变量中的模型配置一致。
  • 头像 URL 可选，若不填则使用默认头像。

2. 与 AI 群聊互动

• 操作步骤：
  1. 在聊天界面输入问题或指令，例如：“大家好，今天天气如何？”
  2. 点击发送后，所有配置的 AI 角色会根据各自的性格和模型依次回复。
  3. 可连续对话，观察不同角色的响应风格。
• 特色用法：
  • 输入复杂问题（如“你们觉得未来科技会如何发展？”），体验多角色协作回答。
  • 测试不同模型的回答差异，例如千问的严谨性与混元的创意性。

3. 切换 AI 模型

• 操作步骤：
  1. 修改环境变量中的 API Key 和 baseURL，例如将模型切换为豆包：

     ARK_API_KEY=xxx
     BASE_URL=https://豆包API地址
     

  2. 在角色配置中更新 model 值，例如 "model": "doubao-pro"。
  3. 重新部署项目，刷新页面后生效。
• 提示：
  • 不同模型可能需要特定的 API 格式，参考各模型的官方文档。

常见问题与解决

• 问题：AI 不回复或报错
  • 解决：检查 API Key 是否正确，网络是否连接正常，模型是否支持实时调用。
• 问题：部署失败
  • 解决：查看 Cloudflare 的构建日志，确保依赖安装无误（运行 npm install 检查）。
• 问题：界面加载缓慢
  • 解决：确认服务器区域设置，选择靠近用户的 Cloudflare CDN 节点。

通过以上步骤，你可以轻松使用 Botgroup.chat，无论是体验现成版本还是定制专属群聊工具，都能满足需求。