用途:本技能驱动 navitime-pp-cli 二进制,用 NAVITIME 数据判断日本某段行程是否适配既定行程安排,并在地点名称有歧义时返回候选位置;订票和更广泛的行程优化不属于本技能范围。
安装:可用 Printing Press 安装器执行 npx -y @mvanhorn/printing-press-library install navitime --cli-only;若安装失败(无 Node、离线等),可改用 go install github.com/mvanhorn/printing-press-library/library/travel/navitime/cmd/navitime-pp-cli@latest(需 Go 1.26.6 或更新)。安装后需确保二进制所在目录在 $PATH 中,运行 navitime-pp-cli --version 验证。
主要能力:places search 返回双语候选(如 navitime-pp-cli places search 大久保 --type station --agent);routes search 查询指定日期的发车、截止时间与首末班(如 navitime-pp-cli routes search --from station:00006668 --to station:00001756 --depart-at 2026-10-01T09:00 --agent);routes show --latest 展开已存路由并查看跨日边界与票价假设;routes compare 按时间、票价、步行和换乘比较方案;passes list 列出宣传中的周游券及其验证状态。
使用方式:默认输出紧凑 JSON,--agent 保留字段路径并加入非交互默认值;可用 --select 或 --fields 投影字段,--pretty 供人阅读,诊断与 --metrics 输出到 stderr。可用 NAVITIME_CACHE_DIR 或 --cache-dir 隔离缓存,--refresh 绕过缓存读取,--no-cache 跳过读写;--refresh 之外的 routes show 读取带原始抓取时间的历史快照。运行 navitime-pp-cli doctor 验证环境。
限制:已验证的日本旅行网页接口无需 API 密钥或订阅,运行时使用兼容 Firefox 的 HTTP,无需运行浏览器或导入 Cookie。退出码 0 表示完成,2 表示用法无效,3 表示缺少数据,其他非零表示来源、限流或运行时故障;临时来源校验失败属于错误,应暂停重试而非推断无路线。无偏移的日期时间按 Asia/Tokyo 解释,输出时间戳带偏移。时刻表不能代表实时运行或座位库存;本 CLI 不订票、不购买周游券、不计算持券者自付费用,也不优化多段行程。票价比较需注意其所述基准(含出租车估算)。MCP 服务为可选本地构建(go build -o navitime-pp-mcp ./cmd/navitime-pp-mcp),通过 stdio 提供,仅在用户要求改配置时注册。