功能概述
SRT Skill 是一款针对韩国高速铁路（Super Rapid Train）的命令行工具，提供完整的票务生命周期管理，包括车次搜索、座位预订、订单查询和取消功能。该工具基于开源 SRTrain 库构建，支持自动化余票监控与抢票场景。
核心用法
基础操作
- 搜索车次：指定出发站、到达站、日期（YYYYMMDD）和时间（HHMMSS），返回可用车次列表
- 即时预订：通过
train_id一键预订搜索结果中的指定车次 - 订单管理：查看现有预订（JSON格式输出）及按 reservation_id 取消订单
高级功能：连续余票监控（취소표 모니터링）
专为韩国高铁"取消票"抢购场景设计：
1. 先执行搜索缓存目标车次信息
2. 启动后台持久化进程（make_reservation.py --retry），支持 24 小时轮询
3. 配置独立 cron 作业监控日志状态，成功或超时后自动清理
显著优点
- 官方数据直连：基于 SRT 网页接口，非第三方票务平台，无加价风险
- 自动化抢票：支持后台持续轮询（10秒间隔），捕获实时退票释放
- 结构化输出：搜索和预订结果均提供 JSON 格式，便于脚本集成
- 进程隔离设计：监控任务与报告任务分离，避免 cron 作业堆积
潜在局限
- 韩语环境依赖：车站名称必须使用韩文（수서、동대구等），无罗马音支持
- 支付需手动完成：预订成功后需在 20 分钟内通过官方 App 或网站付款
- 账号安全风险：需明文存储
SRT_PHONE和SRT_PASSWORD环境变量 - 单账户限制：受 SRT 官方反爬虫策略约束，高频请求可能触发限流
适合人群
- 常驻或短期访问韩国、需频繁搭乘 SRT 的商务/通勤人士
- 韩语能力足够的用户（能理解车站名和输出信息）
- 具备基础命令行和 cron 配置经验的技术用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 账号安全 | 凭证以环境变量形式存储 | 使用专用 SRT 子账户，避免主账号暴露 |
| 预订失效 | 20 分钟内未付款导致自动释放 | 启用即时通知，预留付款操作时间 |
| 服务中断 | SRT 官网改版导致接口失效 | 关注 SRTrain 库更新，预留替代方案 |
| 合规争议 | 高频自动请求可能违反服务条款 | 控制轮询频率，避免峰值时段过度请求 |
技术依赖
- Python 3 + uv 包管理器
- 环境变量：
SRT_PHONE（格式 010-XXXX-XXXX）、SRT_PASSWORD - 可选：
SRT_DATA_DIR自定义日志/缓存目录