# chd-welcomebot

**Repository Path**: techchu/chd-welcomebot

## Basic Information

- **Project Name**: chd-welcomebot
- **Description**: 长安大学迎新群QQ机器人
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-26
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# CHD WelcomeBot

## 项目简介
CHD WelcomeBot 是一个功能丰富的智能迎新机器人系统，专为高校迎新场景设计。系统集成了图像管理、用户权限控制、关键词匹配、二维码生成、文件过期管理、Fortune 抽奖等多种功能模块，适用于自动化迎新服务场景。

## 功能特性
- **图像管理**
  - 支持本地图像存储与访问
  - 提供图像链接生成与过期控制
  - 支持七牛云图像上传与下载
- **用户权限管理**
  - 支持用户注册、角色分配
  - 控制用户每日使用次数
- **关键词与语义匹配**
  - 支持关键词的模糊匹配和语义匹配
  - 支持关键词与响应的绑定
- **二维码生成与解析**
  - 支持生成带有效期的二维码
  - 支持二维码内容解析
- **Fortunedrawer 求签系统**
  - 从预定义的JSON数据中抽签
  - 支持按类型展示签的内容
- **文件过期管理**
  - 管理上传到QQ的文件的有效期
  - 支持清理过期文件

## 技术架构
本项目采用模块化设计，主要模块包括：
- `database.py`: 关键词数据库管理
- `user_database.py`: 用户数据库管理
- `filemanager.py`: 文件管理器，处理文件生命周期
- `generate_qr.py`: 二维码生成与解析模块
- `qiniusdk.py`: 七牛云SDK，用于图像存储与访问
- `wordmanager.py`: 关键词匹配引擎，支持多种匹配策略
- `fortunedrawer.py`: 抽签逻辑处理模块
- `app.py`: 后台网页主应用逻辑
- `test.py`: 聊天机器人核心逻辑

## 安装与部署
1. 克隆项目
   ```bash
   git clone https://gitee.com/techchu/chd-welcomebot
   ```
2. 配置数据库
   - 确保 `dbs` 目录存在
   - 初始化数据库文件 `keyword_database.db` 和 `user_database.db`
3. 配置七牛云参数（如需要）
   - 修改 `qiniusdk.py` 中的 `access_key` 和 `secret_key`
4. 启动后台和机器人服务
   ```bash
   python Image2Url.py
   python test.py 
   ```

## 使用说明
- **关键词管理**
  - 使用 `KeywordDatabase` 添加、更新、删除关键词及其响应
- **用户权限**
  - 使用 `UserDatabase` 管理用户及其权限
- **Fortune 抽签**
  - 使用 `FortuneDrawer` 从 `dbs/fortunes.json` 抽签
- **二维码生成**
  - 使用 `QRCodeGenerator` 生成带有效期的二维码
  - 使用 `QRCodeParser` 解析二维码内容
- **关键词匹配**
  - 使用 `FlexibleKeywordMatcher` 进行关键词匹配

## 许可证
本项目使用 Apache 2 许可证，请查看项目根目录下的 LICENSE 文件获取详细信息。

## 注意事项
- 本项目依赖多个 `.pyc` 编译文件，确保部署环境支持Python 3.10或3.12
- 配置文件 `config.yaml` 可用于调整系统行为
- 前端资源位于 `static` 目录，样式表与脚本分别管理不同模块的UI交互