Changes

feat: 低贝位ec建立防抖  && truck起步曲率强制为0取消 并适配pjpo

feat(keb): apply planning profiles to online algorithms

feat(keb): add offboard replay and HTML diagnostics

feat:去除不必要的trhow机制

feat: KEB对换向点运动放向增加额外包络圆

feat: 二次优化的planner配置对应的参数

fix: Protobuf map普通序列化顺序不稳定导致快照校验失败的问题   keb配置参数方案重构

feat: IMV默认包络统一

feat: html分析工具增加路径几何

feat: rebase后配置参数的调整、冗余代码合并、通道构造全场景配置

调整 KEB 参数与配置生效，完善离线回放及诊断

1. 调整牵引车 KEB 场景默认参数
2. 修复碰撞硬缓冲配置的实际生效
3. 让停车历史路径优化正确接收显式配置
4. 修复离线回放终点容差被默认值覆盖
5. 新增最终路径的来源追踪
6. 改进 HTML 优化与验收诊断

feat: 1.keb固定权重细化不依赖预热调度，始终读取当前倍率 2.适配调整后的keb参数默认值

feat:1. soft-min对实际入侵的参差乘倍率 2.删除冗余的gtest测试单远

feat: keb中的QP展示优化

feat: 调整拖挂车终检包络并提高入堆场参考线权重

- 最终碰撞校验保留有符号余量，恢复默认 -0.3 m 净距阈值
- 挂车终检取消挂接偏移，前后各缩短 1 m 并保留几何中心
- 普通入堆场两阶段参考线权重从 1 提高到 10，低贝位保持原值
- 更新包络边界、负余量及场景默认参数单测，固定头段保持不变

验证：正式 CLI 分布式编译通过，相关 45 项单测通过。
同等 2 m 校验的隔离版本完成 578 例回归：555 成功、23 失败，
相对 3 m 基线零退化，杨浦现场原成功 415 例全部保留。

feat: 统一步进对准地图选源并完善补偿与失效停车

STEP 执行期间使用地图距离计算相对进度，退出后清除步进补偿，避免精停来源切换和旧补偿污染 AA 反馈。

完善地图失效及请求结束时的停车状态流转，补充回归用例与 Full/Compact 回放字段配套。

验证：git diff --cached --check 通过；本次未运行编译和现场回放。

feat: 补全挂车碰撞链路的铰接偏置并调整泊车搜索权重

统一车头后轴到铰接点的有符号坐标变换，补全 CPU 搜索、首尾固定长度计算、
KEB 软碰撞代价和通用挂车终检中的 h 偏移，保留车头航向的自动微分导数。

将单段及双向多段泊车搜索的碰撞、通道代价权重从 1.0 调整为 0.3，
保持既有硬碰撞阈值和终点验收语义。

同步离线碰撞几何展示，增加同位姿 h=0 对照及符号、方向、梯度测试；
删除 keb_sum_collision_test.cc 及其构建引用。

验证：核对同补丁 CPU 回放记录，样本整理后共 372 例规划成功；
该批次未执行独立质量检查。当前示例另经完整车身扫掠检查通过。
本次提交前 git diff --check 通过；测试清理后未重新编译或运行完整测试。

feat: 增加地图覆盖限时等待并调整入库搜索与碰撞查询

1. 检查 SSEP 起终点车体及前进终点余量的地图覆盖，不足时请求刷新并最多等待 3 秒，覆盖恢复或超时后放行，任务切换和重搜时重置计时。
2. 同步地图等待起点的 Full/Compact 序列化、数值编码策略及生成合同，补充跨帧恢复、超时边界和旧记录兼容测试。
3. 将挂车双向搜索的碰撞与通道软代价权重开放为参数，入库场景统一设置为 0.3，其他调用保持默认值。
4. 合并 KEB 左右侧最近障碍查询为单次树遍历，缓存固定查询半径项并移除重复索引构建。

docs: 调整 GPU 测试环境为服务器优先

PNC / SSEP GPU 编译、测试和场景回放先检查服务器 SSH 连接，可连接时优先使用服务器。
服务器无法连接时，检查本机环境并在满足验证要求后使用本机，记录连接失败及切换原因。
保留执行前 GPU 环境检查、测试授权、凭据保护及独立工作目录要求。

fix: 数据指纹阻碍编译

fix(zip): 避免创建条目失败时关闭未初始化指针

fix: 保证刚性车停车末端直线与调整段碰撞约束

