选择实际乘坐的起终点，预览并确认线路，导出 GPX。在世界迷雾等支持 GPX 的应用中，补上旅途中没能记录的轨迹。
Windows 10/11 x64 · macOS · 行程本地存储 · 标准 GPX 导出
真实应用截图 · 上海地铁 6 号线 · 28 站 / 32.6 km。使用隔离演示数据，数据预处理与素材来源见说明。
选好起终点 → 确认候选线路 → 保存并导出 GPX。
- 补上实际坐过的区间。 支持中国地铁与国铁行程；按起终点生成候选，不把整条线路算作你的足迹。
- 每条路线由你确认。 环线、支线与多条铁路候选都可预览，有歧义时明确提示。
- 把轨迹带到自己的应用。 输出标准 GPX 1.1；可用于世界迷雾等支持 GPX 轨迹导入的应用。
以下保留此前的真实验收截图，界面版本与本次地铁演示不同。北京南—上海虹桥示例：比较线路、距离与警告，再决定保存哪条候选。铁路候选不等于列车实际运行路径。
查看 GPX 导出设置：逐次行程与去重覆盖两种方式
保存每次乘坐记录可选 journey；汇总同一数据版本下走过的区间可选 coverage。地铁与铁路可分别设置采样间距。
第一次建议先完成一条地铁行程。 环境与数据准备好后，只需选站、预览、确认并导出；铁路可在之后按需配置。
| 你想做什么 | 从这里开始 |
|---|---|
| 第一次运行，导出一条地铁轨迹 | 首次使用指南 |
| 配置铁路行程与本地图 | 铁路准备步骤 |
| 使用或构建桌面安装包 | 安装包说明与当前分发状态 |
| 排查环境、数据或启动问题 | Windows 指南 · 开发与运行 |
获取方式： 当前代码版本为 1.0.0，GitHub 尚无已发布安装包。请先按源码指南运行，或按安装包文档自行构建；Releases 将用于提供经过发布检查的正式产物。
数据准备： 第三方地铁数据需自行下载；当前 Figshare v2 包存在字段兼容问题，已在数据获取步骤说明。依赖与数据下载时间取决于网络，不承诺开箱即用。
| 能力 | 当前支持 | 准备条件与边界 |
|---|---|---|
| 地铁行程 | 地图选站、手动录入、CSV 导入与审核 | 需先导入兼容地铁数据；已验收的 46 城属于特定数据快照，不代表实时线路更新 |
| 铁路行程 | 手动/CSV 录入、候选比较、确认与保存 | 需另备 Java 17+ 和已验证的铁路图；不内置 12306 抓取 |
| GPX 导出 | 地铁与铁路混合导出；journey / coverage | WGS‑84、GPX 1.1 轨迹；不同目标应用的导入规则可能不同 |
| 本地运行 | Windows 10/11 x64、macOS | 源码运行需 Node.js 22+、npm 10+、uv 0.9+；Windows 另需 PowerShell 7 |
| 隐私 | 乘车历史与导入文件在本机处理和保存 | 默认底图会请求 OpenStreetMap 在线瓦片，可关闭或配置合规的自托管服务 |
没有实时 GPS 记录，也可以使用吗？
可以根据自己实际乘坐的起终点补录行程，再检查候选轨迹。它不会替你证明乘坐事实，也不会自动知道列车当日实际走过的线路。
只能用于世界迷雾吗？
输出使用标准 GPX 1.1 的 <trk> / <trkseg> 结构。世界迷雾是已有人工验收记录的兼容示例，其他应用请先用少量行程抽检。
安装后会自带全国数据吗？
不会。地铁数据需自行导入；铁路 PBF 与 graph 也需单独准备。安装程序与数据准备是两个步骤。
可以完全离线使用吗？
行程处理在本机进行；默认在线底图需要联网。关闭底图后可使用已准备好的本地数据进行相关操作，数据与依赖的首次获取仍需准备。
预览、保存和导出使用同一组不可变线路片段，避免结果漂移。原始数据保留版本、校验和、许可与质量记录；有阻断问题的线路不能导出。
代码采用 Apache License 2.0。第三方地理数据分别遵循其自身许可，详见数据与第三方署名。
- 首次使用指南：环境、数据与地铁/铁路操作。
- 平台验证记录：历史验证基线与本次构建证据。
- 展示素材说明：真实截图、演示与分享封面的来源。
- 产品需求：目标用户、完整流程、功能与验收要求。
- 系统架构：技术栈、模块边界、运行与数据流。
- 数据与 API 契约：数据库模型、CSV、REST、GPX 和几何约束。
- 国铁轨迹扩展设计：铁路数据源、Provider、模型、候选、API、GPX 与实施顺序。
- 关键设计决策：已确定方案、理由与代价。
- 视觉与交互设计系统：概念图、tokens、组件和响应式规则。
- 开发与运行：安装、开发、生产启动和质量检查。
- Windows 原生运行：PowerShell 7 命令、路径写法、铁路环境与故障排查。
- 安装包与一体化铁路运行：独立安装产物、打包 smoke test、sidecar 监督与数据边界。
- 交付路线图：当前进度、实施阶段、测试矩阵与完成标准。
- 已知限制：当前验收缺口和发布前待办。
- v1.0 验收审计：逐条完成状态、测试证据与最后外部阻断项。
- Fog of World 实机验收：两份真实数据 GPX 的安全导入步骤、通过标准与结果记录模板。
- Fog of World 铁路实机验收：北京南—上海虹桥全国铁路 GPX 的固定哈希、抽查步骤与关闭条件。
- Apache License 2.0：Transit2Fog 项目代码许可证。
- 数据与第三方署名：CPTOND、Science Data Bank、OpenStreetMap、Geofabrik 与 OpenRailRouting 的署名边界。
数据源、标准与参考资料
- CPTOND-2025：以 2025 年 6 月数据快照为首个数据源；Figshare v2 标注 CC BY 4.0，并描述覆盖 46 个城市的地铁系统。
- Science Data Bank 时序数据集：基于 CPTOND-2025 的 46 城地铁数据，补充 1971–2025 开通时序；页面标注 CC BY-NC-SA 4.0，作为 Figshare 受限时的兼容来源。
- 国铁几何：Geofabrik 提供的 OpenStreetMap 中国或省级 PBF，按 ODbL 1.0 使用并保留
© OpenStreetMap contributors署名。 - 铁路路径引擎：固定提交的 OpenRailRouting/GraphHopper fork；运行时图版本、自定义中国国铁 Profile 和 PBF checksum 共同构成身份。
- GPX：导出遵循 Topografix GPX 1.1，坐标基准为 WGS‑84。
- GPX 兼容性：目标应用需要支持 GPX 1.1 的
<trk>/<trkseg>轨迹；点数限制、简化规则和重复轨迹处理以各应用为准。 - Fog of World：兼容应用示例；官网说明支持导入 GPX/KML 轨迹。
原始 CPTOND 数据不直接提交到仓库。应用应提供可复现的导入流程，并在界面和导出元数据中保留数据署名。