超星学习通自动化完成任务点（增强版）

基于Samueli924/chaoxing的增强版本，提供命令行和Web两种使用方式

🆕 v2.5.9更新: 修复默认管理员密码更新和路由认证保护

---

⚠️ 声明

本项目采用 GPL-3.0 开源协议，完全免费使用。
禁止任何形式的强制收费或未授权商业化运营。

---

✨ 特性

命令行版

• ✅ 视频/音频自动播放（1.0-2.0倍速）
• ✅ 文档自动阅读
• ✅ 章节测验自动答题
• ✅ 6种题库支持（含AI大模型）
• ✅ 4种通知方式（含SMTP邮件）
• ✅ 配置文件加密
• ✅ 日志自动脱敏

Web平台版

• ✅ 多用户注册/登录系统
• ✅ 任务管理（创建/启动/暂停/取消/重试）
• ✅ 实时进度展示（WebSocket）
• ✅ 任务详细日志查看
• ✅ 管理员后台（系统配置/用户管理）
• ✅ 零依赖部署（SQLite+文件队列）
• ✅ 6种题库（言溪/LIKE/TikuAdapter/AI/DeepSeek/硅基流动）
• ✅ 4种通知（Server酱/Qmsg/Bark/SMTP邮件）
• ✅ 图形化数据库迁移（SQLite → PostgreSQL + Redis）
• 🆕 自动化测试（pytest + 14个测试用例）
• 🆕 CI/CD流程（GitHub Actions + 自动部署）
• 🆕 API限流（多级防护 + 暴力破解防护）
• 🆕 数据备份（自动化脚本 + 定时任务）
• 🆕 守护进程（6种部署方案 + 统一管理）

---

🚀 快速开始

方式1：Release版本（最简单）🌟

无需Node.js，前端已预编译！

Windows

1. 下载 https://github.com/ViVi141/chaoxing/releases/latest
2. 解压 chaoxing-vX.X.X-full.zip
3. 双击运行: 一键安装.bat

Linux/macOS

wget https://github.com/ViVi141/chaoxing/releases/latest/download/chaoxing-v2.3.0-full.tar.gz
tar -xzf chaoxing-v2.3.0-full.tar.gz
cd release-package
chmod +x 一键安装.sh
./一键安装.sh

方式2：源码安装

# 克隆仓库
git clone https://github.com/ViVi141/chaoxing.git
cd chaoxing

# 一键安装
./一键安装.sh     # Linux/macOS
一键安装.bat      # Windows

方式3：Docker镜像

快速模式：SQLite + Redis（推荐新手）

# 1分钟启动，SQLite数据库 + Redis队列
wget https://raw.githubusercontent.com/ViVi141/chaoxing/main/web/docker-compose.simple.yml
docker compose -f docker-compose.simple.yml up -d

特点：

• ✅ 零配置启动（使用默认密钥）
• ✅ 1分钟启动
• ✅ 支持Celery后台任务
• ✅ 适合1-20人
• ✅ 可在Web界面迁移到PostgreSQL

完整模式：PostgreSQL + Redis（生产环境）

# 完整配置，PostgreSQL数据库 + Redis + Celery
wget https://raw.githubusercontent.com/ViVi141/chaoxing/main/web/docker-compose.yml
docker compose up -d

特点：

• ✅ 生产就绪
• ✅ 高性能
• ✅ 适合20+人

访问：

• 前端界面：http://localhost:8000（前端和后端统一端口）
• API 文档：http://localhost:8000/api/docs

Docker镜像:

• GitHub Container Registry: ghcr.io/vivi141/chaoxing:latest ✅ 免费
• 支持架构: linux/amd64, linux/arm64

---

方式4：宝塔面板/1Panel部署（国内用户推荐）

完全兼容！前端已构建，无需Node.js！

宝塔面板

1. 下载Release包（750KB）
2. 使用Python项目管理器部署后端
3. 前端用Nginx直接托管dist目录

1Panel

