Skip to content

Lecheeel/chaoxing

Repository files navigation

基本

  • ✅ 账户管理
    • 多用户支持
    • 保存用户认证信息,避免重复登录
    • 用户信息安全存储

签到

  • ✅ 支持多种签到方式
    • 位置签到(支持预设多个位置)
    • 普通签到
    • 手势签到
    • 拍照签到
    • 签到码签到

自动化

  • ✅ 监控签到

    • 实时监控课程签到活动
    • 发现签到后自动完成
    • 支持设置签到延迟时间
  • ✅ 定时任务

    • 支持按日、按周设置定时签到任务
    • 可设置多个签到时间段
    • 定时任务管理(添加、修改、删除)
    • 定时任务日志记录

Web管理面板

  • ✅ 用户友好的Web界面
    • 用户管理(添加、删除、修改)
    • 位置管理(添加、删除预设位置)
    • 任务管理(添加、修改、删除定时任务)
    • 手动触发签到功能
    • 查看任务执行状态和日志

系统功能

  • ✅ 日志记录

    • 详细的操作日志
    • 签到结果记录
    • 系统运行状态记录
  • ✅ 多平台支持

    • Windows支持
    • Linux/Mac支持
    • 后台守护进程模式

计划

签到增强

  • ⏳ 二维码签到支持
  • ⏳ 签到信息统计与分析
  • ⏳ 签到失败自动重试机制
  • ⏳ 更多签到策略(如随机延迟)

用户体验

  • ⏳ 移动端友好的响应式界面
  • ⏳ 邮件/消息通知功能
  • ⏳ 签到结果推送(如微信、邮件)
  • ⏳ 多语言支持

系统优化

  • ⏳ 数据库存储替代JSON文件
  • ⏳ 用户权限管理
  • ⏳ 系统资源监控
  • ⏳ Docker容器化部署支持
  • ⏳ API文档完善

其他功能

  • ⏳ 课程信息自动同步
  • ⏳ 选课推荐
  • ⏳ 作业提醒
  • ⏳ 考试提醒

使用方法

安装依赖

pip install -r requirements.txt

启动系统

python start.py

使用Web管理界面

启动系统后,可以通过浏览器访问:http://127.0.0.1:5000

更多运行方式

根据不同需求选择合适的启动方式:

1. 通过启动脚本 start.py(推荐)

自动选择端口启动(守护进程模式)

python start.py

系统会自动选择可用端口,并在后台运行应用。

指定端口启动

python start.py -p 8080

指定在8080端口运行应用。

直接模式(非守护进程)

python start.py -d

在当前控制台直接运行应用,适合调试和开发时使用。

安装依赖项

python start.py --install-deps

自动安装所需依赖项。

2. 守护进程模式 daemon.py

# 基本启动
python daemon.py

# 指定端口启动
python daemon.py -p 8080

# 启用后台运行(Linux/Mac)
python daemon.py -d

# 查看帮助
python daemon.py -h

在Linux/Mac系统上,守护进程模式可以实现完全后台运行;在Windows系统上,会创建一个新的控制台窗口运行程序。

3. 直接启动Web应用 app.py

python app.py [端口号]

直接启动Web应用,不启用守护进程模式,适合开发调试或在某些服务器环境下使用。

4. 单次签到模式 sign.py

python sign.py

为指定用户执行一次签到操作,适合手动签到或测试签到功能。

5. 监控签到模式 monitor.py

python monitor.py

启动签到监控,实时监控课程中的签到活动并自动完成签到。

6. 命令行测试模式 cli_test_main.py

python cli_test_main.py

启动命令行测试界面,用于测试各项功能。

7. 使用Web服务器部署

使用Gunicorn(Linux/Mac)

gunicorn -w 4 -b 0.0.0.0:5000 webpanel.app:app

使用Waitress(Windows)

waitress-serve --port=5000 webpanel.app:app

运行模式

  • 普通用户:推荐使用 python start.py 默认模式,系统会自动选择合适的配置
  • 开发调试:建议使用 python start.py -d 直接模式,便于查看日志输出
  • 服务器部署
    • Linux/Mac:使用 python daemon.py -d -p 端口号 或配合Gunicorn
    • Windows:使用 python daemon.py -p 端口号 或配合Waitress
  • 临时签到:使用 python sign.py 进行单次签到
  • 签到监控:使用 python monitor.py 启动持续监控

系统要求

  • Python 3.6 或更高版本
  • 依赖包见 requirements.txt

免责声明

本项目仅供学习和研究使用,不得用于商业用途。使用本项目所产生的一切后果由使用者自行承担。

  1. 本项目开发者不对使用本软件造成的任何直接或间接损失负责
  2. 使用本项目即表示您同意遵守相关法律法规,并对自己的行为负责
  3. 请勿利用本项目进行任何违反校规校纪、学术不端或违反法律法规的活动
  4. 开发者保留随时修改或终止服务的权利,恕不另行通知
  5. 本项目不会收集用户的敏感信息,所有数据均存储在用户本地

请在符合相关规定的前提下,合理使用本工具。如不同意上述声明,请立即停止使用本项目。

License

本项目采用 GNU通用公共许可证v3.0(GPL-3.0) 进行许可。