沿用场景 tail_straight_distance，在搜索、KEB 优化、历史重接及最终输出中保证末端纯直线。保留终点清障来源，仅最后连续同向段允许终点障碍豁免，覆盖多段倒车和精准倒车。

硬尾连接异常先经完整优化验收，失败时恢复后续搜索策略机会，并禁止匹配移动实际起点。补充碰撞、硬尾、缓存和重试测试。

验证：114 项相关 C++ 测试通过；31 个原始场景回放 27 通过、4 个既有失败，无新增失败。实际后端 30 CPU、1 未确认；未做 GPU 验证。

test: 更新魏桥停车回归验收与场景剔除记录

加入 21 个魏桥多段倒车和精准倒车案例，补充末端硬直线、完整车体碰撞及运动学验收。嘉兴物化流程跳过已剔除场景，保留来源和历史决策。

按用户明确选择同步移除清单与决策映射，包括方向无法独立确认的 IMV 案例及最终指定的 4 个失败案例。后 4 例已核对 SHA 并按授权删除共享回归原件和 v3 临时输入副本，保留历史报告。记录当前全量计划范围 352 例，本次仅调整范围，未重新全量回放。

验证：37 项 Python 测试通过；决策映射无状态冲突，活动清单不含已剔除 SHA，来源计数一致，diff 检查通过。

fix: 解除 WBCA 对 DP 截断长度的限制

DP 无完整可行解时继续保留可行前缀，WBCA 使用自身配置长度和完整边界生成路径，避免障碍导致 DP 截断后同步缩短优化路径。
移除初始化时的 DP 长度上限及异步结果尾点覆盖拒绝，清理无用接口与状态参数。

更新正倒车输出接纳测试，并增加版本化 Compact bag 回放验证。连续模式传递真实 WBCA 历史并调用生产路径拼接，避免遗漏历史前缀；报告完整输出逐帧结果和路径对照。

验证：Icecream 分布式编译通过；33 项单元测试及济宁 AT017 bag 回放测试通过，460 帧全部求解成功。截图帧 DP 长度 18.80 m，WBCA 长度 78.50 m，参考上限保持 80 m。回放为 CPU 状态串联开环，不是车辆闭环验证。

feat: 补充双向搜索近邻节点配对

同桶连接未通过时，按固定间隔补查相邻桶并筛选有限候选，继续复用原有方向、阶段和路径验收。排除根节点替换及明显曲率折点，并记录近邻连接统计。

feat: 支持边界外障碍膨胀侵入走廊后的避让

新增默认关闭的边界外障碍膨胀开关，按障碍来源的安全余量更新走廊，
供 DP 撒点、曲线检查、历史路径复核及边界生成使用。

允许拼接起点在原始可行区域内连续恢复新增安全余量，按物理车身
覆盖断面计算初始缺口，并修正倒车车身姿态及前后悬断面定位。
同步 Full 字段与 Compact 重建、配置兼容及相关回归测试。

验证：此前相关单元测试和场景回放共 776 项通过、13 项跳过；
修改范围已使用项目 .clang-format 格式化，diff 检查通过。

已知问题：路径与车身均按 1 m 采样时，仍可能漏过 0.5 m 断面的
外部膨胀约束。已通过独立测试进程将步长改为默认值复现，尚未修复；
现有 0.1 m 步长用例未覆盖此组合。

fix: 为启用外部障碍避让的前向参考预留一厘米余量

将前向参考限制在车身中心可行边界内并尽量预留两侧各 0.01 m，
不足 0.02 m 的区间取中点，不扩大硬边界或覆盖统一拼接起点。
关闭开关时保持原有参考行为，补充窄区间及开关回归测试和使用说明。

PJPO 保持原有求解及历史路径、引导线兜底链路，参考余量不构成
最终车身净距保证。相关单元测试和场景回放已验证。

feat: 优化碰撞代价求值并收紧近邻连接

1. 复用完全相同状态的障碍查询结果，保留距离、残差和导数的重新计算。

2. 按碰撞几何实际依赖将自动微分缩减为普通车3维、挂车4维，并由functor内部车型决定。

3. 仅对近邻连接增加铰接角差检查和拒绝诊断，保持同桶连接行为不变。

4. 增加原8维与缩减维度残差及Jacobian等价性测试，覆盖OGM和PhysicalSides。

fix: 恢复 Proto 编码器生成文件以通过构建门禁

通过 Taskfile 的统一生成流程恢复 plan_frame_encoder.cpp 的规范输出。
此前对生成文件执行 clang-format 拆分了 Schema 哈希字符串，导致
生成器逐字检查判定文件过期；本次不改变哈希内容、字段或编码逻辑。

