nonebot-plugin-course-schedule 1.3.0

电子课程表

电子课程表

✨ 从 https://github.com/advent259141/astrbot_plugin_CourseSchedule 移植 ✨

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

✨ 功能特性

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

💿 安装

使用 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-02、2026.04.02
• 中文日期：昨天、前天、明天、后天、4月2号、4月2日
• 星期描述：周三、星期三、下周三

❓ 如何获取 .ics 文件？

将你的课表导入课表软件（如 Wakeup课程表 或类似应用），然后从软件的设置中选择“导出”，并导出为日历文件（通常文件后缀为 .ics），即可获得所需文件。

🤝 贡献

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

特别感谢

• Maple Mono