这是一个课程表插件,帮助群组成员方便地管理和查询自己以及群友的课程安排。
✨ 功能特性
- 与原本插件相同的部分不再赘述
- 将课程表与群聊分离,只和用户有关
- 命令支持偏移参数或指定日期
- 课表图片可以自适应显示,防止超长课程名
- 现在可以显示课程地点
- 对于相同时间相同名称的课程可以去重
- 支持课前自动提醒,提醒时间可配置
💿 安装
使用 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 来改进这个插件!
特别感谢
Metadata
Release files for nonebot-plugin-course-schedule 1.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_course_schedule-1.3.1.tar.gz | 9.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_course_schedule-1.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.0 MB
Release files / nonebot_plugin_course_schedule-1.3.1.tar.gz
| Download URL | nonebot_plugin_course_schedule-1.3.1.tar.gz |
|---|---|
| Size | 9.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5696e92c9b0d3b89790b5901512b5dbab36fd624c1bf75bddd41c79c4478e6de
|
|
BLAKE2b-256 checksum How to use checksums |
94c75281bfea83ac727fcc9ab201e430180439c985f1b6aa064eaf51b92a14fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 26, 2026.
Transparency logRelease files / nonebot_plugin_course_schedule-1.3.1-py3-none-any.whl
| Download URL | nonebot_plugin_course_schedule-1.3.1-py3-none-any.whl |
|---|---|
| Size | 9.5 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0bd4aa95d569f529d53a9849e4a87723ee00b6ee6f1f712c7011e6d9e5aef063
|
|
BLAKE2b-256 checksum How to use checksums |
aad46641decd5123becb3cd3c7408cd99870798d7bf5cb4cc3edc19915b7e00b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 26, 2026.
Transparency log