验证：check-generated 和 check-proto-breaking 共 49 项检查全部通过，
git diff --check 通过。生成源码保持生成器原样，不再单独格式化。

fix: 修正变道物理边界与目标参考线

按同一目标截面求源车道边界交点，合并源目标物理走廊并统一扣除车身尺寸，
移除人为窄边界及动力学外扩；横向参考收敛到选中的地图参考线。
处理局部线端部不外推及累计里程浮点舍入越界，补充左右变道、参考线偏移、
非平行、渐变宽度、圆弧和端部精度回归测试。

验证：分布式编译通过，相关单测 17/17 通过；现场 57 个变道帧的边界及
PJPO 任务成功。完整规划回放仍存在轨迹缺失，不作为整链通过结论。

fix: 修复变道场景回放初始化与主参考线重建

增加独立回放初始化入口，允许 Compact 仅携带当前场景配置，
不再依赖 NORMAL_FOLLOW 配置，并覆盖缺失场景及旧配置清理。
变道执行阶段按目标参考线索引重建主原始参考线，保持线上主候选职责。

验证：回放初始化单测通过，原始场景 70 帧解码导出无 gaps；
完整轨迹验收仍未通过，未将导出成功等同完整规划成功。

feat: tune trailer yard entry optimizer weights

fix: 避免 DP 历史覆盖尾点累积为密集采样层

继承历史采样时移除临时覆盖终点并按当前走廊重建，保留稳定内部采样锚点。补充连续推进、走廊缩短、单尾点和方向切换回归。

fix: 使用实际编译版本标识场景回放候选结果

将执行程序的 commit 和版本与归档兼容配置分开，避免报告把录制版本误标为当前候选版本。补充回归报告身份检查。

feat: 补齐 DP 采样指标与逐帧回放报告

采集采样层数、位置、间距和有序性，区分稳定内部间距与临时末端覆盖。输出完整逐帧实际值、期望值和状态的 JSON 及离线 HTML，保留失败、缺失和非有限值证据，并补充相关测试。

fix: 补齐散货搜索交接帧的几何与轨迹规划

交接时恢复并重投影历史引导线及参考线，避免搜索等待沿用空几何。
仅在 MOVE_FORWARD 的 PARK_ADJUST/TRAVEL_OUT 交接中同帧执行 SSEP_FORWARD，保留正常任务链和统一规划起点。
初始化搜索前进阶段 next_stage，避免正常等待误结束场景。
补充历史失效、同帧调度、失败传播和有界跳转回归。

验证：阶段/引导线单测及 97 帧真实几何回归。完整轨迹连续性回放受缺失 Motion FSM 启动历史限制，未完成验收。

feat: 补充引导线和参考线回放诊断指标

分别采集有效标志、几何可用性、引导线点数、长度和匹配状态，避免仅凭 valid 标志判断规划几何完整。
增加有效标志为真但几何为空的回归检查。

验证：ProfileCollectorsTest 全部 7 项通过。

fix: 统一 Proto 生成检查与构建工具链的编译器

CMake 将已配置的 Protobuf_PROTOC_EXECUTABLE 显式传给生成脚本，避免 PATH 中旧版 protoc 拒绝 proto3 optional。使用原始 pnc-build.sh 命令验证 pnc_node 编译链接通过，生成描述符指纹保持不变。

fix: 修复变道场桥校验的挂车后向距离

将变道准入及执行阶段的挂车尾长自减改为铰接点偏移减挂车尾长，恢复车尾后方安全范围并纠正反向场桥分类边界。

新增挂车有效与失效、前后距离边界及执行阶段动态场桥分类回归；分布式编译通过，场桥专项 49 项测试全部通过。

feat: add swept collision repair and optimization diagnostics

Preserve failed candidates for one fixed-weight swept-collision repair across vehicle optimizers, reuse obstacle queries, and expose per-solve validation and capsule layers in offline reports.

Validation: CPU serial replay of all 614 original site cases passed without parameter overrides or HTML collection; four swept-collision cases repaired successfully. Focused collision and diagnostic regressions passed.

fix: 修正 IMV KEB 方向编码与换向约束

将外部到达方向转换为 KEB 边的出发方向，并在输出时恢复到达方向。
解析未知起点方向，兼容重复点和热启动；按方向编码选择长度代价权重，
避免换向边误用前进或倒车权重。换向点同步启用严格轮角约束。

补充方向、换向、未知首点和长度权重回归；52 项相关 KEB 测试通过。
跨场景回归发现普通卡车精准倒车同输入历史通过、本轮运动学验收失败，
根因尚未隔离；不能将本次提交视为全量回归通过。

