TeenStudy
基于nonebot2和OneBot V11协议的青年大学习自动提交插件，用于自动完成最新一期青年大学习，在后台留下记录，返回完成截图
Install / Use
/learn @YouthLearning/TeenStudyREADME
说明
- 本项目基于nonebot2和OneBot V11协议，使用本插件前请先阅读以上两个项目的使用文档
- 启动插件之后，一定要登录后台在推送列表中添加需要开启大学习功能的群聊
- 本项目无法在中国大陆地区（除港、澳、台）外的IP环境下使用，如有开启代理，请关闭或添加代理规则
- 需要抓包的地区，绑定后尽量别进官方公众号，避免token或cookie刷新导致无法提交
- 本项目需要部署在公网可访问的容器中，并开放端口（nonebot2配置的port），否则大部分功能将出现异常
- 欢迎加入QQ反馈群，交流讨论，如您不会搭建又想每周自动提交，可加入QQ体验群。
- 时间精力有限，目前只维护
湖北和江西两个地区，其他地区出问题请提交Issues,我找个时间修，需要增加地区请进群帮忙测试，个别地区没账号无法测试 - 觉得项目不错，不妨点个stars.
地区状态
<details>| 共青团名称 | 开发状态 | 备注 | | :----------: | :------: | :--------------------------: | | 青春湖北 | 支持 | 无需抓包，支持提交往期青年大学习 | | 江西共青团 | 支持 | 无需抓包，不支持提交往期青年大学习 | | 安徽共青团 | 支持 | 无需抓包，不支持提交往期青年大学习 | | 广东共青团 | 支持 | 无需抓包，不支持提交往期青年大学习 | | 青春北京 | 支持 | 无需抓包，不支持提交往期青年大学习 | | 青春上海 | 支持 | 微信扫码绑定，不支持提交往期青年大学习，只能提交最新一期 | | 青春浙江 | 支持 | 微信扫码绑定，不支持提交往期青年大学习，只能提交最新一期 | | 津彩青春 | 支持 | 需要自行抓包，不支持提交往期青年大学习 | | 青春山东 | 支持 | 需要自行抓包，支持提交往期青年大学习 | | 重庆共青团 | 支持 | 需要自行抓包 | | 吉青飞扬 | 支持 | 需要自行抓包 | | 天府新青年 | 支持 | 绑定好信息后不进入天府新青年云token时效为100Years | | 三秦青年 | 支持 | 需要自行抓包，token时效未知，待测试，支持提交往期青年大学习 | | 河南共青团 | 不支持 | cookie时效小于1周 | | 江苏共青团 | 不支持 | cookie时效小于1周 | | 黑龙江共青团 | 不支持 | cookie时效小于1周 | | 广西青年圈 | 待开发 | | | 青春湖南 | 待开发 | | | 甘肃青年 | 待开发 | | | 山西青年 | 待开发 | | | 河北共青团 | 待开发 | | | 福建共青团 | 待开发 | | | 内蒙古青年 | 待开发 | | | 云南共青团 | 待开发 | | | 海南共青团 | 待开发 | | | 青春黔言 | 待开发 | | | 青春柳州 | 待开发 | | | 辽宁共青团 | 待开发 | | | 宁夏共青团 | 待开发 | | | 新疆共青团 | 待开发 | | | 西藏共青团 | 待开发 | |
</details>安装及更新
<details> <summary>第一种方式(不推荐)</summary>- 使用
git clone https://github.com/YouthLearning/TeenStudy.git指令克隆本仓库或下载压缩包文件
- 使用
pip install TeenStudy来进行安装,使用pip install TeenStudy -U进行更新 - 使用
nb plugin install TeenStudy来进行安装,使用nb plugin install TeenStudy -U进行更新
导入插件
<details> <summary>使用第一种方式安装看此方法</summary>-
将
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目录下 |
| 更新用户数据 | 更新用户数据、刷新用户数据 | 将用户数据导入到数据库 |
| 更新资源数据 | 更新资源数据、刷新资源数据 | 更新数据库中的资源数据（江西共青团团支部数据） |
ToDo
- [ ] 增加更多地区支持
- [ ] 优化 Bot
更新日志
2023/12/03
- 因江西共青团屏蔽H5端使用，无法简单获取openid,回退之前版本改用伪造openid提交
- 移除对江西地区提交往期大学习支持
- 修复湖北地区提交最新一期失败问题
- 修复获取最新一期大学习报网络延迟无法获取问题
- 破坏性·更改青年大学习答案数据库结构，请登录管理后台清空大学习列表后重启
- 增加陕西地区
三秦青年，token时效待测试 - 增加江西地区提交往期青年大学习功能
- 增加山东地区提交往期青年大学习功能
- 后台大学习列表支持提交往期大学习(目前仅湖北，江西，山东地区有效，其余地区均提交最新一期)
- 更改江西共青团绑定账号方式，与自己账号同步，江西地区用户可删除账号重新添加
- 移除提交时间限制
- 修复上海地区提交失败问题
- 修复单独发送
提交大学习报期数无效问题 - 修复后台Icon图表缺失问题
- 修复使用页面提交失败BUG
- 修复页面无法更新BUG
- 修复江西地区组织获取失败BUG
- 完成截图状态栏随机时间范围调整为2~5分钟
- 开放获取往期完成截图功能,指令为
完成截图 x期示例：完成截图2023年第18期 - 湖北地区(其余地区等待适配)开放提交往期大学习功能，指令为
提交大学习 x期示例：提交大学习2023年第18期 - 项目进入重构状态，计划使用
node.jsvue.jstypescriptexpressviteelement-plusmongoDB搭建API服务端(带Web UI)适配多平台
- 因项目特殊性，将项目移交至组织
- 因ZM25XC个人原因，维护人员变更为TeenStudyFlow
- 优化更新获取最新一期答案的算法
- 因使用QQNT无法查看回复中的图片，项目将所有涉及回复改成单独发送
- 适配北京地区，无需抓包
- 增加天津地区，需要自行抓包
- 因江苏和黑龙江地区Cookie时效小于1周，移除江苏和黑龙江地区
- Web UI添加日志和主动退出功能
- 更新江西地区拉取团支部数据方式，移除缓存团支部数据，包体积减小50%
- 修复大学习公网检测失败问题
- 更新Nonebot2强制meta字段
- 同步UI依赖AMIS版本到最新版本
- 开放体验群，不会搭建又想使用的可加QQ体验群
- 增加黑龙江地区，需要自行抓包，该地区上线测试中，请积极提issue反馈
- 下版本为大版本更新，将添加新功能，优化功能，请积极提issue反馈或加交流群反馈
- 增加吉林地区，需要自行抓包
- 修复超管更改登录密码后用原密码能继续登录问题
- 添加二维码转链接开关，需要自行在后台配置页面打开
- 调整部分依赖
- 因河南地区cookie时效小于1周，移除河南地区
- 添加
删除大学习功能，用户可自行删除数据 - 添加
导出用户数据功能 - 添加
更新用户数据功能 - 添加
更新资源数据功能，江西地区更新后请使用下此功能刷新团支部数据 - 添加戳一戳提交大学习开关，默认开启，请在Web UI后台配置页面进行修改
- 添加大学习提醒开关，默认开启，支持修改时间，请在Web UI后台配置页面进行修改
- 添加自动提交大学习开关，默认开启，支持修改时间，请在Web UI后台进行修改
- 调整安徽地区添加方式#9，无需抓包，感谢[@yhzcake](https:
Related Skills
node-connect
350.1kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
109.9kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
350.1kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
qqbot-media
350.1kQQBot 富媒体收发能力。使用 <qqmedia> 标签，系统根据文件扩展名自动识别类型（图片/语音/视频/文件）。
