核心用法
jisu-train 是基于极速数据（Jisu Data）火车查询 API 的 OpenClaw 技能，提供三种查询模式：
1. 站站查询（station2s）：输入出发站与到达站，获取所有车次列表，含出发/到达时间、行程时长、票价（一等座/二等座）等信息，支持 ishigh 参数筛选高铁。
2. 车次查询（line）：输入车次号（如 G34），获取完整经停站序、各站到达/发车时刻及停留时间。
3. 余票查询（ticket）：指定日期、出发/到达站，返回各车次余票数量（商务座/一等座/二等座）。
调用方式统一为 CLI 形式：python3 skills/train/train.py <mode> '<json_params>'
显著优点
- 数据维度完整：覆盖时刻、票价、余票、里程等多维信息，满足出行决策全链路需求。
- 接口轻量：RESTful 设计，JSON 返回，易于解析和二次开发。
- 灵活筛选：支持高铁/普快过滤、日期指定，适配不同场景。
- 中文站名直接输入：无需记忆电报码或拼音缩写。
潜在缺点与局限性
- 需外部 API Key：非开箱即用，用户须自行至 jisuapi.com 注册申请，存在审核门槛与潜在费用（免费额度有限）。
- 数据时效依赖第三方：余票信息非12306官方直连，可能存在延迟或更新不及时；高峰期准点率存疑。
- 错误码简陋：仅 201-203 三个错误码，诊断能力不足。
- 无身份鉴权细控：仅单一 API Key，无用户级权限管理。
- 历史文档示例陈旧：如余票查询示例使用 2015 年日期，可能暗示维护频率一般。
适合人群
- 需快速集成火车查询能力的开发者或自动化工作流用户。
- 对 12306 官方接口开发门槛敏感、愿意接受第三方数据精度的场景。
- 个人出行助手、企业内部差旅系统的轻量补充模块。
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据准确性 | 第三方聚合数据与 12306 官方可能存在偏差，余票/票价仅供参考，不作为购票依据。 |
| API 稳定性 | 服务商策略变更、额度耗尽或停服将直接导致技能失效。 |
| 密钥泄露 | `JISU_API_KEY` 以环境变量存储，若配置不当（如日志打印、版本控制提交）存在泄露风险。 |
| 合规风险 | 爬取或转售铁路数据需关注数据源授权边界，商用需确认服务商协议。 |