SuperStar 网页控制台：超星学习通自动学习工具

这是什么

SuperStar 是一个超星学习通自动学习脚本，可以自动完成视频、文档和阅读任务。最近我把启动器升级成了网页控制台，填配置、看日志都在浏览器里完成，比纯命令行更直观。

⚠️ 声明：本项目仅供学习交流，使用造成的任何后果由使用者自行承担。

当前功能

功能	状态	说明
视频自动播放	✅	支持倍速，自动跳过已完成任务点
文档自动完成	✅	自动标记文档任务为已完成
阅读自动完成	✅	自动完成阅读任务点
AI 辅助答题	✅	支持 OpenAI 兼容接口，可配置是否直接提交
网页控制台	✅	浏览器填写配置、查看实时日志
命令行模式	✅	保留 `--cli` 参数，适合无 GUI 环境

快速开始

环境要求

Python 3.8+
Windows / macOS / Linux 均可运行

获取代码

项目地址：GitHub - fuck-xxt

🇨🇳 国内用户建议用加速链接访问。

1 2	git clone https://github.com/fanxing724/fuck-xxt.git cd fuck-xxt

也可以直接下载 ZIP 压缩包解压。

安装依赖

1	pip install -r requirements.txt

启动

macOS / Linux：

./run.sh

Windows：

run.bat

启动后会自动打开浏览器，访问 http://127.0.0.1:8765/。如果没有自动打开，手动在浏览器输入这个地址。

网页控制台配置

在浏览器界面里可以填写：

手机号和密码
课程 ID（留空表示学习全部课程）
视频播放倍速
AI 答题开关
OpenAI 兼容 Endpoint、API Key、模型
是否直接提交答案
是否保存配置

填写 Endpoint 和 API Key 后，点击”刷新模型”可以自动获取模型列表。

命令行模式

如果不想用网页界面，可以用 --cli 参数：

1	./run.sh --cli

Windows：

1	run.bat --cli

首次命令行运行时如果没有 config.ini，启动器会从 config/config.ini.example 自动创建一份。

配置文件

配置文件在项目根目录 config.ini，模板在 config/config.ini.example。

基础配置：

[common]
username = 你的手机号
password = 你的密码
speed = 2

AI 答题配置示例：

[tiku]
provider = AI
submit = false
endpoint = https://api.openai.com/v1
key = your_api_key
model = gpt-4o-mini
http_proxy =
min_interval_seconds = 3
cover_rate = 0.8
true_list = 正确,对,√,是
false_list = 错误,错,×,否,不对,不正确

provider 留空时禁用 AI 答题。

目录结构

.
├── run.sh                    # macOS / Linux 主启动器
├── run.bat                   # Windows 主启动器
├── app/
│   ├── main.py               # 命令行学习入口
│   ├── web_desktop.py        # 本地网页控制台
│   ├── desktop.py            # 备用 Tk 桌面入口
│   ├── api/                  # 核心接口和学习逻辑
│   ├── resource/             # 字体映射等资源
│   └── static/               # 网页静态资源
├── config/
│   └── config.ini.example    # 配置模板
├── docs/
│   └── superstar-tutorial.html
├── requirements.txt
├── pyproject.toml
└── Dockerfile

备用桌面模式

如果需要使用旧的 Tk 桌面界面：

1	SUPERSTAR_UI=tk ./run.sh

让脚本在 Tk 可用时自动使用桌面、不可用时回退到网页：

1	SUPERSTAR_UI=auto ./run.sh

常见问题

依赖安装失败

检查网络和 Python 环境。启动器默认使用清华镜像源安装依赖。

模型列表获取失败

确认 Endpoint 是 OpenAI 兼容接口地址，API Key 可用，且服务商支持 GET /models。

如果提示 Cloudflare 403 / 1010，说明服务商拦截了模型列表请求。模型列表只是辅助功能，可以直接在模型输入框手动填写模型名后运行。

config.ini 包含敏感信息

config.ini 已加入 .gitignore，不会上传到代码仓库。不要把真实的配置文件公开。

项目地址

📦 GitHub：https://github.com/fanxing724/fuck-xxt

免责声明

本项目仅供学习交流使用，请勿用于商业用途。使用本项目造成的任何后果由使用者自行承担。

番星的科技记录站