fix: 统一 IMV 入位物理姿态并完善搜索和车位验收

起终姿态统一使用物理车头航向，保留起始操作模式；末端进入方向由
final_direction 独立约束。同步在线输入、离线回放及入口可视化。

粗搜索使用车位软代价与斜行连接提案，修正倒车及旋转斜行代价和方向
哈希、启发式选择。配置权重的双向策略优先取得搜索预算，终点候选
在队列中完成 KEB 与硬碰撞验收，拒绝后继续搜索，超时保留已验收结果。

KEB 保持完整车宽；支持仅针对车位边界的侧向内缩参数，默认零内缩。
地图并集保持原栅格坐标，真实障碍与人工边界继续硬校验。
补充候选、碰撞、地图对齐、上游姿态及可视化回归。

三个入位场景通过 CPU 回放及 2 cm 扫掠、轮角和端点验收。
针对性 CPU 18 例：正式通过 10、失败 2、待业务验收 6（基础成功）；
真实 GPU 2 例：通过 1、失败 1。TT 段数规则仍失败，普通卡车存在
历史通过而本轮失败的行为退化，均保留证据，未放宽验收条件。
报告批次：targeted_imv_keb_20261026_104510。

fix: 修复 SSEP 任务交接误重搜并保留专门重规划入口

成功接收同一任务和命令的 routing 后，不再因历史申请标志拒绝复用。
路口按实际连接及弯后目标车道复用，目的地坐标变化不单独使搜索失效；极限变道保留目的地校验。
保留进堆场 TYPE_DEST 专门重搜，补交接、持续帧及 3 米阈值回归，整理搜索生命周期文档。

验证：reference_line_replan_test 442 项通过、101 项跳过、0 失败。
现场 bag 因 Compact 缺历史路口 ID，未完成端到端复用验收。

fix: 为旧版 IMV 回放显示物理朝向标记

将朝向标记绘制范围扩展到全部 IMV，避免旧 Proto 丢失双向子类型后标记消失。
继续使用录制的 reversing_mode 判断朝向。

fix: 以轮廓显示邻近卸载挂车

去除邻近卸载挂车的实心填充，保留坐标转换和轮廓描边。

fix: 在回放 Proto 中保留 IMV 精确车型子类型

新增带 presence 的 vehicle_subtype 字段，保留旧 vehicle_type 的粗车型语义。
恢复普通及双向 IMV 子类型，拒绝未知或冲突输入，缺字段时沿用旧版本行为。
补充 Full、Compact Recorded/Candidate 和旧读端兼容测试，同步描述符、字段策略及 codec 审计生成物。

验证：生成一致性和 Proto breaking 检查通过。
ConfigProtoCodecTest：27 项通过、0 失败。

fix: 修复低贝位场桥误判及出口重搜截止

以出口后实际通道与场桥实体框相交判定低贝位，避免缓存 SL 和 U 弯跨支路投影误触发。
使用当前车辆投影与出口停止线判定截止，并在参考线生成前使用本帧已选地图路径。
补充几何、出口截止和 U 弯重搜测试，修正通道过滤日志并整理搜索逻辑。

验证：相关 26 项测试通过；clang-format 21.1.8 与 diff 检查通过。
尚未覆盖整段 bag 连续回放及真实多段地图重建。

fix: 提高短距离入场优化约束以修复重搜失败

将短距离规划器运动学和动态约束权重对齐进场精优化的 1e6，减少新窄通道下首段横移造成的运动学验收失败。
保留原有碰撞、运动学校验及首次 LOW_BAY 历史初值策略，并记录问题和修复依据。

验证：CPU 回放现场 3 次失败输入均成功，普通进场对照成功，实体阻挡案例正确拒绝，共 5 项验收通过；未进行 GPU 验证。

fix: 延长场桥变道搜索约束的前后范围

仅对场桥将两路障碍纵向约束前后分别由 1 m 增至 2 m、0.5 m 增至 1.5 m。
保留原始 SL 诊断数据、障碍筛选和其他类型的约束余量。

验证：生产构造测试覆盖左右方向、曲率开关、类型对照和参考线末端；真实 CPU 场景重搜完成。

fix: 限定堆场变道场桥使用原始障碍框校验

在堆场多车道及直进、直出堆场多车道前置段，场桥在变道安全校验中取消额外障碍框膨胀。
静态和动态分支保持一致，自车、其他障碍及其他区域的膨胀保持不变。

