Skip to content

GLDYM/nonebot-plugin-course-schedule

Repository files navigation

这是一个课程表插件,帮助群组成员方便地管理和查询自己以及群友的课程安排。

✨ 功能特性

  • 与原本插件相同的部分不再赘述
  • 将课程表与群聊分离,只和用户有关
  • 命令支持偏移参数或指定日期
  • 课表图片可以自适应显示,防止超长课程名
  • 现在可以显示课程地点
  • 对于相同时间相同名称的课程可以去重
  • 修正 WakeUp 课程表导入单双周错误的问题
  • 支持课前自动提醒,提醒时间可配置

💿 安装

使用 nb-cli 安装 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
nb plugin install nonebot-plugin-course-schedule
使用包管理器安装 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
pip
pip install nonebot-plugin-course-schedule
pdm
pdm add nonebot-plugin-course-schedule
poetry
poetry add nonebot-plugin-course-schedule
conda
conda install nonebot-plugin-course-schedule

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入

plugins = ["nonebot_plugin_course_schedule"]

⚙️ 配置

在 nonebot2 项目的.env文件中添加下表中的配置

配置项 必填 说明
course_font_path 字体路径,默认插件目录下 resource/MapleMono-NF-CN-Medium.ttf
course_reminder_enabled 是否启用课前提醒,默认为 True
course_reminder_offset 课前提醒提前量(分钟),默认 30
course_reminder_interval 上课提醒检查间隔(分钟),默认 5,此值不应大于60 或 course_reminder_offset。

📝 命令列表

命令 功能描述
绑定课表 / 绑定课程 在群聊中发送此命令,然后根据提示发送你的 .ics 文件或 WakeUp 分享口令来绑定课表。
解绑课表 / 解绑课程 解绑你当前已绑定的课表,并从所有已加入群聊中移除。
绑定群聊课表 / 加入群聊课表 让自己显示在本群的课表中。
解绑群聊课表 / 退出群聊课表 将自己从本群课表展示中移除。
课表 / 查看课表 / 查看今日课表 / 查看我的课表 <日期> 显示你自己今天(或查询日期)接下来要上的课程。
群课表 / 群友上什么 / 群友在上什么 / 群友在上什么课 <日期> 显示群里所有成员当前正在上或下一节要上的课程(或查询日期将要上的课)。
上课排行 / 本周上课排行 显示本周群友上课时长和节数的排行榜。

其中 课表 / 群课表 参数支持偏移数字和自然语言描述:

  • 天数偏移:3-1
  • 标准日期:2026-04-022026.04.02
  • 中文日期:昨天前天明天后天4月2号4月2日
  • 星期描述:周三星期三下周三

❓ 如何获取 .ics 文件或 WakeUp 口令?

  • .ics 文件:将你的课表导入课表软件(如 Wakeup课程表 或类似应用),然后从软件的设置中选择“导出”,并导出为日历文件(通常文件后缀为 .ics),即可获得所需文件。
  • WakeUp 口令:在 WakeUp课程表 应用中,选择“分享课表”,然后选择“分享给好友”,复制生成的口令即可。

🤝 贡献

欢迎提交 Pull Request 或 Issue 来改进这个插件!

特别感谢

About

https://github.com/advent259141/astrbot_plugin_CourseSchedule 移植的电子课程表插件

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages