8 |
9 | ### 前言
10 | 为了让同学们更加认真、更加专注听课，而不去用手机签到花费大量时间、耗费大量精力，特此在[原脚本](https://github.com/mkdir700/chaoxing_auto_sign)中开发升级，请自行合理使用！挂科请不要找我，谢谢合作！请点击下方View all of README.md了解更多。
11 |
12 | 本项目支持学习通任何形式的签到（包括二维码签到、手势签到等），如果是位置签到也可以自定义位置，如果是拍照签到，请自认倒霉，因为默认是黑色照片，自定义照片还在等待开发中。
13 |
14 | 本脚本最大的不同应该就是基于github action运行，所以并不需要服务器、不需要服务器、不需要服务器同样也不需要掌握任何python的相关设置，你所需要准备的就是一个github账号以及一个耐而不烦的心。傻瓜式的操作却可以解决你最大的痛苦。
15 |
16 | ### 特点
17 | 1、基于原先作者强大的脚本，本项目支持任何形式的学习通签到。18 | 2、基于server酱使得签到成功时会将签到信息发送至你的微信。
19 | 2、无需挂在任何服务器上，只需要点几下，让github自动为你签到。
20 | 3、使用强大的GitHub actions功能，实现无服务器实时监控您的学习通签到。
21 | 4、无需掌握任何编程知识，强大的后端后端已做好，您仅需点击几下。 22 | 23 | 24 | 25 | ## 快速使用 26 | 27 | 28 | [无法查看图片？](https://www.clost.net/default/871.html "无法查看图片？") 29 | 30 | - Fork本项目后进入自己的仓库，点击你的仓库右上角的 Settings，找到 Secrets 31 |
32 | 进入github的本项目页面中，点击右上角的Fork按钮，如图所示。
34 |
35 | ![Fork本项目][7]
36 |
37 |
38 | - fork后进入你自己的仓库并在setting配置您的超星账号信息
39 | 如何Fork本项目？
33 | 注册或登陆您的github账号，访问
40 |
45 | 2.点击chaoxing字样的项目也就是刚刚fork后的项目 46 | 47 | ![41CA3BC4C95CAE8D7F8FB3A05B816CB0.jpg][4] 48 |
49 | 3.点击setting进入设置界面 50 | 51 | ![711234FE886728474A5326E42A06A40E.jpg][5] 52 |
53 | 4.点击secrets后点击add a new secret 54 | 55 | ![3AB6B127331F5CCE552730FACDA680A3.jpg][6] 56 |
57 | 依次添加以下所有name以及value。
58 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
Name:
59 | Value：
60 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
61 | Name：
62 | Value：
63 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
64 | Name：
65 | Value：
66 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
67 | Name：
68 | Value：
69 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
70 | Name：
71 | Value：
72 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
配置完后如下图所示 73 | 74 | ![3ABA6F49DE5D7DB3144B14FC9A7F1809.jpg][2] 75 | 76 |
77 | - 设置好环境变量后点击你的仓库上方的 Actions 选项，会打开一个如下的页面，点击 `I understand...` 按钮确认在 Fork 的仓库上启用 GitHub Actions 。
78 | - 最后在你这个 Fork 的仓库内随便改点什么（比如给 README 文件删掉或者增加几个字符）提交一下手动触发一次 GitHub Actions 就可以了 **（重要！！！测试发现在 Fork 的仓库上 GitHub Actions 的定时任务不会自动执行，必须要手动触发一次后才能正常工作）** 。
79 | 如何配置？
41 | 1.首先进入自己的仓库（前提您已经登陆账号） 42 | 43 | ![E19D60FD6823769D2822C93960835D01.jpg][3] 44 |45 | 2.点击chaoxing字样的项目也就是刚刚fork后的项目 46 | 47 | ![41CA3BC4C95CAE8D7F8FB3A05B816CB0.jpg][4] 48 |
49 | 3.点击setting进入设置界面 50 | 51 | ![711234FE886728474A5326E42A06A40E.jpg][5] 52 |
53 | 4.点击secrets后点击add a new secret 54 | 55 | ![3AB6B127331F5CCE552730FACDA680A3.jpg][6] 56 |
57 | 依次添加以下所有name以及value。
58 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
Name:
CHAOXING_USERNAME59 | Value：
填写你的超星账户，最好为11位的手机号60 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
61 | Name：
CHAOXING_PASSWORD62 | Value：
填写你的超星密码63 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
64 | Name：
CHAOXING_SCHOOL65 | Value：
填写你的schoolid#如果CHAOXING_USERNAME中的Value填写的是手机号，则本处填写'None'66 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
67 | Name：
CHAOXING_SERVEROR68 | Value：
填写True或者False#True代表使用微信提醒，False代表不使用69 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
70 | Name：
CHAOXING_SERVER71 | Value：
填写你的server酱SCKEY码，以SCU开头#申请地址http://sc.ftqq.com/3.version 72 | ┉┉ ∞ ∞ ┉┉┉┉ ∞ ∞ ┉┉┉
配置完后如下图所示 73 | 74 | ![3ABA6F49DE5D7DB3144B14FC9A7F1809.jpg][2] 75 | 76 |
80 |
84 | 2.在代码框随意编写或删减以达到改变代码的效果，随后点击提交commit，当然如果可以让说明书更精美欢迎来pull 85 |  86 | 87 |
88 |
89 | - 如何随意修改README文件？
81 | 82 | 1.进入你的仓库并进入code界面,点击笔字的按钮进入编写 83 | 84 | 2.在代码框随意编写或删减以达到改变代码的效果，随后点击提交commit，当然如果可以让说明书更精美欢迎来pull 85 |  86 | 87 |
90 |
96 |
97 |
98 |
99 |
100 |
101 | ## 配置说明
102 | - 配置自动执行时间
103 | 时间配置在`chaoxing/.github/workflows/cxworker.yml`文件中 第九行 `- cron: '* * * * *'`
104 | 默认：每5-6分钟自动执行签到脚本（github有时间延迟与相应限制），你也可以通过 `Push` 操作手动触发执行。
105 | 如需自定义时间，请配合[cron表达在线生成器](https://cron.clost.net "cron表达在线生成器")使用
106 | - 配置python脚本
107 | python脚本在`chaoxing/cx.py`文件中，其中第12—34行为配置区域，如需自己的服务器运行更改含有`os.environ`的相关参数即可。
108 | - 配置位置签到
109 | 进入`chaoxing/cx.py`修改225行`'address': '中国',`的`中国`为你想显示的位置；修改227行`'clientip': '0.0.0.0',`的`0.0.0.0`为你想显示的[ip地址](https://www.ip138.com/ "ip地址")。
110 | - 配置拍照签到
111 | 目前无法配置，默认纯黑色照片，请等待更新。
112 |
113 | ## 关于
114 | 本项目基于https://github.com/mkdir700/chaoxing_auto_sign
115 | 制作，使得脚本可以无服务器执行，并简化操作以让更多人使用。
116 | 本项目遵循GNU GPLv3开源协议；并有以下条款特此说明：
117 | 1. 请勿使用本项目进行商业用途
118 | 1. 请勿使用本项目违反当地法规
119 | 1. 请勿使用本项目损害他人或集团利益
120 |
121 | 以上条款，若使用者违反，后果自行承担与作者本人无关！
122 |
123 | ## 鸣谢
124 |
125 | [mkdir700](https://github.com/mkdir700)
126 |
127 | ## 其他项目推荐
128 |
129 | | 项目地址 | 开发语言 | 备注 |
130 | | ------------------------------------------------------- | ---------- | ---------------------------------------------- |
131 | | https://github.com/mkdir700/chaoxing_auto_sign | Python | 超星学习通自动签到脚本&多用户多任务&API |
132 | | https://github.com/Wzb3422/auto-sign-chaoxing | TypeScript | 超星学习通自动签到，梦中刷网课 |
133 | | https://github.com/Huangyan0804/AutoCheckin | Python | 学习通自动签到，支持手势，二维码，位置，拍照等 |
134 | | https://github.com/aihuahua-522/chaoxing-testforAndroid | Java | 学习通（超星）自动签到 |
135 | | https://github.com/yuban10703/chaoxingsign | Python | 超星学习通自动签到 |
136 |
137 |
138 |
139 | ## 紧急通知
140 |
141 | 请一定要根据配置说明配置计划时间；防止被判定滥用。
142 | 如何查看脚本执行情况？
91 | 注意： 为了实现某个链接/帐户访问出错时不中断程序继续尝试下一个，GitHub Actions 的状态将永远是“通过”（显示绿色的✔），请自行检查 GitHub Actions 日志：依次点击Actions=>chaoxing=>get_points=>Qiandao项的输出确定程序执行情况。
92 |
93 | ![6D6681A2A552E03AE2AEC28B4542F217.jpg][1]
94 |
95 | 143 | 由于本项目被大量fork并启动actions功能，占用github官方服务器大量资源。部分用户反映无法签到，actions功能被禁止等问题。但是大部分用户仍然正常可以使用；解决方法：1.使用使用Travis Ci运行。学业繁忙，不予教程。2.请访问我的服务器 https://cx.clost.net 但并不保证其稳定性。（目前源码臃肿，修改删减后上传）3.用自己的服务器运行其中的py脚本。 144 | 145 | 146 | [7]: https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/3749713206.png 147 | [1]: https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/3207755264.jpg 148 | [2]:https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/437025077.jpg 149 | [3]:https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/3185006214.jpg 150 | [4]:https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/977504155.jpg 151 | [5]:https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/1888532943.jpg 152 | [6]:https://cdn.jsdelivr.net/gh/closty/tuchuang/usr/uploads/2020/04/3351341396.jpg 153 | -------------------------------------------------------------------------------- /cx.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf8 -*- 2 | import os 3 | import time 4 | import urllib3 5 | import asyncio 6 | import re 7 | import json 8 | import requests 9 | urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning) 10 | 11 | 12 | # =================配置区start=================== 13 | 14 | # 学习通账号密码 15 | user_info = { 16 | 'username': os.environ["CHAOXING_USERNAME"], 17 | 'password': os.environ["CHAOXING_PASSWORD"], 18 | 'schoolid': os.environ["CHAOXING_SCHOOL"] # 学号登录才需要填写 19 | } 20 | 21 | # server酱 22 | server_chan_sckey = os.environ["CHAOXING_SERVER"] # 申请地址http://sc.ftqq.com/3.version 23 | server_chan = { 24 | 'status': os.environ["CHAOXING_SERVEROR"] , # 如果关闭server酱功能，请改为False 25 | 'url': 'https://sc.ftqq.com/{}.send'.format(server_chan_sckey) 26 | } 27 | 28 | # 学习通账号cookies缓存文件路径 29 | cookies_path = "cookies.json" # cookies.json 保存路径 30 | 31 | # activeid保存文件路径 32 | activeid_path = "activeid.txt" 33 | 34 | # =================配置区end=================== 35 | 36 | 37 | class AutoSign(object): 38 | 39 | def __init__(self, username, password, schoolid=None): 40 | """初始化就进行登录""" 41 | self.headers = { 42 | 'Accept-Encoding': 'gzip, deflate', 43 | 'Accept-Language': 'zh-CN,zh;q=0.9', 44 | 'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9', 45 | 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.100 Safari/537.36'} 46 | self.session = requests.session() 47 | self.session.headers = self.headers 48 | # 读取指定用户的cookies 49 | if self.check_cookies_status(username) is False: 50 | self.login(password, schoolid, username) 51 | self.save_cookies(username) 52 | 53 | def save_cookies(self, username): 54 | """保存cookies""" 55 | new_cookies = self.session.cookies.get_dict() 56 | with open(cookies_path, "r") as f: 57 | data = json.load(f) 58 | data[username] = new_cookies 59 | with open(cookies_path, 'w') as f2: 60 | json.dump(data, f2) 61 | 62 | def check_cookies_status(self, username): 63 | """检测json文件内是否存有cookies,有则检测，无则登录""" 64 | if "cookies.json" not in os.listdir("./"): 65 | with open(cookies_path, 'w+') as f: 66 | f.write("{}") 67 | 68 | with open(cookies_path, 'r') as f: 69 | 70 | # json文件有无账号cookies, 没有，则直接返回假 71 | try: 72 | data = json.load(f) 73 | cookies = data[username] 74 | except Exception: 75 | return False 76 | 77 | # 找到后设置cookies 78 | for u in cookies: 79 | self.session.cookies.set(u, cookies[u]) 80 | 81 | # 检测cookies是否有效 82 | r = self.session.get('http://i.mooc.chaoxing.com/app/myapps.shtml', allow_redirects=False) 83 | if r.status_code != 200: 84 | print("cookies已失效，重新获取中") 85 | return False 86 | else: 87 | print("cookies有效哦") 88 | return True 89 | 90 | def login(self, password, schoolid, username): 91 | # 登录-手机邮箱登录 92 | if schoolid: 93 | r = self.session.post( 94 | 'http://passport2.chaoxing.com/api/login?name={}&pwd={}&schoolid={}&verify=0'.format(username, password, 95 | schoolid)) 96 | if json.loads(r.text)['result']: 97 | print("登录成功") 98 | else: 99 | print("登录失败，请检查账号密码是否正确") 100 | 101 | else: 102 | r = self.session.get( 103 | 'https://passport2.chaoxing.com/api/login?name={}&pwd={}&schoolid=&verify=0'.format(username, password), 104 | headers=self.headers) 105 | if json.loads(r.text)['result']: 106 | print("登录成功") 107 | else: 108 | print("登录失败，请检查账号密码是否正确") 109 | 110 | def check_activeid(self, activeid): 111 | """检测activeid是否存在，不存在则添加""" 112 | with open(activeid_path, 'r') as f: 113 | s = f.read() 114 | if activeid in s: 115 | return True 116 | with open(activeid_path, 'w+') as f: 117 | f.writelines(activeid) 118 | return False 119 | 120 | def get_all_classid(self) -> list: 121 | """获取课程主页中所有课程的classid和courseid""" 122 | re_rule = r'
[\s].*[\s].*[\s].*[\s].*.* '
132 | # sign_type_re_rule = r'\[(.*)\]'
133 | re_rule = r'
[\s].*[\s].*[\s].*[\s].*.* [\s]+[\s][\s]+[\s]+
[\s]+(.*)'
134 | r = self.session.get(
135 | 'https://mobilelearn.chaoxing.com/widget/pcpick/stu/index?courseId={}&jclassId={}'.format(
136 | courseid, classid), headers=self.headers, verify=False)
137 | res = re.findall(re_rule, r.text)
138 | # sign_type = re.findall(sign_type_re_rule, r.text)
139 | # print(sign_type)
140 | if res != []: # 满足签到条件
141 | return {
142 | 'classid': classid,
143 | 'courseid': courseid,
144 | 'activeid': res[0][0],
145 | 'classname': classname,
146 | 'sign_type': res[0][1]
147 | }
148 |
149 | def general_sign(self, classid, courseid, activeid):
150 | """普通签到"""
151 | r = self.session.get(
152 | 'https://mobilelearn.chaoxing.com/widget/sign/pcStuSignController/preSign?activeId={}&classId={}&fid=39037&courseId={}'.format(
153 | activeid, classid, courseid), headers=self.headers, verify=False)
154 | title = re.findall('(.*) ', r.text)[0]
155 | if "签到成功" not in title:
156 | # 网页标题不含签到成功，则为拍照签到
157 | return self.tphoto_sign(activeid)
158 | else:
159 | sign_date = re.findall('(.*)', r.text)[0]
160 | s = {
161 | 'date': sign_date,
162 | 'status': title
163 | }
164 | return s
165 |
166 | def hand_sign(self, classid, courseid, activeid):
167 | """手势签到"""
168 | hand_sign_url = "https://mobilelearn.chaoxing.com/widget/sign/pcStuSignController/signIn?&courseId={}&classId={}&activeId={}".format(
169 | courseid, classid, activeid)
170 | r = self.session.get(hand_sign_url, headers=self.headers, verify=False)
171 | title = re.findall('(.*) ', r.text)
172 | sign_date = re.findall('(.*)', r.text)[0]
173 | s = {
174 | 'date': sign_date,
175 | 'status': title
176 | }
177 | return s
178 |
179 | def qcode_sign(self, activeId):
180 | """二维码签到"""
181 | params = {
182 | 'name': '',
183 | 'activeId': activeId,
184 | 'uid': '',
185 | 'clientip': '',
186 | 'useragent': '',
187 | 'latitude': '-1',
188 | 'longitude': '-1',
189 | 'fid': '',
190 | 'appType': '15'
191 | }
192 | res = self.session.get('https://mobilelearn.chaoxing.com/pptSign/stuSignajax', params=params)
193 | s = {
194 | 'date': time.strftime("%m-%d %H:%M", time.localtime()) ,
195 | 'status': res.text
196 | }
197 | return s
198 |
199 | def addr_sign(self, activeId):
200 | """位置签到"""
201 | params = {
202 | 'name': '',
203 | 'activeId': activeId,
204 | 'address': '中国',
205 | 'uid': '',
206 | 'clientip': '0.0.0.0',
207 | 'latitude': '-2',
208 | 'longitude': '-1',
209 | 'fid': '',
210 | 'appType': '15',
211 | 'ifTiJiao': '1'
212 | }
213 | res = self.session.get('https://mobilelearn.chaoxing.com/pptSign/stuSignajax', params=params)
214 | s = {
215 | 'date': time.strftime("%m-%d %H:%M", time.localtime()),
216 | 'status': res.text
217 | }
218 | return s
219 |
220 | def tphoto_sign(self, activeId):
221 | """拍照签到"""
222 | params = {
223 | 'name': '',
224 | 'activeId': activeId,
225 | 'address': '中国',
226 | 'uid': '',
227 | 'clientip': '0.0.0.0',
228 | 'latitude': '-2',
229 | 'longitude': '-1',
230 | 'fid': '',
231 | 'appType': '15',
232 | 'ifTiJiao': '1',
233 | 'objectId': '5712278eff455f9bcd76a85cd95c5de3'
234 | }
235 | res = self.session.get('https://mobilelearn.chaoxing.com/pptSign/stuSignajax', params=params)
236 | print(res.text)
237 | s = {
238 | 'date': time.strftime("%m-%d %H:%M", time.localtime()),
239 | 'status': res.text
240 | }
241 | return s
242 |
243 | def sign_in(self, classid, courseid, activeid, sign_type):
244 | """签到类型的逻辑判断"""
245 | if self.check_activeid(activeid):
246 | return
247 | if "手势" in sign_type:
248 | # test:('拍照签到', 'success')
249 | return self.hand_sign(classid, courseid, activeid)
250 |
251 | elif "二维码" in sign_type:
252 | return self.qcode_sign(activeid)
253 |
254 | elif "位置" in sign_type:
255 | return self.addr_sign(activeid)
256 |
257 | else:
258 | # '[2020-03-20 14:42:35]-[签到成功]'
259 | r = self.general_sign(classid, courseid, activeid)
260 | return r
261 |
262 | def sign_tasks_run(self):
263 | """开始所有签到任务"""
264 | tasks = []
265 | sign_msg = {}
266 | final_msg = []
267 | # 获取所有课程的classid和course_id
268 | classid_courseId = self.get_all_classid()
269 |
270 | # 获取所有课程activeid和签到类型
271 | for i in classid_courseId:
272 | coroutine = self.get_activeid(i[1], i[0], i[2])
273 | tasks.append(coroutine)
274 |
275 | loop = asyncio.new_event_loop()
276 | asyncio.set_event_loop(loop)
277 | result = loop.run_until_complete(asyncio.gather(*tasks))
278 |
279 | for d in result:
280 | if d is not None:
281 | s = self.sign_in(d['classid'], d['courseid'], d['activeid'], d['sign_type'])
282 | if not s:
283 | return
284 | # 签到课程， 签到时间， 签到状态
285 | sign_msg = {
286 | 'name': d['classname'],
287 | 'date': s['date'],
288 | 'status': s['status']
289 | }
290 | final_msg.append(sign_msg)
291 | return final_msg
292 |
293 |
294 | def server_chan_send(msg):
295 | """server酱将消息推送至微信"""
296 | desp = ''
297 | for d in msg:
298 | desp = '| **课程名** | {} |\r| :----------: | :---------- |\r'.format(d['name'])
299 | desp += '| **签到时间** | {} |\r'.format(d['date'])
300 | desp += '| **签到状态** | {} |\r'.format(d['status'])
301 |
302 | params = {
303 | 'text': '您的网课签到消息来啦！！',
304 | 'desp': desp
305 | }
306 |
307 | requests.get(server_chan['url'], params=params)
308 |
309 |
310 | def local_run():
311 | # 本地运行使用
312 | if "activeid.txt" not in os.listdir("./"):
313 | with open(activeid_path, 'w+') as f:
314 | f.write("")
315 | s = AutoSign(user_info['username'], user_info['password'])
316 | result = s.sign_tasks_run()
317 | if result:
318 | if server_chan['status']:
319 | server_chan_send(result)
320 | return result
321 | else:
322 | return "暂无签到任务"
323 |
324 |
325 | if __name__ == '__main__':
326 | print(local_run())
327 |
--------------------------------------------------------------------------------