验证：四项搜索构造及碰撞回归通过，覆盖六类区域和静动态分支。正式 CPU 复验中，T728 两帧障碍检查通过，截图帧完整安全检查通过。场景采用本机搜索配置和默认环境参数，属于独立帧验证。

feat: 前车倒退预警功能

fix: 按时间窗口确认障碍物静止状态

使用固定 1.5 秒速度窗口和连续 1 秒静止确认，不新增配置参数。重复帧不累积，观测中断保留同一目标的已确认运动防护，身份变化清空证据。

保存 Full、Compact 和 Candidate 跨帧计时状态，补充精度、旧数据默认行为与动静切换回归测试。

feat: 显示障碍物静止确认和跟车等待秒数

展示静止确认进度、跟车等待时长及现有超时阈值，明确旧快照缺失计时状态的显示。

test: 增加静止计时连续回放验收

使用独立期望窗口校验等待开始期限、计时起点和逐帧计数，拒绝缺帧、计时重置及冻结。覆盖跨验收窗口起点的大缺口。

验证汇总：808 项通过、12 项可选测试跳过；现场 bag 的 569 条快照验收通过。

feat: 紧凑记录 PNC 节点模块耗时并复用原界面

按固定编号记录单帧模块与任务耗时，使用执行位图和 0.1 ms 整数编码，
替换 Proto 中重复保存的 50 帧历史及字符串耗时。异步模块携带独立来源帧
和完成时间，watchdog 记录当前执行项；Boost 字段保持不增不删。

原 HMI 本地维护历史平均并展示模块明细，区分实时与录制数据。
规划帧超过 1 秒未更新时保留业务绘制保护，继续刷新实时耗时窗口。

验证：生成与合同检查通过；Icecream 分布式编译 pnc_node、replayer
及测试通过；测试汇总 825 项通过、12 项可选跳过。合成的 30 项模块与任务
统计加 watchdog、5 个异步槽及 Proto 嵌套开销共 167 字节。

fix: 保持末段精准倒车阶段并保存跨帧状态

按当前最后分段的前进转倒车切换精准倒车，替代固定两段判断。
将最终倒车阶段绑定任务签名，跨搜索重置和失败重试保留，取消或目标变化后失效。
同步 Full、Compact、候选帧编码及字段合同，旧数据缺字段时默认为 false。
补充任务生命周期、场景参数读取和序列化往返测试。

验证：158 项相关回归通过；生成和 Proto breaking 检查通过；两例 CPU 参数对照完成。

fix: 最后段跳过 PJPO 后优先拼接新 SSEP 路径

共用生产任务组选择逻辑，依据实际跳过 PJPO 的最后段组选择 SSEP 拼接，避免静态规划器可用位导致复用旧路径。
将方向校验放入 SSEP 拼接函数；无可用搜索结果保留历史路径兜底，新结果可用后优先采用。
覆盖正倒车、新旧路径区分、WAIT 优先、公共 PJPO、方向错误及历史兜底后恢复。

验证：6 项拼接回归及 30 项既有选择器/等待回归通过，pnc_node 编译通过。

feat: 配置挂车报警范围并精简快照结果保存

fix: 防止精准倒车预优化改变换向方向

校验预优化后的几何运动方向与方向标签，异常时回退已验证的搜索初值。
增加六米硬尾段场景回归，检查运动学和起终点约束。

fix: 限制泊车换向段有效长度至少为1.5米

搜索候选与优化结果统一检查换向段长度，最终停车段允许短距离对位。
覆盖历史拼接、路径缓存与实际下发出口，拒绝优化压短或复用的短段路径。
新增边界、重复点、方向标签兼容及候选拒绝测试；相关45项CPU测试通过。

fix: 收紧散货停车与远控的TTC碰撞豁免

使用最终目标剩余距离判断停车豁免，避免中间换向短段提前忽略碰撞。
远控专用豁免分支要求请求显式设置is_ignore_safe。

fix: 增强泊车历史路径的碰撞优化重试

历史路径在曲率通过但车身或前向净空不满足时继续增强碰撞罚项重试，避免复用碰撞初值。保留请求截止时间与最终完整验收，并覆盖超过换向点后的历史路径修复。

fix: 按真实圆弧长度验收泊车换向段

对严格满足圆弧几何的采样边恢复弧长，避免有效 1.5 米换向段因弦长略短被拒绝。一般折线仍保守取弦长，保持原长度阈值和容差，覆盖 UTM 与异常朝向边界。

fix: 恢复狭窄泊车场景的搜索与调整重试

