12306购票搜索

要解决什么问题

在对话里查火车票，模型若自行「猜」余票或车站编码，结果既不可信也违反 12306 的数据形态。本技能把查询交给 小笨羊科技 提供的后端 API，Agent 只负责理解意图、选工具、凑齐 station_code 与日期等参数，再把 result["raw"] 整理给用户。

核心能力与工作方式

技能基于 Model Context Protocol (MCP)，对外是一组 scripts.tools 函数，典型链路如下：

• 密钥：首次若 .env 无 XBY_APIKEY，须用 AskUserQuestion 向用户索取，再调用 scripts.config.set_api_key 持久化；密钥在 xiaobenyang.com 获取。
• 车站编码：用户说城市名时用 get_station_code_of_citys；说具体站名用 get_station_code_by_names；查一城多站用 get_stations_code_in_city。余票接口 禁止 直接传中文地名。
• 日期：相对说法（「明天」「下周三」）先调 get_current_date（上海时区 yyyy-MM-dd），再算目标日。
• 查票：直达余票 get_tickets（可按 G/D/Z 等筛选、时段、排序、条数限制，格式 text/csv/json）；中转 get_interline_tickets（默认最多前十条）；某车次经停 get_train_route_stations。

模型是路由层：缺参数就追问，参数齐则用 关键字参数 调工具，成功与否看 success 与 message，展示以 raw 为准。

边界与注意点

• 无 API 密钥时不得查询或编造数据，这是 SKILL 里的硬约束。
• 中转查询目前只支持返回有限条数（文档写明前十条）。
• get_station_by_telecode 多用于调试或已知 telecode 的补全，日常对话较少直接用到。