jrpm 版本合并总览

分支：jrpm ｜版本：jrpm-0.1.0（tagged，2026-08-14）构建产物：openttd-jrpm（可执行文件名）

版本关系

                        jgrpp-0.73.1 (共同祖先)
                        /                 \
        jgrpp 分支(63 提交)          pulsexlb px-patch (152 提交)
        ├ tracerestrict 等近期更新      ├ jgrpp-decouple（机车换挂）
        ├ 我的 5 功能 (d4c45740)        └ jgrpp-multitile-airport（模块化机场）
        └ 版本改名 jrpm-0.1.0 (425e7207)
                        \                 /
                        jrpm 分支 (merge 71fe214c + 兼容 cb9848b)

合并内容

1. pulsexlb/OpenTTD-patches（px-patch 全量 152 提交）→ 已合并

功能	说明	主要文件
机车换挂（decouple）	列车解挂/挂载：解挂订单、路签转移、耦合长度/车速限制、双车头、NewGRF 耦合、耦合寻路（YAPF/NPF）、解挂后两列车独立调度	train_cmd.cpp、order_cmd.cpp、order_gui.cpp、train.h、yapf/npf
模块化机场（multitile-airport）	多格机场系统重构：air 类型体系（air.h/air_type.h/newgrf_airtype.）、PBS 空中调度（pbs_air.）、YAPF 航空寻路、`station.allow_modify_airports`（改造机场布局）、`gui.default_air_type`、多格机场精灵	air.、pbs_air.、aircraft_cmd.cpp（3600 行重构）、airport_cmd/gui、station_cmd

冲突处理：仅 2 个头文件冲突（aircraft.h / airport.h）——pulsexlb 航空重构删除了工作区无引用的死类型（VehicleAirFlags bitset、AirportMovingDataFlag），取 pulsexlb 侧删除，已确认无其他文件引用。

2. Openttd-Cluster（用户 Rust 集群项目）→ 选择性借鉴

补丁	处理	说明
0006 vanilla-native-server（多版本客户端兼容）	✅ 已合并（cb9848b7）	jrpm 服务器同时接受 jrpm / 原版 jgrpp（`jgrpp-`）/ pulsexlb（`pxp`）客户端；NewGRF 版本仍严格校验
0001 revision-handshake / 0005 version-metadata	✅ 思路已采用	jrpm 用独立 tagged 修订串 `jrpm-0.1.0`，联机握手与 jgrpp/pxp 隔离，实现「全新版本方便联机」
0007 parallel-download（HTTP 线程池 + Range 分块，30KB）	📝 参考不合并	与本项目 F1「文件级并行 + 多镜像」同主题且改动同一批文件；0007 的传输层线程池/分块下载记录为 F1 后续增强方向
0002-0004 snapshot/command/FFI 桥	📝 架构参考	依赖整个 otc-engine Rust 运行时（FFI 静态链入），属「远期整体集成」而非补丁级合并；jrpm 当前保持纯 C++ 单一二进制

3. jrpm 专属（前序 5 功能，d4c45740）→ 已在 jrpm 分支内

并行下载（多镜像+4 并发会话）、自动分组、建造 tooltip、整局感知 AI（ScriptGlobal + GlobalAI）、镜像/内容服务器设置。

联机策略（「全新版本方便联机」）

jrpm 为 tagged 版本：IsNetworkCompatibleVersion 要求修订串完全匹配 → jrpm 客户端只与 jrpm 服务器联机，与 jgrpp 0.73.x / pxp 完全隔离；
服务器放宽：jrpm 服务器额外接受 jgrpp-* 与 pxp* 客户端加入（IsJgrppNativeNetworkRevision / IsPxpNetworkRevision，NewGRF 版本必须一致）；
因此：jrpm 服主开服 = 只接 jrpm 玩家（默认）；需要兼容老客户端时无需改配置即可接 jgrpp/pxp 玩家。

构建与验证（用户本机执行）

bash

# 首次（需要 CMake + 依赖，参考 COMPILING.md）
cmake -B build ..
cmake --build build -j
# 产物: build/openttd-jrpm.exe

验证优先级：

openttd-jrpm -v 显示 jrpm-0.1.0；
单机开档跑 1-2 年（合并涉及 train/airport 大改 + 存档版本可能因 allow_modify_airports 等新增而 bump）；
开服后：jrpm 客户端加入 ✓；原版 jgrpp 0.73.x 客户端尝试加入（预期可进，NewGRF 一致时）；
机车换挂：给列车加解挂/挂载订单，验证解挂后两列车独立调度；模块化机场：开启 station.allow_modify_airports 后改造机场布局；
前序 5 功能回归（并行下载、自动分组、建造 tooltip、GlobalAI）。

已知风险

未编译验证：合并+改造的代码未在本机编译（无工具链），真机首编可能有遗漏的接口变动（尤其 aircraft/airport/train 三系大改）；
存档版本：px-patch 可能 bump 了 SLV（M9 提到 savegame version gate），jrpm 存档与 jgrpp 0.73.x 存档可能不互读（同 jgrpp 惯例，向下兼容 trunk 存档）；
merge 带入 pulsexlb 全部历史，如需追溯功能归属用 git log --oneline pulsexlb/px-patch。