跳过无改进节点以保留搜索预算，保留未延伸换向候选，并在共享截止时间内依次细化步长和补充中间曲率；已配置细步长也能进入曲率补救，复用 planner 时恢复原配置。

双向重试允许另一侧继续展开，软途经参考不再阻挡调整兜底。兜底继承派生默认尾长，保留显式配置优先及粗路径任务换向标记，不伪造纯倒车任务进度。

验证：相关 77 项 C++ 用例最终通过；原始 22 例回放成功，独立 0.25 米步长变体恢复成功。验证使用隔离源码快照，未纳入工作树并行 KEB 改动。

fix: 补齐泊车独立验收的换向段长检查

独立按实际几何方向检查非末段至少 1.5 米，并对严格圆弧恢复弧长；保留末段和单向短路径豁免，输出逐段长度指标。

仅在显式 allowed_direct_reverse 验收策略下接受无任务换向标记的纯倒车路径，不改变默认策略或在线任务进度。

验证：30 项 Python 用例通过；原始 22 例及独立步长变体均通过完整几何检查。

fix: 变道任务交接不因道路类型和目的地变化重搜

移除变道复用的堆场区域限制、前后区域相等限制及任务目的地相等检查，保留变道连续性和目标车道覆盖旧完成点等校验。

补充左右变道跨区域及目的地变化回归，并验证连续任务交接保留路径和搜索请求次数、手动重搜仍有效；同步更新生命周期说明。

验证：clang-format 21.1.8；分布式编译通过；reference_line_replan_test 447 项通过、101 项跳过、0 失败。

fix: 防止弯道缓存覆盖当前路段并修正重搜判断

弯道选线仅允许修改当前路段内的车道，阻止缓存首弯道跨路段覆盖定位索引，并记录不匹配信息。

按旧车道映射到本帧后的索引与当前选线比较，避免索引重排误报并保留真实换线触发；修正历史地图有效性检查。

新增旧弯道、未来弯道、连续帧、真实换线、同车道索引重排及直线路段保护回归。分布式编译通过，452 项测试通过、101 项跳过、0 失败；未执行现场 bag 算法回放，缓存异常来源仍待确认。

fix: 避免弯中任务后续路线变化触发重搜

弯中最近出口未变时结束出口比较，避免新任务截短远端路线触发 AFTER_BEND_CHANGE；保留直道前方目标检查，并修正历史地图有效性判断。

新增普通路口和桥梁共 12 个回归用例。相关测试 464 个通过、101 个跳过；原始任务 82161 到 19613 生产决策链复现确认修复后不再重搜。

fix: 限制精准停车换向重搜并校验接入偏差

精准停车内部正常换向时，使用原始 SSEP 下一段检查横偏不超过 10 cm 且车身航向差不超过 1 度，满足双门限才跳过换向重搜。保留首次场景切换及其他重搜触发，拒绝无效和退化路径。

补充生命周期、阈值边界、角度归一化及现场录制路径测试。

feat: 支持场景配置选择精准停车原始搜索路径

新增精准停车任务选择条件，由场景配置决定全部分段是否直接输出 SSEP。只有实际选中直出组且未执行其他横向规划器时启用，保留 WAIT 优先级；方向不一致或直出失败时清空输出并报错。

补充配置解析与 codec 往返、Stage 调度及路径输出测试，更新配置成员审计指纹。分布式构建 pnc_node 和相关测试通过，相关测试合计 261 项通过、101 项按参数范围跳过。

feat: 支持精准停车前进拉直余量及完整候选验收

将实际 KEB 优化和硬约束纳入候选验收，失败后继续搜索。
按场景配置尝试额外前进拉直，空间不足逐级缩短，保持完整碰撞与运动学校验及末端约束。
验证：搜索测试 51 项、配置测试 43 项通过，8 个 CPU 现场场景回放成功。

fix: 防止精准停车中间换向时误入锁定状态

入锁前核对当前与历史帧为同任务同一有效末段，阻止等待重搜时完成。
历史引导线失效时使用实际 SSEP 末点与已有距离阈值判定，保留反向取货及末段料堆分支。
新增 9 项回归通过。

fix: 拒绝非有限值及退化的 SSEP 路径

在 WBCA 之前统一检查车头与挂车坐标、角度、曲率及路径长度，允许局部重复点。
非法输入清理优化缓存并沿用历史路径回退；更新已失效的旧切线测试，保留无效几何拒绝断言。

test: 补齐同任务搜索重置测试的历史任务标识

使当前与历史任务 ID 一致，正确验证同任务保留搜索与任务变化清理搜索。
完整 routing_transition 测试 117 项通过，生产 pnc_node 编译通过。

