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

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

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

它是什么

简单说，SuperStar 就是一个帮你自动完成学习通任务的工具。你登录账号后，它会自动播放视频、标记文档为已读、完成阅读任务点，不用你手动点。

网页控制台版相比之前的命令行版，最大的区别是：你不需要改配置文件，直接在浏览器网页上填手机号、密码、课程 ID，还能实时看日志。

主要功能

视频自动播放，支持倍速，自动跳过已完成任务点
文档自动完成，自动标记为已读
阅读任务点自动完成
AI 辅助答题，支持 OpenAI 兼容接口
网页控制台，浏览器填配置、看日志
命令行模式，适合服务器无 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

免责声明

GitHub：https://github.com/fanxing724/fuck-xxt
线上：https://xxx

本文为 AI 辅助编写，重写版本

番星的科技记录站