合并记录：2026-09-28（jgrpp-0.73.3 + px-patch 2609.x）

合并提交：jgrpp 94 提交（至 jgrpp-0.73.3，48e8d51c6c）+ px-patch 113 提交（至 pxp-2609.10 后，ec1a3d4fb3）。

上游新增内容

来源	内容	说明
pulsexlb	载具运输（RoRo）	火车/轮船/飞机改装运载汽车；专属 VEHC 货物；详见「功能 → 载具运输（RoRo）」
pulsexlb	货物种类 128	`NUM_CARGO` 64→128，CargoTypes 改用 Uint128 位集，存档经 XSLFI_CARGO_TYPES_128 兼容旧档
pulsexlb	解挂/对接修复批	对接认领状态持久化（CPLM 数据块/XSLFI_COUPLE_CLAIM_STATE）、解挂后推进/路签返还/站台命令复制等十余项修复
pulsexlb	调度计划增强	解挂后执行调度计划改开窗口、调度管理菜单与 RoRo 选项冲突修复、无引擎列车信息面板
jgrpp	订单拖拽与双击	订单窗口支持拖拽排序；改停靠位置/汽车行驶方向需双击（0.73.3）
jgrpp	双端船	NewGRF 双端船可不调头直接倒车（SLV_DOUBLE_ENDED_SHIPS/XSLFI_DOUBLE_ENDED_SHIPS）
jgrpp	常规修复	出发表列距、订单标签下拉、ByteReader 越界、Robin Hood 标签哈希等

关键冲突处理

存档层：pulsexlb 基于旧式 SLE_ 宏系统，jrpm/jgrpp 0.73.3 已重构为 VarFileType/VarMemType + VarTypes 结构。全部 saveload/、sl/ 冲突按现代系统重写，并补入 U128 支持（VarFileType::U128=13、VarMemType::U128、SLE_UINT128、SlSaveLoadConv128 改现代枚举）；
jrpm 占位版本号：SLV_MULTITILE_AIRPORTS(367)/SLV_ORDER_DECOUPLE(368) 保留，上游新增 SLV_LABEL_ORIENTATION_UNIFICATION/SLV_DOUBLE_ENDED_SHIPS 顺延为 369/370（NSL 别名枚举注释标注上游原号），上游存档仍走 XSLFI_UPSTREAM_VERSION 子块；
order_gui.cpp：jgrpp 拖拽字段（drag_start_pt/drag_start_time_us）并入 jrpm 订单列表重构；拖放回调改用目标模式访问器（NumOrders/OrderAt），订单列表窗口模式下安全；点击改停靠位置采用上游双击语义；
train_cmd.cpp：保留 jrpm 耦合接触判定（ValidateCoupleCandidate），碰撞结算改用上游新 TrainsCrashed 辅助；解挂门控 enable_decouple 保留；
语言文件：jrpm 特有机场字符串保留，共享字符串取上游（去 {WHITE} 前缀）；pulsexlb 新增 RV_TRANSPORT 错误串译为简中；
杂项：CargoLabel 4 字符字面量改字符串构造（CT_VEHICLES）；grfid 整数 switch 改 GrfID 字节串比较（OpenGFX+ Airports 转换表）；console_cmds 同时保留 autogroup 与 RORO_DEBUG_COMMANDS 调试块。

合并后状态

编译：MinGW ninja 通过，产物 build/openttd-jrpm.exe；
运行：开档验证通过（详见构建验证）。

合并记录：2026-10-07（jgrpp 0.73.3+89 + px-patch 2610.3）

合并提交：jgrpp 23 提交（jgrpp-0.73.3 之后，至 6318727b02）+ px-patch 55 提交（至 pxp-2610.3，4a4d0724b5）。

上游新增内容

来源	内容	说明
pulsexlb	火车轮渡	船只可改装为运输整列火车（专属 `RAIL` 货物，`CT_RAILVEHICLES`）；装船按车厢分仓，不再要求整车位于同一船舱
pulsexlb	雨天系统	新增 `weather.cpp` 天气模拟：随机雨期、世界亮度渐变、雨滴蒙版（随视野缩放 + 随机振动）；难度选项 `difficulty.rain`；沙盒作弊可强制「自动/下雨/晴天」；天气状态随存档保存（`WTHR` 数据块 / `XSLFI_WEATHER`）
pulsexlb	解挂同向离开	解挂时可选「单侧部分等待另一部分离开后同向离开」；配套修复搭档未完全出站时的挡路判定
pulsexlb	载重显示	船只信息显示每个船舱可装载重量，列车信息显示每个车厢重量
pulsexlb	RoRo 选项增强	运输选项的路签选择允许选火车/汽车路签；列车装载道路载具按车厢装载；状态栏不再显示已装载载具信息
pulsexlb	对接寻路性能	消除对接寻路卡顿：载货校验改预检 + 失败退避，节流替代全场遍历
pulsexlb	Android 构建	新增 Android 构建脚本与 CI，发布 release 时一并发布 APK
jgrpp	StringID 强类型化	`StringID` 改为强类型（不再作模板参数），Label 只接受字符串/字节数组构造
jgrpp	公司名查重	正确拒绝重复公司名（President 姓名生成去 goto 重构）
jgrpp	控件首选尺寸	Widgets 可基于给定尺寸计算 preferred size
jgrpp	常规重构与修复	订单列表达成、NewGRF GEF ID 校验、坡面像素高度返回元组、出站调度计划导出崩溃修复等

