NoneBot-Plugin-CNRail

✨ 12306 列车时刻表查询插件 ✨

💿 安装

以下提到的方法 任选其一 即可

[推荐] 使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-cnrail

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

uv

uv add nonebot-plugin-cnrail

pip

pip install nonebot-plugin-cnrail

pdm

pdm add nonebot-plugin-cnrail

poetry

poetry add nonebot-plugin-cnrail

conda

conda install nonebot-plugin-cnrail

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

[tool.nonebot]
plugins = [
    # ...
    "nonebot_plugin_cnrail"
]

⚙️ 配置

配置项	必填	默认值	说明
CNRAIL_ACG_IMAGE_URL	否	https://www.loliapi.com/acg/pe/	用于指令返回图片背景的图片 URL

🎉 使用

使用指令 train -h 查看帮助

效果图

Details

📞 联系

QQ：3076823485
Telegram：@lgc2333
吹水群：168603371
邮箱：lgc2333@126.com

💡 鸣谢

海兰德小助手 & Train-QQBot 插件

灵感来源

RailGo 数据服务

数据来源

💰 赞助

赞助我

感谢大家的赞助！你们的赞助将是我继续创作的动力！

📝 更新日志

0.4.3

• 修复 Pydantic V1 环境下查询必定报错的问题（模型无法按字段名构造），配置键改用 V2 全系通用写法
• 修复 02-29 无法解析的问题，并改用不依赖「无年份日期解析」的写法（该行为自 Python 3.14 起弃用、3.15 将变更）
• CNRAIL_ACG_IMAGE_URL 现在会校验是否为合法的 http(s) 链接，配置非法时插件加载即报错
• 车组号查询失败不再导致整次查询失败，仅不显示车组号
• 修复 -h 与参数错误的回复未带上「使用指令 train -h 查看帮助」提示的问题
• 新增 pytest 测试套件与 CI

0.4.2

• 修复 Pydantic V2 下查询必定报错的问题（模型无法按字段名构造）

0.4.1

• 改用 RailGo 提供的数据

0.4.0

• drop htmlrender v0.8 适配，仅兼容 v0.7 与 v0.6
• 动态取色移至 Python 侧，删除 js 构建步骤

0.3.2

• bump htmlrender 到 v0.8

0.3.1

• 修复 MoeFactory API 调用错误

0.3.0

• 图片换用 Material Design 风格的莫奈（Monet）取色方案
• 修复 API 请求

0.2.3

• 更换上游 API 域名

0.2.2

• 修复列车行驶进度条计算问题（fix by @This-is-XiaoDeng）

0.2.1

• 适配 MoeFactory API
• 新增配置项 CNRAIL_ACG_IMAGE_URL

0.2.0

• 适配 Pydantic V1 & V2
• 样式微调

0.1.7

• 添加车组号显示（无法显示未来日期的车组号信息）
• bug fix

0.1.6

• 添加担当路局显示 & 改次列车查询

0.1.5

• 修复 -h 参数无效的问题

0.1.4

• 现在缺少参数会提示了

0.1.3

• fix #2

0.1.2

• 支持选择日期查询（日期范围为前二日 ~ 后十四日）

0.1.1

• 修复查询到多个车次不会提示的问题

0.1.0

• 🎉 Create this project