Skip to content

一个强大的飞书开放平台API集成工具,完整集成FastGPT AI平台,支持飞书知识库全格式自动同步,支持集成飞书机器人(完美支持思考模式、流式输出、引用下载、图片渲染)

Notifications You must be signed in to change notification settings

answerlink/feishu_fastgpt

Repository files navigation

Feishu FastGPT

GitHub stars GitHub forks GitHub issues GitHub license Python Version

🚀 基于飞书开放平台和FastGPT的企业级智能知识管理系统

功能特性快速开始配置文档部署指南贡献指南


📋 项目简介

Feishu FastGPT 是一个企业级的智能知识管理系统,深度集成飞书开放平台和FastGPT,为企业提供智能化的知识管理和问答服务。

核心能力

  • 🤖 智能机器人问答:在飞书中直接与AI助手对话,获得基于企业知识库的精准答案
  • 📚 知识库同步:自动同步飞书云文档、多维表格等内容到FastGPT知识库
  • 🖥️ Web管理界面:提供可视化的管理界面,支持配置管理、状态监控
  • 多进程架构:支持多应用并发处理,高性能稳定运行
  • 🔄 实时同步:支持文档变更的实时同步和批量导入

✨ 功能特性

🤖 飞书机器人问答

  • 智能对话:支持私聊和群聊中的AI问答
  • 上下文理解:维持对话上下文,提供连贯的交互体验
  • 多媒体支持:支持文本、图片等多种消息类型
  • 权限控制:精细化的用户和群组权限管理

📚 知识库管理

  • 多格式支持:飞书云文档(docx)、多维表格(sheet)、思维导图等
  • 智能处理:自动提取图片并生成描述,优化知识库内容
  • 增量同步:智能识别变更内容,支持增量更新
  • 批量导入:支持整个知识空间的批量同步

🖥️ Web管理界面

  • 应用管理:可视化管理多个飞书应用配置
  • 状态监控:实时监控系统运行状态和同步进度
  • 日志查看:集中查看系统日志和错误信息
  • 用户友好:基于Vue 3和Element Plus的现代化界面

⚡ 技术架构

  • FastAPI后端:高性能异步Web框架
  • Vue 3前端:现代化的前端用户界面
  • 多进程支持:支持多应用实例并发运行
  • 数据库集成:MySQL数据库存储配置和状态

🚀 快速开始

环境要求

  • Python 3.8+
  • MySQL 5.7/8.0+
  • Node.js 16+
  • 飞书开发者账号
  • FastGPT服务实例

1. 克隆项目

git clone https://github.com/answerlink/feishu_fastgpt
cd feishu_fastgpt

2. 安装后端依赖

pip install -r requirements.txt

3. 数据库配置

CREATE DATABASE feishu_plus DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

注:只须建库,表自动创建,支持 MySQL 5.7/8.0

4. 配置应用

# 复制配置文件
cp config/config.example.json config/config.json

# 编辑配置文件,填入您的配置信息
vim config/config.json

5. 构建前端

# 安装前端依赖并构建
cd web
npm install
npm run build
cd ..

6. 启动服务

# 启动主服务
python feishu_plus_app.py

# 或使用脚本启动多进程服务
./start.sh

7. 访问管理界面

启动服务后,打开浏览器访问:

📖 配置文档

🤖 飞书机器人配置

详细的飞书机器人配置步骤请参考:飞书机器人配置指南

  • 创建飞书应用
  • 权限配置
  • 事件回调设置
  • 版本发布

📚 知识库同步配置

详细的知识库同步配置请参考:知识库同步指南

  • 权限配置
  • 同步策略
  • 最佳实践

⚙️ 配置文件说明

{
    "APP_NAME": "feishu-plus",                // 应用名称
    "DEBUG": true,                            // 调试模式
    "DB_HOST": "localhost",                   // 数据库地址
    "DB_PORT": 3306,                         // 数据库端口
    "DB_USER": "root",                       // 数据库用户
    "DB_PASSWORD": "password",               // 数据库密码
    "DB_NAME": "feishu_plus",               // 数据库名
    "FEISHU_APPS": [                        // 飞书应用配置列表
        {
            "app_id": "cli_xxx",            // 应用ID
            "app_secret": "xxx",            // 应用密钥
            "fastgpt_url": "http://localhost:3000", // FastGPT地址
            "fastgpt_key": "fastgpt-xxx",   // FastGPT密钥
            "aichat_enable": true,          // 启用AI聊天
            "dataset_sync": true            // 启用知识库同步
        }
    ]
}

🏗️ 项目结构

feishu_fastgpt/
├── app/                   # 后端应用
│   ├── api/               # API路由
│   ├── core/              # 核心配置
│   ├── db/                # 数据库
│   ├── models/            # 数据模型
│   ├── schemas/           # 数据模式
│   ├── services/          # 业务逻辑
│   └── utils/             # 工具函数
├── web/                   # 前端界面
│   ├── src/               # 源代码
│   │   ├── components/    # 组件
│   │   ├── views/         # 页面
│   │   └── api/           # API调用
│   ├── dist/              # 构建输出目录
│   └── public/            # 静态资源
├── config/                # 配置文件
├── docs/                  # 文档
├── logs/                  # 日志
├── temp/                  # 临时文件
├── feishu_plus_app.py     # 主程序入口
├── single_app_worker.py   # 单应用工作进程
├── start.sh               # 启动脚本
└── requirements.txt       # Python依赖

🚀 部署指南

生产环境部署

# 使用gunicorn部署
pip install gunicorn
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000

# 使用nginx反向代理
# 配置nginx.conf
upstream feishu_fastgpt {
    server 127.0.0.1:8000;
}

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://feishu_fastgpt;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

进程管理

项目提供了多进程管理脚本:

# 启动所有应用
./start.sh

# 查看进程状态
ps aux | grep "feishu"

# 停止所有进程(可以kill 不要使用kill -9)
pkill -f "python.*feishu"

🤝 贡献指南

我们欢迎所有形式的贡献!请查看 贡献指南 了解详情。

📝 更新日志

查看 CHANGELOG.md 了解版本更新历史。

最新版本 v2.1.0

  • ✨ 支持飞书机器人智能问答
  • 📚 知识库自动同步功能
  • 🖥️ Web管理界面
  • ⚡ 多进程架构支持

📄 许可证

本项目基于 MIT License 开源协议。

🙏 致谢

📞 支持与反馈


如果这个项目对您有帮助,请给我们一个 ⭐️ Star!

Made with ❤️ by AnswerLink Team

About

一个强大的飞书开放平台API集成工具,完整集成FastGPT AI平台,支持飞书知识库全格式自动同步,支持集成飞书机器人(完美支持思考模式、流式输出、引用下载、图片渲染)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages