nonebot-plugin-railwaytools

这是一个火车迷也许觉得很好用的铁路工具箱，具有多种功能。

Required 🔨

• Python >= 3.9

• 需提前安装以下依赖库：

pip install httpx

Getting Started 🚀

• 1.使用 nb-cli 安装：在 nonebot2 项目的根目录下打开命令行，输入以下指令即可安装

nb plugin install nonebot-plugin-railwaytools

• 2.可通过pip安装该插件

pip install nonebot-plugin-railwaytools

• 2.将本repo中的nonebot-plugin-railwaytools文件夹clone到机器人的src\plugins目录中，即可使用。

git clone https://github.com/leaf2006/nonebot-plugin-railwaytools.git

Features ✨

功能简明介绍

注⚠️：/下关站 功能将于v2.2.8废弃，建议使用/机车信息

功能详细介绍

• 通过车次查询担当的动车组车组号：/车号 [动车组车次] 或 /ch [动车组车次]（例如：/车号 D3211）

example：
🤵：/车号 D3211
🤖：
D3211次列车近8次担当的车组号为：
2025-11-28 12:59：CRH2A2158
2025-11-27 12:59：CRH2A2190
2025-11-26 12:59：CRH2A2158
2025-11-25 12:59：CRH2A2030
2025-11-24 12:59：CRH2B2115
2025-11-23 12:59：CRH2B2116
2025-11-22 12:59：CRH2B2115
2025-11-21 12:59：CRH2A2006

数据来源：rail.re

• 通过动车组车组号查询担当车次：/车次 [动车组车组号] 或 /cc [动车组车组号]（例如：/车次 CRH2A-2001）

example：
🤵：/车次 CRH2A-2001
🤖：
CRH2A-2001近8次担当的车次为：
2025-11-28 20:14：D2212
2025-11-27 22:46：D3062
2025-11-27 15:05：D3060
2025-11-26 20:22：C3793
2025-11-26 13:57：D5666
2025-11-26 10:09：D5665
2025-11-25 17:29：C3896
2025-11-25 12:36：C3897

数据来源：rail.re

此功能与数据来源的网站一样，支持简略输入：CRH2A-2001可以输入2a2001、CR400BF-5033可以输入bf5033，以此类推

• 通过列车车次查询该车次的始发终到、担当客运段、车型信息、配属以及开行状态，同时支持动车组与普速列车：/查询 [列车车次] 或 /cx [列车车次] （例如：/查询 Z225）

example:
🤵：/查询 Z225
🤖：
车次：Z225（北京丰台——合肥）
担当客运段：合肥客运段
车型信息：25TAC380V
配属：合肥车辆段
Z225次02月06日北京丰台方面正常开行

----------停站信息----------
1.北京丰台：--:--到,21:59开，停车--分
2.阜阳：04:44到,04:50开，停车6分
3.霍邱：05:45到,05:49开，停车4分
4.六安：06:31到,06:34开，停车3分
5.合肥：07:41到,--:--开，停车--分
------------------------------

数据来源：12306

该功能同时还附带一个子命令：/查询 -实时，可以查询列车正晚点与当前已到达哪一站

example:
🤵：/查询 Z225 -实时
🤖：
车次：Z225（北京丰台——合肥）
担当客运段：合肥客运段
车型信息：25TAC380V
配属：合肥车辆段
Z225次02月06日北京丰台方面正常开行
列车始发站待发

----------停站信息----------
1.北京丰台：--:--到,21:59开，停车--分，正点运行
2.阜阳：04:44到,04:50开，停车6分，预计正点
3.霍邱：05:45到,05:49开，停车4分，预计正点
4.六安：06:31到,06:34开，停车3分，预计正点
5.合肥：07:41到,--:--开，停车--分，预计正点
------------------------------

数据来源：12306

• 通过车站名称查看车站大屏：/大屏 [车站名称] 或 /dp [车站名称] （例如：/大屏 上海）

example:
🤵：/大屏 上海
🤖：
【上海站】车站大屏如下：
 
------------------------------ 
【1】K738（上海——洛阳）
发车时间：12:42
候车室/检票口：10号候车室/10号候车室第2检票口,特殊通道检票口
状态：停止检票
------------------------------ 
【2】G2788（上海——深圳）
发车时间：12:50
候车室/检票口：6号候车室,7号候车室/6号候车室第2检票口,7号候车室第1检票口,特殊通道检票口
状态：正在检票
------------------------------ 
【3】G16（上海——北京南）
发车时间：12:55
候车室/检票口：5号候车室/5号候车室第1检票口,特殊通道检票口
状态：正在检票
------------------------------ 
【4】G7014（上海——南京）
发车时间：13:00
候车室/检票口：10号候车室,9号候车室/10号候车室第1检票口,9号候车室第1检票口,特殊通道检票口
状态：正点
------------------------------ 
【5】C3896（上海——连云港）
发车时间：13:01
候车室/检票口：6号候车室/6号候车室第1检票口,特殊通道检票口
状态：正点
------------------------------ 
【6】G8286（上海——宿迁）
发车时间：13:09
候车室/检票口：8号候车室/8号候车室第2检票口,特殊通道检票口
状态：正点
------------------------------ 
【7】G7248（上海——合肥南）
发车时间：13:14
候车室/检票口：7号候车室/7号候车室第2检票口,特殊通道检票口
状态：正点
------------------------------ 
【8】C3868（上海——南京）
发车时间：13:32
候车室/检票口：5号候车室/5号候车室第2检票口,特殊通道检票口
状态：正点
------------------------------ 
【9】G7772（上海——黄山北）
发车时间：13:39
候车室/检票口：8号候车室/8号候车室第1检票口,特殊通道检票口
状态：正点
------------------------------ 
【10】K1102（上海——安阳）
发车时间：13:40
候车室/检票口：6号候车室/6号候车室第2检票口,特殊通道检票口
状态：正点
------------------------------ 

