Chat With CUHKSZ - 你的智能校园助手

发表于 更新于

今天为大家介绍一个我最近开发的开源项目 - Chat With CUHKSZ，这是一个全面接入大学各类校内服务系统的智能聊天机器人，它可以帮助你查询课表、成绩、图书馆资源，甚至帮你预定场地和发送邮件！

🎯 项目介绍

Chat With CUHKSZ 是一个基于大语言模型的智能校园助手，它通过接入学校的各个系统API，为学生提供一站式的校园服务查询和操作平台。无论是查询课表、成绩，还是预定场地、发送邮件，你都可以通过自然语言对话的方式轻松完成。

Github 仓库

💡 主要特性

1. 全面的系统接入

目前已经接入了以下系统：

  • 📚 SIS系统：课表查询、成绩查询、课程查询
  • 📖 图书馆系统：文章查询、期刊查询、书籍查询、全域搜索
  • 📧 邮件系统：智能邮件编辑与发送
  • 📋 BlackBoard系统：公告查询、作业查询、评分查询、课程查询
  • 🏢 场地预定系统：场地查询与预定

2. 智能Agent系统

项目采用了先进的多轮思考智能体系统，可以：

  • 🤔 智能理解用户意图
  • 🔄 自动调用相关系统API
  • 📊 信息分析与整合
  • ❓ 智能追问与确认
  • ✅ 生成清晰的回答

3. 优秀的架构设计

  • 🏗️ 采用Server-Client架构
  • 👥 支持多用户同时在线
  • 🔒 确保用户数据隔离
  • 💾 自动管理聊天记录
  • 📱 支持多端同步

🚀 快速开始

1. 下载安装

桌面客户端

支持 Windows 和 Linux 平台，可以从以下地址下载：
📦 最新版本下载

Linux用户注意：需要安装fuse：

1
sudo apt install libfuse2

后端部署

使用Docker快速部署：

1
2
3
4
5
docker pull ghcr.io/betterandbetterii/chat-with-cuhksz:latest
docker run -d --name chat-with-cuhksz-backend -p 8080:8080 \
  -e APIBASE=https://api.nextapi.fun/v1/chat/completions \
  -e APIKEY=YOUR_API_KEY \
  ghcr.io/betterandbetterii/chat-with-cuhksz:latest

或使用docker-compose：

1
docker-compose up -d --build

2. 使用方法

  1. 启动程序后输入账号密码登录
  2. 开始自然语言对话
  3. 享受智能校园服务！

演示1

演示2

演示3

🔧 开发者指南

如果你想参与开发，这里有一些重要信息：

项目结构

  • 前端代码在 frontend 目录
  • 后端代码在 backend 目录
  • 每个目录都有独立的 CMakeLists.txt

模块测试

在 backend/test 目录下创建测试文件，并修改 CMakeLists.txt：

1
add_executable(backend_executable ./test/your_test.cpp ${BACKEND_SOURCES})

添加新模块

  1. 源文件放在 backend/src
  2. 头文件放在 backend/include
  3. 自动扫描并编译

依赖管理

在 CMakeLists.txt 中添加新依赖：

1
2
find_package(DEPENDENCY_NAME REQUIRED)
target_link_libraries(backend_executable DEPENDENCY_NAME::DEPENDENCY_NAME)

🤝 参与贡献

感谢CSC3002小组的各位同学的不懈努力！