用途:通过 jalan-pp-cli 在 Jalan 上发现并比较日本住宿。适合筛选候选住宿、查看具体的房间/套餐证据,或在相同入住人数条件下比较有限日期选项。官方说明明确不适用于预订、支付、预约变更/取消、优惠券领取、账号奖励、其他住宿供应商,也不用于任意日英翻译。
主要能力:包含 stay locations(解析目的地及其日文名称)、stay search(按日期和每间房人数搜索)、stay property(设施、交通、评价类别)、stay offers(带日期的房型/套餐组合)、stay plan(具体套餐/房间的条款与价格细分)、stay compare(相同人数下的替代方案比较)。命令默认输出紧凑 JSON,可用 --agent --select 精简字段;使用前建议查看 .meta 时效性、.pagination 覆盖范围和 .fetch_failures,证据 source_ref 经 .meta.sources 解析。
使用方式:源码检出时用 go build -o bin/jalan-pp-cli ./cmd/jalan-pp-cli 构建,再以 ./bin/jalan-pp-cli 调用。发布目录安装可执行 npx -y @mvanhorn/printing-press-library install jalan --cli-only,随后用 jalan-pp-cli --version 验证;npx 失败时可回退 go install github.com/mvanhorn/printing-press-library/library/travel/jalan/cmd/jalan-pp-cli@latest。需保证安装目录在 PATH 中,可用 jalan-pp-cli doctor 检查,用 jalan-pp-cli stay --help 浏览命令。公开住宿命令无需凭证,旧 API 注册已关闭。
限制与注意事项:需使用未来日期,价格与库存不保证;日期时间按 Asia/Tokyo,库存默认实时,--max-age 复用观测、--refresh 重新抓取;无匹配、不可用、输入不支持、部分结果和访问错误结论不同;比价只覆盖已抓取子集;套餐 ID、房间 ID 需保持区分,前导零有意义;儿童类别与偏好筛选以当前 help 为准。价格需保留来源单位,基础报价、条件性优惠、积分与额外费用是不同事实,最终应付金额可能未知。浴室信息分设施与房间两个范围,私用、可预约、户外与温泉水相互独立,需保留否定证据。条款缺失即视为未知。资料未提供具体价格、收费或效果信息。