飞书智能助手 (Feishu Copilot)

倍司网络科技飞书智能助手 - 打造高效的企业协作生态

📖 项目简介

Feishu Copilot 是一套完整的飞书智能助手解决方案，通过多个功能模块将飞书与各类外部服务深度集成，提升团队协作效率。项目包含聊天记录归档、邮件转发、GitHub 项目管理、AI 对话等多个实用功能。

✨ 核心功能模块

🤖 AI 智能对话

基于 OpenAI GPT 模型的智能对话机器人，支持：

• 自然语言对话交互
• 群聊和私聊模式
• 图片生成功能
• 可自定义对话人设

📝 聊天记录归档

监听并记录飞书聊天消息，实现数据持久化：

• 实时监听群组和私聊消息
• PostgreSQL 数据库存储
• 支持历史消息检索
• 便于数据分析和审计

📧 邮箱转发助手

将邮箱收到的邮件自动转发到飞书群聊：

• 支持 IMAP 协议的主流邮箱
• 智能过滤和规则配置
• 附件自动上传
• 富文本卡片展示

🔧 GitHub 项目管理

飞书与 GitHub 的无缝集成：

• 通过飞书指令管理 GitHub Issues
• 实时同步 GitHub 事件通知
• 项目进度追踪和统计
• Pull Request 审查提醒

📊 消息总结分析

基于聊天记录的智能分析（规划中）：

• 会话内容智能总结
• 关键信息提取
• 话题趋势分析

🚀 快速开始

环境要求

• Python 3.8+
• PostgreSQL 12+
• 飞书开放平台应用（申请地址）

安装步骤

1. 克隆项目

git clone https://github.com/your-org/feishu-copilot.git
cd feishu-copilot

2. 安装依赖

pip install -r requirements.txt

3. 配置数据库

# 创建数据库
createdb feishu_copilot

# 运行数据库迁移
python scripts/init_db.py

4. 配置应用

# 复制配置模板
cp config.example.yaml config.yaml

# 编辑配置文件，填入你的飞书应用信息
vim config.yaml

5. 启动服务

根据需要启动不同的模块：

# 启动聊天记录模块
python bot/record/main.py

# 启动邮件转发模块
python bot/email/main.py

# 启动 GitHub 管理模块
python bot/github/main.py

# 使用 Docker 启动 AI 对话模块
cd bot/chat
docker-compose up -d

📚 文档导航

• 架构设计 - 系统架构和技术选型
• 部署指南 - 生产环境部署指南
• 开发指南 - 开发规范和贡献指南
• 配置说明 - 详细配置参数说明
• API 文档 - API 接口文档
• 常见问题 - 常见问题解答

各模块详细文档

• AI 智能对话文档
• 聊天记录归档文档
• 邮箱转发助手文档
• GitHub 项目管理文档

🏗️ 技术架构

┌─────────────────────────────────────────────────────────┐
│                      飞书开放平台                          │
└─────────────────────────────────────────────────────────┘
                            │
                            ├─────────────────┬─────────────────┬──────────────┐
                            │                 │                 │              │
                    ┌───────▼────────┐ ┌─────▼──────┐ ┌────────▼───────┐ ┌───▼──────┐
                    │  AI 对话模块    │ │ 记录模块    │ │  邮件模块      │ │GitHub模块│
                    │  (chatgpt-on-  │ │ (record)   │ │  (email)      │ │ (github) │
                    │   wechat)      │ │            │ │               │ │          │
                    └────────────────┘ └─────┬──────┘ └───────┬───────┘ └────┬─────┘
                                             │                │                │
                                             │                │                │
                    ┌────────────────────────▼────────────────▼────────────────▼─────┐
                    │                    PostgreSQL 数据库                            │
                    └─────────────────────────────────────────────────────────────────┘

🛠️ 技术栈

• 后端框架: Python / Flask
• 数据库: PostgreSQL
• 消息队列: Redis (可选)
• 容器化: Docker / Docker Compose
• API 集成:
  • 飞书开放平台 API
  • OpenAI API
  • GitHub API
  • IMAP 邮件协议

📦 项目结构

feishu-copilot/
├── bot/                    # 机器人模块
│   ├── chat/              # AI 对话模块
│   ├── email/             # 邮件转发模块
│   ├── github/            # GitHub 管理模块
│   ├── record/            # 聊天记录模块
│   └── summary/           # 消息总结模块
├── docs/                  # 项目文档
├── scripts/               # 工具脚本
├── config.example.yaml    # 配置文件模板
├── requirements.txt       # Python 依赖
└── README.md             # 项目说明

🔧 配置说明

飞书应用配置

1. 登录 飞书开放平台
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 配置事件订阅和权限
5. 将凭证填入 config.yaml

详细配置说明请参考 配置文档

🤝 贡献指南

我们欢迎所有形式的贡献，包括但不限于：

• 🐛 提交 Bug 报告
• 💡 提出新功能建议
• 📝 改进文档
• 🔧 提交代码修复
• ⭐ Star 项目支持我们

请查看 开发指南 了解如何参与贡献。

📄 开源协议

本项目采用 MIT 协议开源，详见 LICENSE 文件。

🙏 致谢

• 飞书开放平台 - 提供强大的 API 支持
• chatgpt-on-wechat - AI 对话模块基础
• PostgreSQL - 可靠的数据存储
• 所有贡献者和使用者

📞 联系我们

• 📧 邮箱: [email protected]
• 💬 飞书群: [加入我们]
• 🐛 问题反馈: GitHub Issues

⭐ Star History

如果这个项目对你有帮助，请给我们一个 Star ⭐️

---

Made with ❤️ by 倍司网络科技