NoneBotPluginText

NoneBot-Plugin-CNRail

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

💿 安装

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

[推荐] 使用 nb-cli 安装

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

nb plugin install nonebot-plugin-cnrail

使用包管理器安装

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

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 查看帮助

效果图

📞 联系

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

Metadata

Release files for nonebot-plugin-cnrail 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nonebot-plugin-cnrail 0.4.3
File	Size	Uploaded
nonebot_plugin_cnrail-0.4.3.tar.gz	40.2 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-cnrail 0.4.3
File	Interpreter	ABI	Platform	Reset
nonebot_plugin_cnrail-0.4.3-py3-none-any.whl 17.1 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 57.3 kB

Release files / nonebot_plugin_cnrail-0.4.3.tar.gz

Download URL	nonebot_plugin_cnrail-0.4.3.tar.gz
Size	40.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`48fd42a39899ca083ee4f3f4e2bed087005d005d1133d6240cb36b47bcc5a80e`
BLAKE2b-256 checksum How to use checksums	`e94af81f7ebed7f28899c4bc8641b143932bff17dadc9df54a04ec5960d03a27`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / nonebot_plugin_cnrail-0.4.3-py3-none-any.whl

Download URL	nonebot_plugin_cnrail-0.4.3-py3-none-any.whl
Size	17.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`03979d86f219402f429faf6ed7bdab3ef89f3584866cc0083ef5a0fefc2b27c9`
BLAKE2b-256 checksum How to use checksums	`78958fb7efe2e8a838a8688b094c25bad99c52191293301a03a792653b41877a`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`