1. 导入docker-compose.yml（推荐）
2. 或使用Python运行环境

详见：宝塔/1Panel部署指南

---

📦 安装要求

• Python: 3.12.8
• Node.js: 18+ (Web版)
• 数据库: SQLite (默认) / PostgreSQL 18 (可选)
• 消息队列: 文件系统 (默认) / Redis 7.4 (可选)

---

📚 文档

快速入门

• Release下载指南 - 快速找到适合你的版本！ 🌟
• 快速部署 - 各平台5分钟部署教程
• 快速开始 - 功能使用指南
• 依赖安装指南 - 解决依赖缺失问题 ⚠️
• 完整文档索引 - 所有文档列表

v2.3.0新增 🆕

🎁 全平台Release（自动构建）

• Windows专用包 - 双击.bat即可安装
• macOS专用包 - 运行.sh即可安装
• Linux专用包 - 含守护进程，生产可用
• Docker镜像 🐳 - 多架构（amd64/arm64）
• 源码包 💻 - 开发者可修改

查看 Release选择指南 了解详情

📦 部署文档

• Release下载指南 - 选择适合的版本
• Docker部署指南 - Docker完整文档
• 一键安装脚本 - Linux/macOS自动部署
• 一键安装脚本 - Windows自动部署
• 守护进程部署 - 6种守护进程方案
• 测试指南 - 自动化测试框架

更多文档

• 更新日志 - 版本历史（含v2.3.0详情）
• 常见问题 - FAQ
• 配置指南 - 详细配置
• CI/CD增强 - CI/CD流程说明 🆕

---

🎯 使用场景

个人使用

• 使用命令行版 + 硅基流动AI ⚡
• 简单快速，成本低，效果好

小团队(<50人)

• 使用Web平台简单模式 + 言溪/LIKE题库
• 零依赖部署，易于管理

大规模部署(>50人)

• 使用Web平台标准模式 + AI大模型 + Docker
• 高性能，支持集群

---

🔐 安全特性

• ✅ JWT令牌认证
• ✅ bcrypt密码哈希
• ✅ 数据加密存储
• ✅ 用户数据隔离
• ✅ 权限严格控制（RBAC）
• ✅ 日志自动脱敏
• ✅ CORS动态配置（生产环境限制）
• ✅ LIKE注入防护
• ✅ SQL注入防护（ORM）
• ✅ XSS防护（输入清理）

---

📊 技术栈

后端

• FastAPI 0.115.0
• SQLAlchemy 2.0.35
• Celery 5.4.0
• WebSocket 13.1

前端（v2.2.0更新）

• React 18.3.1
• Refine 5.0.4 🆕
• Ant Design 5.27.4 ⬆️
• React Router 7.0.2 🆕
• Vite 5.4.10

---

⚖️ 开源协议

GPL-3.0 License

• ✅ 允许开源/免费使用
• ✅ 允许修改和衍生
• ❌ 禁止闭源商业使用
• ❌ 禁止用于盈利

---

🙏 致谢

• 原项目：Samueli924/chaoxing
• 增强开发：ViVi141 (747384120@qq.com)

---

🆕 版本更新

📅 更新日志

v2.3.0 (2025-10-13) 🚀 生产就绪版

• ✅ 自动化测试框架（pytest + 14个测试用例）
• ✅ CI/CD流程（GitHub Actions自动化）
• ✅ API限流防护（多级限流 + 暴力破解防护）
• ✅ 数据备份方案（自动化脚本 + 双平台）
• ✅ 守护进程部署（6种方案 + 统一管理）
• ✅ 代码优化（清理冗余代码 + 性能提升）

v2.2.3 (2025-10-13)

• 在线配置管理 + 用户管理增强
• 仪表盘数据、任务暂停修复
• Vite 7 + 依赖更新 + 开源声明

v2.2.2 (2025-10-12)

• 6种题库（DeepSeek/硅基流动）
• SMTP邮件 + 任务自动恢复

完整日志

---

📞 支持

Issues | 原始项目