feat: wbca接入lattice的速度考虑载重系数

fix: 清理跨任务出库状态并限制出库点变化重搜

补齐任务重置时的途经点标志和开放空间点清理，任务切换或取消时清除旧搜索输入，避免历史起点导致新任务提前退出出库。仅在同一有效任务内判断 BULK_OUT_POS_CHANGE，保留同任务重搜及路径复用行为。补充取消、任务切换、位移阈值和出库退出回归测试。

fix: 出库阶段拒绝普通新任务

在 TRAVEL_OUT 阶段拒绝普通设置终点命令，覆盖搜索请求尚未发起的窗口，防止新任务替换正在执行的出库任务。保留取消任务和脱困命令例外，补充门禁、取消、正常行驶接收与脱困回归测试。

test: 补齐 IMV 停车测试夹具车型子类型

设置 IMV 车型时同步填写 Proto 子类型，避免配置解码因车型不一致失败，恢复停车进度测试覆盖。相关测试合计 699 通过、101 跳过、0 失败，pnc_node 编译通过。

fix: 调整卡车泊车搜索预算并保留细网格重试

前向调整搜索按剩余总预算的三分之一分配时间，最多 4 秒，避免固定
2 秒在短换向候选被拒绝后过早截断后续可修复连接。

首次粗网格调整只使用一半剩余预算；阶段超时且总请求尚未超时时，
继续已有的细位置网格重试。最终阶段使用剩余预算，保持总请求
截止时间以及碰撞、换向长度、末端直线和运动学验收要求。

新增真实不可达场景测试，覆盖阶段超时保留预算、最终总超时及
已过期请求不得继续重试。25 项专项测试通过；魏桥分析包中原参数
末端直线为 2 米的 4 例 CPU 回放全部成功。3–4 米约束下仍可能超时，
不把缩短末端直线的诊断实验计入原参数回归成功。

feat: 支持场景位置条件的或匹配

为 start/end 增加 any_of 和 Lane/YardArea 的 ids 简写，兼容原有单位置配置。
加载阶段展开组合并保留规则优先级，不改变运行时匹配和快照合同。
补充组合、优先级、非法配置测试及配置文档。

验证：场景配置目标 130 项测试通过。

feat: 支持出库起始直线与按行驶段恢复障碍物

新增 head_straight_distance，使用任务锚点及执行期完成锁存，重搜只补剩余直线。
纯前进候选在搜索、优化或验收失败后尝试多段调整，保留固定直线和正确方向标记。
抽象首末段豁免的恢复区间，换向公共点及起点豁免过期后的路径使用恢复障碍物。
统一搜索状态、KEB 选图和连续车身/停车扩展验收，保留终点与出入口清障语义。
恢复起点来源对应的普通和反向膨胀，不重复扩大原图已有障碍。

验证：459 项测试通过；CPU 2 米、3 米及任务进度派生场景复验。
3 米场景输出前进 3.000 米、倒车 2.123 米、前进 21.669 米。
回绕派生输入按生产搜索起点方向构造后成功，旧输出驶入方向不作为新请求方向。

fix: 修复预测路径转向角平滑限速

在 Truck 和 IMV 前后轮预测入口，将方向盘角速度按传动比换算为车轮弧度每秒，修复预测转角直接跳到控制目标的问题。统一增量限幅并处理非法速度和传动比，保留原函数声明。

验证：通过项目分布式入口编译 pnc_node；12 个函数级数值测试通过，默认 0.05 秒步长下每步最大转角变化约 0.402 度。

fix: 按车道身份判断弯后出口变化

将历史出口车道 ID 映射到当前帧车道索引后再比较，避免索引重排引起误重搜或真实换道漏重搜；缺失匹配证据时继续触发重搜。

增加普通路口和桥梁的同车道重排、真实换道编号不变回归。已运行 clang-format 21.1.8 和 git diff --check，编译测试由合入分支统一执行。

fix: 仅凭明确出口变化触发重搜

删除重复的车道匹配失败判断；校验出口决策索引与车道 ID 一致。旧车道缺失时，通过前后帧唯一的路口 ID 及紧邻完整出口确认目标变化，不再把地图裁剪或缺失决策直接当成换线。保持最近出口未知时的弯中检查范围。新增裁剪、缺失与越界目标、完整出口替换和重复路口身份回归。已完成 clang-format 21.1.8 与差异检查，编译测试由主代理统一执行。

fix: 限制精准倒车换向追加调整并支持参数配置