关键冲突处理

存档层：pulsexlb 新增的 WTHR 天气数据块沿用旧式 SLEG_VAR/SLE_ 宏，已在 sl/saveload_common.h 别名体系下直接可用；仅需把过时的块类型枚举 CH_TABLE 改为重构后的 ChunkType::Table；
Label/StringID 强类型化（本轮主要编译障碍）：jrpm 自有代码中的 4 字符字面量标签全部改为字符串构造（CT_RAILVEHICLES{"RAIL"}）；afterload.cpp 的道路/有轨电车类型标签比较改为 RoadTypeLabel{"ROAD"} 形式；airport.cpp 空 AirTypeInfo 的字符串字段改用 STR_NULL；cheat_gui.cpp 的 STR_CHEAT_RAIN switch 分支改用 .base()（对齐既有 STR_CHEAT_CHANGE_COMPANY.base() 写法）；
cheat_gui.cpp 作弊表：保留 jrpm 的 VarMemType 字段类型与 InflationCheat 哨兵，同时并入 pulsexlb 新增的雨天作弊行（SLE_VAR_U8 + ClickRainCheat）；
jrpm_watch_gui.cpp：SetStringTip(SPR_GOTO_LOCATION, …) 改为 SetSpriteTip（上游已拆分 sprite/string 提示接口）；
存档版本钉子：SL_UPSTREAM_VERSION 仍钉在 368（上游 DoubleEndedShips），src/saveload/engine_sl.cpp 的 static_assert 守卫通过；jrpm 占位 367/368 不变，上游新版本顺延为 369/370；
train_cmd.cpp：解挂判定保留 jrpm 的 enable_decouple 门控与 desync 调试输出，同时并入上游「仅车头经过道岔才触发调头」的车场修复（if (v->IsMovingFront())）；want_decouple 后的同向离开标志位取上游实现；
aircraft_cmd.cpp / window.cpp：include 冲突两侧并存（jrpm 的 pathfinder/pbs/roadveh_transport 与上游的 checksum/script_event/widgets）；
order_cmd.cpp：DrivingBackwards 采用上游按 TCF_NO_DRIVING_CAB 判定的新语义，jrpm 的 DecouplePart 变量保留；语言字符串随之改为「以限速倒车行驶」；
deploy-docs.yml：保留 jrpm 的 VitePress 构建与 GitHub Pages 部署（pulsexlb 的 Typst 版仅用于其 pxp-docs 目录）；
README / .gitignore / .ottdrev-vc：保留 jrpm 品牌与本地条目，并入 pulsexlb 的 Android 构建忽略项与 pxp-2610.3 版本记录。

合并后状态

编译：MinGW ninja 通过（-j3），产物 build/openttd-jrpm.exe；
运行：-D 专用服务器冒烟测试通过——新图生成 → 保存 → 载入 → 再保存 → 退出全链路无断言、无 SetupEngines 崩溃，上游数据块版本门控正常。

版本关系 ​

合并内容 ​

1. pulsexlb/OpenTTD-patches（px-patch 全量 152 提交）→ 已合并 ​

2. Openttd-Cluster（用户 Rust 集群项目）→ 选择性借鉴 ​

3. jrpm 专属（前序 5 功能，d4c45740）→ 已在 jrpm 分支内 ​

联机策略（「全新版本方便联机」） ​

构建与验证（用户本机执行） ​

已知风险 ​

合并记录：2026-09-28（jgrpp-0.73.3 + px-patch 2609.x） ​

上游新增内容 ​

关键冲突处理 ​

合并后状态 ​

合并记录：2026-10-07（jgrpp 0.73.3+89 + px-patch 2610.3） ​

上游新增内容 ​

关键冲突处理 ​

合并后状态 ​

版本关系

合并内容

1. pulsexlb/OpenTTD-patches（px-patch 全量 152 提交）→ 已合并

2. Openttd-Cluster（用户 Rust 集群项目）→ 选择性借鉴

3. jrpm 专属（前序 5 功能，d4c45740）→ 已在 jrpm 分支内

联机策略（「全新版本方便联机」）

构建与验证（用户本机执行）

已知风险

合并记录：2026-09-28（jgrpp-0.73.3 + px-patch 2609.x）

上游新增内容

关键冲突处理

合并后状态

合并记录：2026-10-07（jgrpp 0.73.3+89 + px-patch 2610.3）

上游新增内容

关键冲突处理

合并后状态