仅显示该车站部分列车信息。本车站大屏来源于第三方API，及供参考，请勿用于实际乘车！

• 查询某条铁路基本信息：/线路 或 线路信息 或 /xl

example:
🤵：/线路 宣杭
🤖：
【宣杭线】线路信息：
线路类型：普速铁路
单/复线：复线铁路
设计时速：暂无数据

----------沿途车站----------
【1】宣城         0Km
【2】建国
【3】十字铺
【4】誓节渡
【5】广德         63Km
【6】泗安
【7】大云
【8】长兴南         114Km
【9】湖州西
【10】湖州         133Km
【11】妙西
【12】梅峰
【13】德清西         172Km
【14】沈家塘
【15】星桥
【16】乔司
【17】杭州         240Km
------------------------------

*本表所列起点终点为该线路里程接算站，里程为营业用运价里程，与线路实际运行长度并不相同
数据来源：cnrail.geogv.org

• 查询某车站基本信息：/车站 或 /车站信息 或 /cz

example:
🤵：/车站 上海
🤖：
【上海】基础信息如下：
电报码：SHH
所属路局：中国铁路上海局
位置：上海市 静安区
本站办理客运业务
------------------------------
【沪宁城际线】
下站（南京）方向：上海西
上站：起迄站
------------------------------
【沪昆线】
下站（昆明）方向：上海西
上站：起迄站
------------------------------
【京沪线】
下站：起迄站
上站（北京）方向：上海西
------------------------------

数据来源：cnrail.geogv.org

由于cnrail的更新，现在还支持查询地铁车站。建议在查询地铁站时，在地铁站名后加“地铁站”二字，方便搜索

• 通过车号查询机车/动车组基本信息：/机车信息 [机车车号] 或 /jccx [机车车号] （例如：/机车信息 HXD1D-1898）

新版的功能采用两个数据源：轨上名录（leaf2006/CR-Locomotive-Allocation）与下关站（xiaguanzhan.com），查询时会优先使用轨上名录的数据，结果返回速度提升显著

example:
🤵：/机车信息 HXD1D-1898
🤖：
【HXD1D-1898】共检索到1个结果：
------------------------------
【HXD1D-1898在下关站中的配图】
车号：HXD1D-1898
配属：上局沪段
生产厂家：中车株洲机车
拍摄者：PVG的拂晓ALPHA
拍摄日期：202107
------------------------------
数据来源：轨上名录 CR-Locomotive-Allocation
项目地址：github.com/leaf2006/CR-Locomotive-Allocation

如轨上名录上没有结果（通常因为车型过老），则自动使用下关站数据源进行查询

• 帮助：/帮助 或 /help

example:
🤵：/help
🤖：
✨一个火车迷也许觉得很好用的铁路工具箱，具有多种功能✨ 
 
----------使用方法----------
① 通过车次查询担当的动车组车组号：/车号 或 /ch （例如：/车号 D3211） 
 
② 通过动车组车组号查询担当车次：/车次 或 /cc （例如：/车次 CRH2A-2001） 
 
③ 通过列车车次查询该车次的始发终到、担当客运段、车型信息、配属以及具体时刻表，同时支持动车组与普速列车：/查询 或 /cx （例如：/查询 Z225）
【子命令】 -实时：查询列车正晚点与当前已到达哪一站（例如：/查询 Z225 -实时）
 
④ 通过车站名称查看车站大屏：/大屏 或 /dp （例如：/大屏 上海）
 
⑤ 查询某条铁路基本信息：/线路 或 /xl （例如：/线路 宣杭铁路） 
 
⑥ 查询某车站基本信息：/车站 或 /cz （例如：/车站 上海） 
 
⑦ 通过车号查询机车/动车组基本信息：/机车信息 或 /jcxx （例如：/机车信息 HXD1D-1898） 
 
⑧ 帮助：/帮助 或 /help 
 
更多功能正在开发中，尽情期待！ 
------------------------------ 
 
Powered by Nonebot2
Copyright © Leaf developer 2023-2026

数据来源

• 动车组交路数据来源于：https://rail.re
• 机车/动车组信息来源于：
  • 轨上名录（CR-Locomotive-Allocation）：https://github.com/leaf2006/CR-Locomotive-Allocation
  • 下关站：http://www.xiaguanzhan.com/
• 列车查询数据来源于12306
• 车站大屏数据来源于第三方API，数据结果不一定准确，请仔细甄别
• 车站、线路基本信息来源于：http://cnrail.geogv.org/zhcn/

特此注明，并表达敬意