record

飞书聊天记录机器人

📝 项目简介

监听并记录飞书平台的聊天消息，将数据持久化存储到数据库中，支持后续的消息存档、数据分析、内容总结等应用场景。

✨ 功能特性

• 🎯 实时监听 - 监听飞书群组和私聊消息
• 💾 持久化存储 - 将聊天记录存储到数据库
• 📊 数据分析 - 支持对历史消息进行统计分析
• 🔍 内容检索 - 便于后续查询和检索历史记录
• 📋 消息存档 - 满足合规性和审计需求

🏗️ 技术架构

• 消息监听 - 基于飞书开放平台事件订阅机制
• 数据存储 - 使用 PostgreSQL 关系型数据库
• 消息处理 - 异步处理机制，确保高并发场景下的稳定性

🚀 快速开始

前置要求

• Python 3.8+
• 飞书开放平台应用凭证
• PostgreSQL 数据库

安装依赖

pip install -r requirements.txt

配置说明

1. 复制配置文件模板

cp config.example.yaml config.yaml

2. 配置飞书应用信息

feishu:
  app_id: "your_app_id"
  app_secret: "your_app_secret"
  verification_token: "your_verification_token"
  encrypt_key: "your_encrypt_key"

3. 配置数据库连接

database:
  host: "localhost"
  port: 5432
  username: "your_username"
  password: "your_password"
  database: "feishu_records"

运行

python main.py

📦 数据存储结构

消息表 (messages)

字段名	类型	说明
id	String	消息唯一标识
chat_id	String	会话ID
sender_id	String	发送者ID
content	Text	消息内容
msg_type	String	消息类型（text/image/file等）
timestamp	DateTime	发送时间
created_at	DateTime	记录创建时间

⚠️ 注意事项

• 请确保已在飞书开放平台配置事件订阅回调地址
• 需要为应用开通相应的消息接收权限
• 注意遵守数据隐私和安全相关法律法规
• 建议定期备份数据库
• 生产环境请配置适当的消息过滤和敏感信息脱敏机制

📄 许可证

详见项目根目录 LICENSE 文件

🤝 贡献

欢迎提交 Issue 和 Pull Request

📞 联系方式

如有问题或建议，请通过 Issue 反馈