AI 多人聊天室

项目简介

一个基于 React和 Cloudflare Pages(免费一键部署) 的多人 AI 聊天应用,支持多个 AI 角色同时参与对话,提供类似群聊的交互体验。体验地址:https://botgroup.chat

功能特点

  • 🤖 支持多个 AI 角色同时对话

  • 💬 实时流式响应

  • 🎭 可自定义 AI 角色和个性

  • 👥 群组管理功能

  • 🔇 AI 角色禁言功能

  • 📝 支持 Markdown 格式

  • ➗ 支持数学公式显示(KaTeX)

  • 🎨 美观的 UI 界面

  • 📱 响应式设计,支持移动端


演示截图

一键部署到cloudflare

  1. Fork本项目到你的 GitHub 账号

  2. 登录 Cloudflare Dashboard

    1. 进入 Workers & Pages 页面

    2. 点击 “Create a application > Pages” 按钮

    3. 选择 “Connect to Git”

  3. 配置部署选项

    • Framework preset: None

    • Build command: npm run build

    • Build output directory: dist

    • 设置环境变量(必须):

    • DASHSCOPE_API_KEY=xxx //千问模型KEY
       HUNYUAN_API_KEY=xxx //混元模型KEY
       ARK_API_KEY=xxx //豆包模型KEY

    1. 选择你 fork 的仓库

    2. 设置以下构建配置:

  4. 点击 “Save and Deploy”

    1. Cloudflare Pages 会自动构建和部署你的应用

    2. 完成后可通过分配的域名访问应用

注意:首次部署后,后续的代码更新会自动触发重新部署。

自定义(可选)

  1. 配置 模型和AI 角色

    1. 在 config/aiCharacters.ts 中

    2. 自定义模型

{    model: string;     // 模型标识, 请按照服务方实际模型名称配置(注意:豆包的配置需要填写火山引擎接入点),比如qwen-plus,deepseek-v3,hunyuan-standard    apiKey: string;    // 模型的 API 密钥    baseURL: string;    // 模型的 baseURL}

配置 AI 角色信息

id: string;        // 角色唯一标识name: string;      // 角色显示名称personality: string// 角色性格描述model: string;     // 使用的模型,要从modelConfigs中选择avatar?: string;   // 可选的头像 URLcustom_prompt?: string;  // 可选的自定义提示词
示例配置:```typescript{id"assistant1",name: "小助手",personality: "友善、乐于助人的AI助手",model: "qwen",//注意豆包的配置需要填写火山引擎的接入点avatar: "/avatars/assistant.png",custom_prompt: "你是一个热心的助手,擅长解答各类问题。"}```

配置群组

  • 在 config/groups.ts 中配置群组信息
id: string;        // 群组唯一标识name: string;      // 群组名称description: string// 群组描述members: string[]; // 群组成员ID数组

示例配置:

{  id"group1",  name: "AI交流群",  description: "AI角色们的日常交流群",  members: ["ai1""ai2""ai3"] // 成员ID需要与 aiCharacters.ts 中的id对应}


  1. 注意事项:

    • members 数组中的成员 ID 必须在 aiCharacters.ts 中已定义
    • 每个群组必须至少包含两个成员
    • 群组 ID 在系统中必须唯一


本地环境启动/调试

由于本项目后端server使用的是Cloudflare-Pages-Function(本质是worker)

  1. 所以本地部署需要 安装 wrangler:

    npm install wrangler --save-dev

  2. 使用本项目启动脚本启动

    sh devrun.sh 本地默认预览地址是:http://127.0.0.1:8788



项目链接

https://github.com/maojindao55/botgroup.chat

扫码加入技术交流群,备注开发语言-城市-昵称

(文:GitHubStore)

欢迎分享

发表评论