本文介绍如何在 firefox 中创建支持动态日期、地址别名（如“h”代表家、“w”代表公司）和双参数输入的 javascript 书签脚本，用于快速调用荷兰 ns 铁路行程规划器。
Firefox 的关键字搜索（Keyword Search）本身仅支持单 %s 占位符的简单字符串替换，无法直接处理动态时间、条件逻辑或地址映射。但通过将其与 JavaScript 书签（Bookmarklet） 结合，并配合地址栏关键词触发，可实现功能远超原生限制的智能行程规划入口。
✅ 正确实现方式：使用 Bookmarklet + Keyword Search
将以下代码保存为书签，并为其设置一个快捷关键字（例如 ns），即可在地址栏输入 ns 后回车，触发交互式行程规划：
javascript:(function(){
// ? 自定义地址别名（支持 Dutch/English 地名，按需修改）
const home = 'Amsterdam Centraal';
const work = 'Utrecht Centraal';
// ? 构建基础参数对象（注意：NS 的 URL 使用 fragment hash，但参数实际在 hash 后的 query-like 字符串中）
let params = {
vertrek: '',
vertrektype: 'treinstation',
aankomst: '',
aankomsttype: 'treinstation',
type: 'vertrek',
tijd: new Date().toISOString().slice(0, 16), // 格式：2024-06-15T09:32
firstMileModality: 'PUBLIC_TRANSPORT',
lastMileModality: 'PUBLIC_TRANSPORT',
disabledTransportModalities: ''
};
// ? 获取出发地（支持别名）
let startInput = prompt('出发地（输入 "h" 使用家地址）：', home);
params.vertrek = startInput === 'h' ? home : startInput.trim();
// ? 获取目的地（支持别名）
let endInput = prompt('目的地（输入 "w" 使用公司地址）：', work);
params.aankomst = endInput === 'w' ? work : endInput.trim();
// ⚠️ 注意：NS 行程规划器使用 #/ 前缀 + 查询参数（非标准 query string），需手动拼接
// 官方 URL 形式：https://www.ns.nl/reisplanner/#/?vertrek=...&aankomst=...
const baseUrl = 'https://www.ns.nl/reisplanner/#/';
const searchParams = new URLSearchParams(params).toString();
const finalUrl = `${baseUrl}?${searchParams}`;
// ? 跳转到生成的行程页
location.href = finalUrl;
})();? 使用步骤
- 新建书签：右键书签栏 → “添加网页书签”
- 名称：NS 行程规划器（任意）
- 网址（URL）：粘贴上方完整 javascript: 代码
- 设置关键字：在“关键字”字段填入 ns（或其他你喜欢的短词，如 tr）
- 使用：在地址栏输入 ns + 回车 → 弹出提示框 → 输入 h/w 或自定义车站名 → 自动跳转至带当前时间的 NS 规划页
? 关键注意事项
- ✅ 日期自动填充：new Date().toISOString().slice(0, 16) 精确输出 YYYY-MM-DDTHH:MM（符合 NS API 要求），无需手动计算时区（toISOString() 默认 UTC，NS 前端会自动适配本地时间显示）。
- ✅ 别名支持：h / w 在 prompt 中大小写敏感；若需忽略大小写，可改为 startInput.toLowerCase() === 'h'。
- ⚠️ NS URL 特性说明：该站点使用前端路由（#/），其 ? 后参数由 JS 解析，不能用 URLSearchParams 直接构造完整 URL 并跳转到 #/?... —— 但实测 location.href = 'https://.../#/?key=val' 完全兼容，浏览器正确传递 fragment 和 query。
- ⚠️ 空格与编码：用户输入中的空格会被 prompt 原样保留，NS 站点能正确处理（如 Amsterdam Centraal），无需手动 encodeURIComponent —— 因为 URLSearchParams 会自动编码值。
- ? 扩展建议：可增加更多别名（如 's' 代表学校）、记忆上次输入（localStorage）、或校验车站名格式（正则 /[A-Za-z\s]+Centraal$/）。
✅ 总结
原生 Firefox 关键字搜索不支持多参数、动态变量或逻辑判断，但借助 Bookmarklet + Keyword 组合，我们成功构建了一个轻量、可靠、用户友好的行程规划快捷入口：支持实时日期、地址别名、交互引导，且完全离线运行。无需插件、不依赖后端，是 Firefox 高级用户的典型生产力实践。