换向接入超差默认最多追加重规划 3 次，横偏和航向门限默认 0.10 米和 1 度，均按实际精准倒车场景配置。计数跨搜索继承，在任务取消、失效或目标变化时清零，无效路径不按次数放行。

补齐多段泊车切入精准倒车时的参数传递，增加 Full/Compact Bootstrap 计数持久化及旧快照默认值，覆盖次数、误差边界、生命周期、配置切换和回放往返测试。

验证：26 个精准倒车专项测试、131 个场景配置测试通过；回放基础测试 442 通过、9 个外部数据用例跳过；生成合同及兼容性检查通过。

fix: 补齐路口出口边界停止线并统一目标筛选

对仅有入口停止线的路口，按已选参考线的直接后继拓扑和边界范围补配唯一出口线；拒绝短连接、下一路口邻近及多候选歧义。

目标路口筛选与最终输出共用局部停止线对，修复越过 junction 边界但尚未越过出口时漏选路口的问题，保留原地图归属。

增加精确大榭地图、出口前后、连续搜索和歧义拒绝测试，并刷新生成审计摘要。分布式编译及 165 项测试通过；完整 bag 搜索链仍受后续起始车姿构建限制。

fix: 默认开启前车倒车报警并设为5米

fix: 同步报警默认值修改后的Proto声明记录

fix: 防止配置 Proto 生成器复用保留字段

支持显式分配跨分支字段号，并保留 reserved 声明。
拒绝复用保留名称、单号和编号范围，补充生成稳定性与冲突回归。

feat: 支持配置缓冲点横向匹配距离

将 UpdateBufferRange 横向阈值参数化，默认保持 3 米。
配置加载及运行时对负数和非有限值回退默认值，保留零值语义。
同步 Full/Compact 配置合同与旧数据缺省恢复，补充过滤及往返回归。

fix: 补齐双向 IMV 普通路由换向停车处理

复用 SSEP 近换向线停稳处理，支持普通路由换向停车原因及解除前保持。
保留安全停车优先级，并使普通路由不受遗留 SSEP 首段倒车状态限制。
补充嵌套运动状态机回归及带 routing 初始化的可选 bag 验证入口。
现场 bag 回放仍受备用参考线索引缺失阻断，未作为通过验收依据。

fix: 调整中铁联集多车道进场末端直线距离

IMV 目标车道数不超过两条时保持末端附加直线距离 20 米，
超过两条时调整为 5 米。

fix: 增强集卡通用规划的车体碰撞与曲率修复

增加独立真实车体线段碰撞代价和固定权重收尾，保留扫掠修复候选及完整路径验收。对未构建或已移交的优化问题返回状态错误，补充碰撞、生命周期与重建恢复回归。

fix: 修复场景路径编码并完善可视化信息

统一路径查询的 URI 编码，区分加号、空格及字面百分号编码；增加原始文件路径展示与复制，补齐地图和诊断路径图例。覆盖页面脚本及真实 HTTP 浏览、下载、展示和巡检回归。

fix: 兼容现场 Protobuf 3.9.1 工具链

将 SSEP 与 Compact 的 110 个 proto3 optional 字段改为独立 oneof，
保留字段编号、类型、缺失与显式默认值语义；使用公开 case 接口
适配旧版生成代码，并同步描述符、数值字段清单和精确迁移指纹。

生产构建最低版本恢复为 3.9.1；独立 Workbench UI 保留原有 3.20
依赖。增加冻结旧合同的双向读写回归，不冻结完整文件阻止合法新增。
历史 baseline 和 21 项已有迁移例外保持不变。

验证：pnc_node 与四个测试目标使用 3.9.1 构建并链接 libprotobuf.so.20；
C++ 634 通过、12 跳过、0 失败；两版 protoc 的 wire 回归、生成物检查
及精确迁移检查通过。验证在本机 x86 CPU 环境完成，未实测 Orin。

fix: 修正离线工具引用 SSEP 生成头文件的路径

将两处 ssep/protos/scene.pb.h 引用改为 protos/scene.pb.h，
匹配工程已声明的 build/ssep include 根目录，解决 Orin 构建
snapshot_vehicle_trace 时生成头文件不可见的问题。

通过生成器更新受头文件内容影响的 AST 审计哈希，成员与合同不变。
移除本机缓存中掩盖问题的构建根目录 include 后，使用工程分布式入口
构建 snapshot_vehicle_trace、bag_to_keb_scene 和 pnc_node 通过。
验证在本机 x86 / Clang 18 / Protobuf 3.9.1 完成，未直接运行 Orin CI。