本项目仅供学习交流使用，不得用于商业用途，因使用本项目导致的任何后果，与本人无关。
本脚本用于自动完成青年大学习的学习任务，在进行简单的初始化后，您便可摆脱每周的青年大学习打卡的束缚。请注意，本脚本仅 适用于 上海地区 、且平台为微信公众号 青春上海 的青年大学习任务。若您需要本地使用，则在使用本脚本前，请先保证您 的计算机中已安装 Python3.6 或以上版本的Python环境。若您选择 更快的快速上手 部署项目，则无需安装Python。
该章节适用于已经关注了青春上海微信公众号、已在公众号中留有学习记录且没有更改姓名、学号等需求的用户。
通过本章节的配置，可以让您直接使用GitHub中的Actions功能自动学习，关于这一部分内容详见
GitHub Actions。
1、访问https://vvbbnn00.github.io/qndxxAutoStudy/，
微信扫码，记录下获取到的Token。
2、Fork该项目，接着，在项目的Settings-Secrets and variables-Actions-Repository secrets处新建一个Secret（点击New
repository secret），
名称为KEY，内容是获取到的Token。
3、若您是初次配置，请至Actions，点击I understand my workflows, go ahead and enable them启用Actions，在左侧面板找到Learn，点击Enable启用该任务。
Enjoy🎉
在使用之前，请确保学习用的微信账号已经关注了青春上海微信公众号，这十分重要！
1、安装必须的Python库
pip install -r requirements.txt2、运行Flask服务器，请注意，host需要设置为局域网设备可访问的IP而非127.0.0.1，port可以自行设置
flask run --host=0.0.0.0 --port=11451或者
python app.py3、使用桌面端浏览器访问http://<host>:<port>/，并按照提示使用微信扫码登录
4、复制1、调用脚本中的Token
5、在计算机上运行脚本
python script.py [获取的Token]script.py是主要的脚本文件，用于完成青年大学习的学习任务。
| 参数 | 说明 |
|---|---|
| <登录信息> | 登录信息，获取方式见README.md |
| 参数 | 含义 | 说明 |
|---|---|---|
| -v, --version | / | 输出当前版本号，然后退出程序 |
| -h, --help | / | 显示帮助并退出 |
| -o, --orgId | 自定义组织ID | 可选，输入此项后，学习记录的组织ID将被替换为此项的值，若不填写，则默认为最后一次学习的组织ID |
| -n, --name | 姓名/学号/工号 | 可选，输入此项后，您的姓名/学号/工号将被替换为此项的值，若不填写，则默认为最后一次学习的信息 |
| -so, --subOrg | 子区域 | 可选，输入此项后，您的子区域信息将被替换为此项的值，若不填写，则默认为最后一次学习的信息，该项仅在四级组织需手动填写时需要填写，若四级组织存在，则请勿填写此项，会导致学习失败 |
| -a, --onAction | GitHub Action模式 | 该选项表示您正在以GitHub Action环境执行自动学习任务，由于在Public仓库中，所有的Action都会留下日志，因此，当启用该选项后，将不会在控制台输出任何个人信息。 |
| -wx, --wechatWebhook | 企业微信Webhook地址 | 可选，输入此选项后，在学习结束时，会自动向绑定的企业微信机器人发送消息通知。 |
| -dd, --dingdingWebhook | 钉钉Webhook地址 | 可选，输入此选项后，在学习结束时，会自动向绑定的钉钉机器人发送消息通知。 |
| -p, --proxy | 是否启用代理 | 启用该选项后，会自动获取可用代理，并通过代理发送请求 |
| -s, --savePic | 是否保存学习完成截图 | 启用该选项后，会在学习完成后保存学习完成截图，截图保存在./qndxximg/目录下，文件名为endimg_{时间戳}.jpg，若不启用该选项，则不会保存截图。 |
使用最后一次学习的信息完成新的学习任务
python script.py 1234567890abcdef使用自定义信息完成新的学习任务
python script.py 1234567890abcdef -o N0001 -n "张三" -so "子区域1"Flask应用的端口可以随意更改，但开放Host必须能够从局域网访问到。在微信扫码成功获取登录信息后，若没有额外需求， 可以直接关闭Flask应用，登录信息是长期有效的，在青春上海平台更新前，不需要担心登录信息失效。
流程同快速上手中的3、使用桌面端浏览器访问。
登录结果页面提供了3种完成学习的方式，第一种是使用script.py脚本完成学习，第二种和第三种则为访问Flask应用相应URL的方式。
第一种方式在1、调用脚本和脚本文件说明中已经介绍过，这里不再赘述。
第二种方式如页面中介绍，扫描登录结果页面2、访问URL下方的二维码即可完成学习，
该链接长期有效，您可收藏后多次使用，默认以最后一次完成的组织信息完成最新一期的青年大学习，
若您在过去从未在青春上海平台完成青年大学习，则需使用第三种方式。
第三种方式如页面中介绍，在登录结果页面3、自定义URL下方，选择您需要完成学习的组织，
并填入您的姓名，点击生成链接获取学习链接，扫码即可完成学习。该链接长期有效，您可收藏后多次使用。
正如文档中描述，无论是脚本还是Flask应用执行学习任务，都是运行一次后立即停止的，若您需要定时触发学习任务， 则需要自行编写定时任务。
使用GitHub Actions来完成自动学习任务是被推荐的。这是一种相对而言最为方便的方式。目前的Action配置文件是
autoLearn.yml，默认启用了GitHub Action模式，预留企业微
信Webhook配置变量，每周二11时30分自动启动学习。您可以根据自己的情况进行相应的调整。
要使用Github Actions，您首先需要fork该项目，接着，在项目的Settings-Actions secrets and variables-Actions-Secrets处新建两个Secret，名称和相应内容如下表
| 键 (Key) | 值 (Value) |
|---|---|
| KEY | 您获取到的Token，如果还未获取，请参考说明的前半部分 |
| WECHAT_WEBHOOK | [可选的] 您的企业微信机器人Webhook地址 |
| DINGDING_WEBHOOK | [可选的] 您的钉钉机器人Webhook地址 |
接着，若您是初次配置，请至Actions，点击I understand my workflows, go ahead and enable them启用Actions，在左侧面板找到Learn，点击Enable启用该任务。
大功告成🎉
在Actions-Learn中，点击Run Workflow，即可手动运行一次学习任务。
若您需要删除学习任务，同样地，在Actions-Learn中，点击右上角的...，点击Disable Workflow即可。
Linux下可以使用crontab命令来编写定时任务，Windows下可以使用计划任务来编写定时任务，具体使用方法请自行搜索。
该功能仅通过script.py调用时有效。
若您需要第一时间收到学习完毕的消息，则可以配置消息推送功能。目前支持的消息推送平台只有企业微信、钉钉，若有更多需求，
可发issue，由于本人比较忙，更新较慢，请见谅。
配置企业微信消息通知十分简单，只需要在执行脚本时添加参数-wx=你的机器人Webhook地址。
机器人Webhook地址可以通过在企业微信中新建一个群聊，接着点击右上角...，选择群机器人-添加即可。
配置钉钉消息通知十分简单，只需要在执行脚本时添加参数-dd=你的机器人Webhook地址。
机器人Webhook地址可以通过在钉钉中新建一个群聊，接着点击右上角齿轮，选择机器人-添加机器人-自定义。
安全设置选择自定义关键词，关键词填写青年大学习，接着点击完成即可。
若您的网络环境需要使用代理才能访问外网，则需在config/api_config.py中配置代理信息。
# 代理配置
PROXY = {
"http": "http://...",
"https": "https://..."
}除了上述方法之外，您还可以在执行脚本时添加参数-p或--proxy来启用代理，启用该选项后，会自动获取可用代理，并通过代理发送请求。
由于公用代理IP池的不稳定性，您可以通过修改config/api_config.py中的PROXY_POOL_URL来更换代理IP池。
本项目的IP池基于ProxyPool搭建，感谢该项目作者。
本项目仅供学习交流使用，不得用于商业用途，因使用本项目导致的任何后果，与本人无关。
