# FBSir

**Repository Path**: U3W-AI/FBSir

## Basic Information

- **Project Name**: FBSir
- **Description**: 以AI赋能微信运营，帮助团队高效运营公众号、社群、企业微信等流量矩阵，提升企业获客及用户价值转化能力。福帮手FBSir，福润百业，智生万象。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://fbsir.u3w.com/
- **GVP Project**: No

## Statistics

- **Stars**: 31
- **Forks**: 29
- **Created**: 2025-08-19
- **Last Updated**: 2025-09-06

## Categories & Tags

**Categories**: weixin-app

**Tags**: None

## README

<p align="center"><img alt="Static Badge" src="https://img.shields.io/badge/MySQL-5.7-blue"> <img alt="Static Badge" src="https://img.shields.io/badge/JDK-17-blue"> <img alt="Static Badge" src="https://img.shields.io/badge/Spring%20Boot-3.2.5-blue"> <img alt="Static Badge" src="https://img.shields.io/badge/Redis-6.0%2B-blue"> <img alt="Static Badge" src="https://img.shields.io/badge/License-AGPL3.0-blue"></p>

# 福帮手FBSir：智能原生时代的微信私域运营助手
![输入图片说明](docs-img/%E5%AF%B9%E8%AF%9D%E9%9A%90%E5%BD%A2%E5%86%A0%E5%86%9B.jpeg)

版本：0.15A2

文档更新日期：2025年9月5日

福帮手FBSir，福润百业，智生万象。福帮手是基于U3W优立方AI主机的解决方案，以MCP打通AI主机与工作流智能体的联系，实现AI赋能微信运营，帮助团队高效运营公众号、社群、企业微信等流量矩阵，提升企业获客及用户价值转化能力。

## 最近更新

2025年9月5日：DeepSeek及百度AI的MCP 服务上架，目前支持元宝、豆包、百度 AI、DeepSeek的MCP服务，并提供公众号通过元器工作流调用以上MCP服务进行对话的实例。

2025年9月1日：升级公众号MCP服务，新增图片生成等能力。

## 项目结构

```
U3W-AI/
├── common_deployment_guide.md  [公共环境部署指南](common_deployment_guide.md)
├── cube-mini/            # 优立方AI主机控制台小程序端
├── cube-admin/           # 优立方AI主机控制台后端
├── cube-ui/              # 优立方AI主机控制台前端
├── cube-engine/          # 福帮手@优立方AI主机核心服务
├── cube-common/          # 公共工具模块
├── cube-framework/       # 框架核心模块
├── sql/                  # 数据库脚本
└── README.md             # 项目说明文档
```
### 部署文档

**推荐使用：** [🚀 福帮手FBSir 完整部署说明](complete_deployment_guide.md) - **全流程一站式部署指南**


## 快速开始

以下是快速部署和运行福帮手FBSir的步骤。如需详细了解各模块的部署过程，请参考各模块的部署指南。

### 前置要求
- JDK 17
- Maven
- Node.js 16.x/18.x 和 npm 8.x+
- MySQL 5.7+ 和 Redis 6.0+
- Windows 10系统及以上（建议内存16GB）

### 环境准备
1. 安装 JDK 17、Maven、Node.js、MySQL 和 Redis
2. 克隆项目仓库到本地

## 配置

### 数据库配置
1. 创建MySQL数据库：
   ```bash
   mysql -u root -p
   CREATE DATABASE IF NOT EXISTS ucube DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   ```

2. 导入SQL文件：
   ```bash
   mysql -u root -p ucube < sql/ucube.sql
   ```

3. 添加主机ID到白名单表：
   ```bash
   mysql -u root -p ucube
   INSERT INTO sys_host_whitelist (host_id) VALUES ('你的主机ID');  #主机ID建议使用字母+数字组合，例如user01
   ```

### 后端配置
1. 修改 cube-admin 模块的数据库配置（application-druid.yml）：
   ```yaml
   spring:
       datasource:
           druid:
               master:
                   url: jdbc:mysql://[数据库IP]:[端口]/ucube?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8&allowMultiQueries=true
                   username: [数据库用户名]
                   password: [数据库密码]
   ```

2. 修改 cube-admin 模块的Redis配置（application.yml）：
   ```yaml
   spring:
       redis:
           host: [Redis IP]
           port: [Redis端口]
           password: [Redis密码]
   ```

3. 修改应用配置（application.yml）：
   编辑 `src/main/resources/application.yml` 文件，更新文件上传配置：
   ```yaml
   profile: F:/AGI/chatfile #此处可以是电脑上的任意文件夹
   upload:
   #上传文件路径
       url: http://localhost:8081/profile/
   ```
   > 注意：端口默认为8081，如已修改请使用实际端口

4. 修改文件上传路径配置：
   编辑 `../cube-common/src/main/java/com/cube/common/config/RuoYiConfig.java` 文件最底部，更新上传路径：
   ```java
    public static String getUploadPath()
    {
        return "F:/AGI/chatfile";
    }
   ```
5. 修改日志上传路径配置：
   编辑 `src/main/resources/logback.xml` 文件最底部，更新上传路径：
   ```xml
    <!-- 日志存放路径 -->
	<property name="log.path" value="/你的日志存放路径" />

6. 配置 cube-engine 模块的主机ID和数据目录`../cube-engine/src/main/resources/application.yaml`文件 **（MCP相关配置见[部署文档](cube-engine/deployment_guide.md)）**：
   ```yaml
   cube:
     url: http://127.0.0.1:8081/aigc
     wssurl: ws://127.0.0.1:8081/websocket?clientId=play-您的主机ID  #主机ID建议使用字母+数字组合，例如user01，并在数据库sys_host_whitelist中配置主机id
     datadir: F:\AGI\user-data-dir  # 数据目录，建议单独文件夹存放
     uploadurl: http://127.0.0.1:8081/common/upload
   ```

## 运行

### 启动后端服务
1. 在项目根目录安装所有依赖：
   ```bash
   mvn clean install
   ```

2. 打包启动 cube-admin 服务：
   ```bash
   cd cube-admin
   mvn clean package -DskipTests
   java -jar target/cube-admin.jar
   ```

3. 打包启动 cube-engine 服务：
   ```bash
   cd ../cube-engine
   mvn clean package -DskipTests
   java -jar target/U3W.jar
   ```

### 启动前端服务
1. 进入 cube-ui 目录：
   ```bash
   cd ../cube-ui
   ```

2. 安装前端依赖：
   ```bash
   npm install --legacy-peer-deps
   ```

3. 启动前端开发服务器：
   ```bash
   npm run dev
   ```

### 首次登录
- 启动成功后，浏览器会自动打开后台页面
- 账密登录入口为loginpwd
- 账号：admin
- 密码：admin123

### 主机绑定
- 登录后台后，点击右上角名称→个人中心
- 在基本资料的主机ID输入框中填写 `wssurl` 配置项的 `<主机ID>` 部分

### 验证运行
- 登录后台后，点击登录各个AI，成功返回二维码截图并进行登录。
- 登录完成后，点击左侧内容管理→主机，发送提示词，后台成功返回运行截图、结果后，为cube-ui、cube-admin、cube-engine部分部署完成。
- 参考[部署文档](cube-engine/deployment_guide.md)完成元器工作流相关配置后，发布对话智能体并咨询相关问题，发送以"1"开头的问题（确保意图准确识别）来测试整个系统是否正常工作，如果正常，系统将返回相应的回复链接，以确认部署正常完成。

The end