- 本项目基于nonebot2和OneBot V11协议，使用本插件前请先阅读以上两个项目的使用文档
- 启动插件之后，一定要登录后台在推送列表中添加需要开启大学习功能的群聊
- 本项目无法在中国大陆地区（除港、澳、台）外的IP环境下使用，如有开启代理，请关闭或添加代理规则
- 需要抓包的地区，绑定后尽量别进官方公众号，避免token或cookie刷新导致无法提交
- 本项目需要部署在公网可访问的容器中，并开放端口（nonebot2配置的port），否则大部分功能将出现异常
- 欢迎加入QQ反馈群，交流讨论，如您不会搭建又想每周自动提交，可加入QQ体验群。
- 时间精力有限，目前只维护
湖北和江西两个地区，其他地区出问题请提交Issues,我找个时间修，需要增加地区请进群帮忙测试，个别地区没账号无法测试 - 觉得项目不错，不妨点个stars.
| 共青团名称 | 开发状态 | 备注 |
|---|---|---|
| 青春湖北 | 支持 | 无需抓包，支持提交往期青年大学习 |
| 江西共青团 | 支持 | 无需抓包，不支持提交往期青年大学习 |
| 安徽共青团 | 支持 | 无需抓包，不支持提交往期青年大学习 |
| 广东共青团 | 支持 | 无需抓包，不支持提交往期青年大学习 |
| 青春北京 | 支持 | 无需抓包，不支持提交往期青年大学习 |
| 青春上海 | 支持 | 微信扫码绑定，不支持提交往期青年大学习，只能提交最新一期 |
| 青春浙江 | 支持 | 微信扫码绑定，不支持提交往期青年大学习，只能提交最新一期 |
| 津彩青春 | 支持 | 需要自行抓包，不支持提交往期青年大学习 |
| 青春山东 | 支持 | 需要自行抓包，支持提交往期青年大学习 |
| 重庆共青团 | 支持 | 需要自行抓包 |
| 吉青飞扬 | 支持 | 需要自行抓包 |
| 天府新青年 | 支持 | 绑定好信息后不进入天府新青年云token时效为100Years |
| 三秦青年 | 支持 | 需要自行抓包，token时效未知，待测试，支持提交往期青年大学习 |
| 河南共青团 | 不支持 | cookie时效小于1周 |
| 江苏共青团 | 不支持 | cookie时效小于1周 |
| 黑龙江共青团 | 不支持 | cookie时效小于1周 |
| 广西青年圈 | 待开发 | |
| 青春湖南 | 待开发 | |
| 甘肃青年 | 待开发 | |
| 山西青年 | 待开发 | |
| 河北共青团 | 待开发 | |
| 福建共青团 | 待开发 | |
| 内蒙古青年 | 待开发 | |
| 云南共青团 | 待开发 | |
| 海南共青团 | 待开发 | |
| 青春黔言 | 待开发 | |
| 青春柳州 | 待开发 | |
| 辽宁共青团 | 待开发 | |
| 宁夏共青团 | 待开发 | |
| 新疆共青团 | 待开发 | |
| 西藏共青团 | 待开发 |
第一种方式(不推荐)
- 使用
git clone https://github.com/YouthLearning/TeenStudy.git指令克隆本仓库或下载压缩包文件
第二种方式(二选一)
- 使用
pip install TeenStudy来进行安装,使用pip install TeenStudy -U进行更新 - 使用
nb plugin install TeenStudy来进行安装,使用nb plugin install TeenStudy -U进行更新
使用第一种方式安装看此方法
-
将
TeenStudy放在nb的plugins目录下，运行nb机器人即可 -
文件结构如下
📦 AweSome-Bot ├── 📂 awesome_bot │ └── 📂 plugins | └── 📂 TeenStudy | └── 📜 __init__.py ├── 📜 .env.prod ├── 📜 .gitignore ├── 📜 pyproject.toml └── 📜 README.md
使用第二种方式安装看此方法
- 在
pyproject.toml里的[tool.nonebot]中添加plugins = ["TeenStudy"]
-
在nonebot的
.env或.env.prod配置文件中修改nonebot2的HOST为0.0.0.0、设置好超管账号和公网IPHOST = "0.0.0.0" #nonebot2监听的IP SUPERUSERS = [""] # 超级用户 COMMAND_START=[""] # 命令前缀,根据需要自行修改 DXX_IP = ""
- 启动nb,等待插件加载数据，加载完毕后登录后台，账号默认为
nonebot配置文件中的超管账号，密码默认为：admin,开放端口（默认为.env中配置的port） - 在管理后台的推送列表中添加需要开启大学习使用的群聊
| 指令 | 指令格式 | 说明 |
|---|---|---|
| 添加大学习 | 添加大学习地区 |
添加大学习湖北 添加大学习 |
| 我的大学习 | 我的大学习 | 查询个人信息 |
| 提交大学习 | 提交大学习x期 戳一戳Bot |
提交一期（默认最新一期）大学习 |
| 大学习 | 大学习答案、大学习、答案截图 | 获取最新一期青年大学习答案 |
| 完成截图 | 完成截图x期、大学习截图x期、大学习完成截图x期 |
获取青年大学习一期（默认最新一期）完成截图（带状态栏） |
| 完成大学习 | 完成大学习、全员大学习 | 团支书可用，需要成员填写团支书ID，填写后团支书可发指令提交大学习 |
| 重置配置 | 重置配置、刷新配置 | 超管可用，刷新Web UI默认配置 |
| 重置密码 | 重置密码 | 重置登录Web UI的密码为用户ID |
| 删除大学习 | 删除大学习 | 用户申请清除数据库的信息 |
| 导出用户数据 | 导出用户数据、导出数据 | 将数据导出至TeenStudy目录下 |
| 更新用户数据 | 更新用户数据、刷新用户数据 | 将用户数据导入到数据库 |
| 更新资源数据 | 更新资源数据、刷新资源数据 | 更新数据库中的资源数据（江西共青团团支部数据） |
- 增加更多地区支持
- 优化 Bot
- 因江西共青团屏蔽H5端使用，无法简单获取openid,回退之前版本改用伪造openid提交
- 移除对江西地区提交往期大学习支持
- 修复湖北地区提交最新一期失败问题
- 修复获取最新一期大学习报网络延迟无法获取问题
2023/10/30
- 破坏性·更改青年大学习答案数据库结构，请登录管理后台清空大学习列表后重启
- 增加陕西地区
三秦青年，token时效待测试 - 增加江西地区提交往期青年大学习功能
- 增加山东地区提交往期青年大学习功能
- 后台大学习列表支持提交往期大学习(目前仅湖北，江西，山东地区有效，其余地区均提交最新一期)
- 更改江西共青团绑定账号方式，与自己账号同步，江西地区用户可删除账号重新添加
- 移除提交时间限制
- 修复上海地区提交失败问题
- 修复单独发送
提交大学习报期数无效问题 - 修复后台Icon图表缺失问题
2023/10/13
- 修复使用页面提交失败BUG
- 修复页面无法更新BUG
2023/09/11
- 修复江西地区组织获取失败BUG
- 完成截图状态栏随机时间范围调整为2~5分钟
- 开放获取往期完成截图功能,指令为
完成截图 x期示例：完成截图2023年第18期 - 湖北地区(其余地区等待适配)开放提交往期大学习功能，指令为
提交大学习 x期示例：提交大学习2023年第18期 - 项目进入重构状态，计划使用
node.jsvue.jstypescriptexpressviteelement-plusmongoDB搭建API服务端(带Web UI)适配多平台
2023/08/31
- 因项目特殊性，将项目移交至组织
- 因ZM25XC个人原因，维护人员变更为TeenStudyFlow
- 优化更新获取最新一期答案的算法
- 因使用QQNT无法查看回复中的图片，项目将所有涉及回复改成单独发送
2023/06/12
- 适配北京地区，无需抓包
- 增加天津地区，需要自行抓包
- 因江苏和黑龙江地区Cookie时效小于1周，移除江苏和黑龙江地区
- Web UI添加日志和主动退出功能
- 更新江西地区拉取团支部数据方式，移除缓存团支部数据，包体积减小50%
- 修复大学习公网检测失败问题
- 更新Nonebot2强制meta字段
- 同步UI依赖AMIS版本到最新版本
- 开放体验群，不会搭建又想使用的可加QQ体验群
2023/05/21
- 增加黑龙江地区，需要自行抓包，该地区上线测试中，请积极提issue反馈
- 下版本为大版本更新，将添加新功能，优化功能，请积极提issue反馈或加交流群反馈
2023/05/06
- 增加吉林地区，需要自行抓包
- 修复超管更改登录密码后用原密码能继续登录问题
- 添加二维码转链接开关，需要自行在后台配置页面打开
- 调整部分依赖
2023/04/12
2023/03/18
- 适配河南地区，需要自行抓包
- 适配四川地区，需要自行抓包
- 适配山东地区，需要自行抓包
- 适配重庆地区，需要自行抓包
- 添加自动获取公网IP功能，别再问如何配置公网IP啦
- 添加重置密码功能，指令
重置密码 - 添加重置配置功能，指令
重置配置，刷新配置 - 添加完成大学习功能，团支书可一次性提交全班的大学习，指令
完成大学习，全员大学习 - 管理后台开放添加用户权限（浙江，上海地区无法添加）
- 优化用户信息页
- 优化登录界面提示
- 将添加链接，登录链接转化成二维码，减少公网IP暴露，没啥用，样式好看一些
- 修复Ubuntu系统导入资源失败BUG
2023/03/05
- 适配浙江地区，使用微信扫码进行绑定
- 适配上海地区，使用微信扫码进行绑定
- 适配江苏地区，需要自行抓包
- 适配安徽地区，需要自行抓包
2023/03/01
- 将代码上传至pypi，可使用
pip install TeenStudy指令安装本插件 - 上传基础代码
- 适配湖北地区，无需抓包，安装即用
- 适配江西地区，无需抓包，安装即用