用途：根据起讫站与台北本地时间，查询台湾高铁后续约16班列车时刻，适合安排出差、演讲行程或填写「到达某高铁站时间」等字段。
主要能力：输出车次、出发、抵达、费时（HH:MM）与中间停靠站；停靠站由 station_info 在客户端筛选出起讫站之间的站点，停靠越少通常越快。API 每班还返回自由座车厢、备注、跨夜标记等字段。
使用方式：运行 python3 scripts/thsr.py [--json] <from> <to> [datetime]。站名须为精确的两字繁体中文，可选南港、台北、板桥、桃园、新竹、苗栗、台中、彰化、云林、嘉义、台南、左营；datetime 格式 YYYY-MM-DD HH:MM，为 Asia/Taipei 本地时间，省略则用当前时间；加 --json 返回原始 API JSON。示例：python3 .claude/skills/thsr-timetable/scripts/thsr.py 嘉義 台北 "2026-06-05 17:30"。
凭证：本技能不自带 token，需在 Superior APIs 页面注册并订阅该 API，取得个人 JWT（THSR_API_TOKEN）与代理端点 URL（THSR_API_URL），写入与 SKILL.md 同级的 .env。请求为 POST，头含 Content-Type: application/json 与 token，体为 start_station_no、end_station_no（1-12）与 ISO8601 datetime。
限制：时间为台北本地，勿预先转 UTC；API 只返回所给时间之后出发的班次，非「前后附近」；结果固定约16班，看全天需查询两次；站名必须精确，否则脚本报错并列出有效名称；不提供星期筛选，API 已过滤当日不运行的班次；token 为长期 JWT，无刷新流程，过期返回 HTTP 401 需重新复制；本技能只封装时刻表，不含票价，静态票价与 PDF 请见官方页面。.env 不应提交，仓库 .gitignore 已排除。