本项目旨在研究学习爬虫技术和网络接口编程技术,同时致力于以开源方式抵制并消灭各种付费“刷课平台”和“黑产”
Ps: 本项目不提供任何题库资源,有相关测试需求者请按照文档自行解决。本项目仅供学习参考使用,请在下载部署后24小时内删除,由于使用本项目不当所造成的挂科或不良学习记录作者一概不负责。
效果演示视频 https://www.bilibili.com/video/BV1yt4y1P7NF
- ✅支持手机号+密码登录、二维码登录, 自动判断账号 ck 有效性, 自动 + 手动重登账号
- ✅自带多会话管理器,自动获取用户信息,以 json 格式存档在本地
- ✅Terminal-UI 方式进行人机交互,及展示任务进程、任务点完成状态
- ✅使用 requests 及 bs4 分别进行协议模拟和 HTML 解析,故无需浏览器
- ✅支持批量选择课程(使用序号/courseId/课程名)
- ✅视频课程任务点模拟播放(无需消耗流量播放流媒体内容)
- ✅文档任务点模拟浏览(如 word ppt pdf 等)
- ✅章节测验任务点自动答题,支持单选题、多选题、判断题
- ✅支持
REST API
、JSON
、SQLite
三种类型的题库,可并行搜索优选答案,现已接入Enncy
一种第三方题库 - ✅
REST API
类型(在线题库接口)支持使用 JsonPath 语法进行答案字段提取,并提供自定义 HTTP header 选项 - ✅记录详细的运行日志及未完成的题目至日志文件
以下特性有可能逐渐被添加
- ❌短信验证码登录、学号登录
- ❌直播任务点、文章阅读任务点、课程考试
- ❌保存未完成的章节测验任务点
- ❌多题库搜索器实例混用及负载均衡
- ❌章节测验任务点之填空题、简答题、论述题等
- ❌富文本答题
- ⭕获取任务点状态会出现
0/0
的情况 (即使任务点存在未做) - ⭕对于选项为图片的题目无法匹配
若发现程序存在任何 bug 或有好的想法,欢迎提交 Issue,提交 bug 反馈时需要带上报错信息截图(截全)以及对应 log 文件,并说明触发条件
如果有能力一同开发项目,欢迎使用 PR 提交代码(注意合并 Origin 和修改内容
提交 Issue 时应当遵守 提问的智慧 以及别像弱智一样提问,切勿以不懂
、萌新问个问题
、小白啥也不会浇浇
、整个xxx呗
作为标题,否则一律忽略
Issue 为本项目的唯一反馈渠道,任何包括不限于在 QQ、B站私信、Telegram、微信 的提问一律忽略
使用 Python 版本 >= 3.10.0
clone 项目到本地
git clone 'https://github.com/PeanutMelonSeedBigAlmond/CxKitty'
cd CxKitty
pip install -r requirements.txt
运行主程序
python main.py
展开
clone 项目到本地,并开始构建镜像
git clone 'https://github.com/PeanutMelonSeedBigAlmond/CxKitty'
cd CxKitty
docker build --tag cx-kitty .
运行容器
请按实际情况映射以下容器内路径
/app/session
会话存档目录
/app/logs
程序日志目录
/app/config.yml
程序配置文件
/app/questions.json
json题库 (根据配置文件修改)
/app/questions.db
sqlite题库 (根据配置文件修改)
docker run -it \
--name shuake_task1 \
-v "$PWD/session:/app/session" \
-v "$PWD/app/logs:/app/logs" \
-v "$PWD/config.yml:/app/config.yml" \
#-v "$PWD/questions.json:/app/questions.json" \
#-v "$PWD/questions.db:/app/questions.db" \
cx-kitty
配置文件使用 Yaml 语法编写,存放于 config.yml
请根据注释修改配置内容
单选题问题与答案应当一一对应,多选题使用#
或;
分隔每个选项,判断题答案只能为对
、错
、正确
、错误
、√
、×
REST API 搜题接口配置,确保接口searcher->restAPISearcher->url
可以正确访问访问(若使用 Docker 搭建,而题库 API 服务在宿主机运行,应使用宿主机虚拟网关 IP 地址而不是本地回环地址)
返回值必须为 JSON 格式,使用rsp_field
字段作为选择器传入,使用 JsonPath 语法编写,如$.data
或$.data.answer[*]
等
eg:
curl 'http://127.0.0.1:88/v1/cx' \
--data-urlencode 'question=国字的演变的过程告诉我们,国防就是国家的防务,国防与()是密不可分的' # 这里`question`为请求字段名
{
"code": 1,
"question": "国字的演变的过程告诉我们,国防就是国家的防务,国防与()是密不可分的",
"data": "国家", // 这里的`data`为响应字段名
"hit": true
}
JSON 题库,确保searcher->jsonFileSearcher->file_path
可以访问(使用 Docker 需要设置映射),key 为题目,value 为与之对应的答案
eg:
{
"国字的演变的过程告诉我们,国防就是国家的防务,国防与()是密不可分的": "国家"
}
SQLite 题库,确保searcher->sqliteSearcher->file_path
可以访问(使用 Docker 需要设置映射),表中应存在配置的请求和响应字段
eg:
SELECT answer FROM questions WHERE question = '国字的演变的过程告诉我们,国防就是国家的防务,国防与()是密不可分的';
国家
Enncy 题库,使用前请注册并获取 Token 填写在配置文件中(第三方题库)
主页链接 https://tk.enncy.cn/
注:本项目非“开箱即用”,如需使用自动答题功能,请确保拥有准确无误的题库资源
当配置文件和题库资源无误后,运行主程序,进行选择会话存档,若少于一个会话存档,则直接进入登录界面
登录界面输入手机号后按回车键输入密码,再按回车键进行登录
登录界面直接按下回车键则会显示二维码,使用学习通手机客户端扫描登录
按照提示选择目标课程,多个课程之间使用,
分隔,使用课程选择器语法,如下:
- 课程序号:
0
、1
、2
- 课程序号范围:
0-3
、5-10
- 课程名:
"解析几何"
、"马克思主义"
(非重复项可省略后半部分 - 课程courseId:
#23026xxx
、#22928xx
如需要完成课程0
、课程1-3
、课程解析几何
则输入:0,1-3,"解析几何"
程序会自动完成视频及测验任务点,并展示章节任务点情况
项目的中文名超星学习通答题姬
早已确定,英文名想到过CxHime
、CxExamHime
、CxCourseHime
然而都非常拗口,故弃用
又想到CxHelper
这个名,但helper
一词易使人联想到木马病毒可执行程序的文件名,很不吉利
最后由CxKit
衍生出CxKitty
这个名,一语双关kitty
自有“猫娘”含义,同时由于项目首字母缩写是cxk
,亦可解释为答题只因
- 本项目以 GPL-3.0 License 作为开源协议,这意味着你需要遵守相应的规则
- 本项目仅适用于学习研究,任何人不得以此用于盈利
- 使用本项目造成的任何后果与本人无关
Samueli924/chaoxing: 超星学习通/超星尔雅/泛雅超星全自动无人值守完成任务点 (github.com)
RainySY/chaoxing-xuexitong-autoflush: 超星学习通全自动无人值守视频刷课程序,使用协议发包来实现。 (github.com)
lyj0309/chaoxing-xuexitong-autoflush: 超星学习通全自动无人值守刷课程序,使用协议发包来实现,无需浏览器,支持自动过测验、过视频。 (github.com)
ocsjs/ocsjs: OCS 网课助手,网课脚本,帮助大学生解决网课难题 ,目前支持网课:超星学习通,知道智慧树 , 支持脚本猫以及油猴脚本运行。 (github.com)
SocialSisterYi/xuexiaoyi-to-xuexitong-tampermonkey-proxy: 基于“学小易”搜题API的学习通答题/考试油猴脚本题库代理 (github.com)