diff --git a/docs/gallery.md b/docs/gallery.md
index ebf3bbb..d21446b 100644
--- a/docs/gallery.md
+++ b/docs/gallery.md
@@ -19,6 +19,9 @@ title: 效果展示

overtake_oncoming(借道超车遇对向来车)播放 8 秒:借对向车道超车 → 对向车接近 → 放弃超车回原车道(红圈为对向车,黄圈为慢车,11 帧;底部为口语输入与命中模板)
+
+cut_out(前车切出遇静止车辆)播放 6 秒:前车让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧;底部为口语输入与命中模板)
+

运行危险度指标:右上角实时显示自车速度、与行人距离与 TTC,末帧汇总碰撞/最小中心距/最小 TTC/最大减速度/末速
diff --git a/docs/img/scenario_cut_out.gif b/docs/img/scenario_cut_out.gif
new file mode 100644
index 0000000..58af7d6
Binary files /dev/null and b/docs/img/scenario_cut_out.gif differ
diff --git a/docs/new-features.md b/docs/new-features.md
index b820ed7..21b19ff 100644
--- a/docs/new-features.md
+++ b/docs/new-features.md
@@ -8,6 +8,83 @@ title: New Features
---
+## 2026-11 · 前车切出遇静止车辆场景
+
+本版新增 `cut_out` 模板:前车变道让出本车道,露出正前方的静止车辆,
+自车按相对距离制动停车。该场景对应 AEB 的 cut-out 测试。
+
+### 1. 用法
+
+```text
+前车突然向左变道,露出前方停着的故障车
+前车切出后,本车道正前方有一辆静止车辆
+```
+
+语义层把 `前车切出`、`切出`、`变道露出`、`露出前方`、`前方停着`
+等说法路由到该模板;输入同时含"变道"与"露出"或"前方"与"停着"时额外加权,
+避免落到只描述前车急刹的 `lead_brake`。
+
+```python
+plan_scenario("前车突然向左变道,露出前方停着的故障车")
+# → {"template": "cut_out", "confidence": 1.0, ...}
+```
+
+### 2. 场景编排
+
+自车 50 m 处起步、12 m/s,前方 28 m 处前车 9 m/s,再往前 36 m 停着一辆静止车辆。
+2.5 s 时前车向右变道让出本车道;自车与静止车中心距缩到 30 m 时线性制动到停车。
+
+| 时刻 | 事件 |
+|---|---|
+| 0 s | 自车 12 m/s、前车 9 m/s、静止车 0 m/s 同时布景 |
+| 2.5 s | 前车向右变道让出本车道,静止车进入视野 |
+| 距静止车 30 m | 自车线性制动 |
+| 约 5.9 s | 自车停在静止车前约 12 m,无碰撞 |
+
+参数:`s0`、`road_id`、`lane`、`ego_speed`、`lead_speed`、`lead_gap`、
+`stopped_gap`、`lc_delay`、`brake_gap`、`brake_time`,均可通过 `params_json` 覆盖。
+
+### 3. 城市地图
+
+模板默认按生成路网的 `roadId=1 / lane=-1 / s0=50` 布景。要在内置城市地图上运行,
+用 `road_id`、`lane`、`s0` 指定一段同向至少两条车道、无路侧障碍的长直路:
+
+```text
+run_scenario_in_carla(template="cut_out", map_name="Town10HD_Opt",
+ params_json='{"road_id": "12", "lane": "-1", "s0": 30}')
+```
+
+相对距离按两车中心点的直线距离计算,弯道会让距离缩减得比沿路里程慢,
+所以城市路段应尽量平直;路段内的静态车辆与路侧停放物需要调用方自行避开。
+
+### 4. 效果
+
+
+cut_out:前车切出让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧)
+
+### 5. 实测结果
+
+| 项目 | 结果 |
+|---|---|
+| 离线回归(18 个模板) | 全部通过,3 实体 / 5 事件 |
+| CARLA 实跑(`wide_straight`) | 5 个事件全部触发,2.55 s 前车切出,2.85 s 触发制动,无碰撞 |
+| 最小 TTC | 2.36 s(t=3.60 s,静止车) |
+| 最小中心距 | 11.64 m(t=5.85 s,静止车) |
+| 制动减速度 | 约 4.0 m/s²(12 m/s 经 3 s 线性刹停) |
+| 自车末速 | 0.04 m/s(已停止) |
+| 语义识别 | `前车切出`、`露出前方停着的故障车` 均命中 `cut_out` |
+
+### 6. 已知限制
+
+- 前车切出后继续以 9 m/s 行驶,会在片段后段驶过静止车辆旁侧,
+ 画面中两车短暂相邻,不代表冲突。
+- `lead_cut_out` 的变道方向 `-1` 针对 `wide_straight` 的车道编号,
+ 换用其他路网或城市地图时需确认目标车道存在。
+- 制动按 3 s 线性减速到 0,未接入真实 AEB 的分级触发逻辑。
+- 城市地图上路段由调用方指定,模板不做路侧静态物的避让检查。
+
+---
+
## 2026-11 · 借道超车遇对向来车场景
本版新增 `overtake_oncoming` 模板:自车借对向车道超越前方慢车,
diff --git a/docs/scenario.md b/docs/scenario.md
index 03db459..0bc8fe1 100644
--- a/docs/scenario.md
+++ b/docs/scenario.md
@@ -34,7 +34,7 @@ graph LR
|---|---|---|---|
| `file_path` | string | 必填 | 待校验的 `.xosc` 文件 |
-## 3. 17 个场景模板
+## 3. 18 个场景模板
| 模板 | 场景含义 | 实体数 | 主要触发 |
|---|---|---|---|
@@ -42,6 +42,7 @@ graph LR
| `lead_stationary` | 前车静止 | 2 | 时间 |
| `cut_in` | 危险切入 | 4 | 时间、时距、速度、到达 |
| `cut_in_then_brake` | 加塞后急刹 | 3 | 时间(变道、急刹分阶段) |
+| `cut_out` | 前车切出遇静止车辆(AEB cut-out) | 3 | 时间、相对距离 |
| `crossing_hazard` | 行人/车辆横穿 | 2 | 时间、距离 |
| `occluded_crossing` | 鬼探头(遮挡横穿) | 3 | 时间、距离 |
| `low_overlap` | 前方低重叠率目标 | 3 | 时间、距离、速度、到达 |
@@ -109,6 +110,54 @@ graph LR
与 `overtake` 的区别是多了对向车的存在与"放弃超车"的判定,
`overtake` 只演示变道超越,不处理会车冲突。
+### 3.3 前车切出遇静止车辆 `cut_out`
+
+双向直路上,自车以 12 m/s 跟随前方 9 m/s 的前车;前车在本车道前方 28 m 处,
+再往前 36 m 停着一辆静止车辆。2.5 s 时前车向右变道让出本车道,露出静止车辆;
+自车在距静止车 30 m 时线性制动到停车,最终停在静止车前约 12 m,无碰撞。
+
+该模板对应 AEB 的 cut-out 测试:目标并非突然出现,而是被前车遮挡,
+前车让开后才发现本车道正前方有静止障碍。
+
+```text
+前车突然向左变道,露出前方停着的故障车
+前车切出后,本车道正前方有一辆静止车辆
+```
+
+
+cut_out:前车切出让出本车道 → 露出静止车 → 自车制动停车(红圈为静止车,黄圈为前车,10 帧)
+
+| 参数 | 默认 | 说明 |
+|---|---|---|
+| `s0` | 50 m | 自车在所选车道上的起点弧长 |
+| `road_id` | `1` | 路段编号,城市地图上用于指定具体道路 |
+| `lane` | `-1` | 自车车道号,前车向 `lane-1` 变道 |
+| `ego_speed` | 12 m/s | 自车速度 |
+| `lead_speed` | 9 m/s | 前车速度 |
+| `lead_gap` | 28 m | 自车与前车的初始距离 |
+| `stopped_gap` | 36 m | 静止车与前车的距离 |
+| `lc_delay` | 2.5 s | 前车开始切出的时刻 |
+| `lc_time` | 1.6 s | 变道持续时间 |
+| `brake_gap` | 30 m | 自车开始制动的相对距离阈值 |
+| `brake_time` | 3.0 s | 制动到停车的时间 |
+
+触发同样是**相对距离**:自车与 `stopped` 的中心距小于 `brake_gap` 时,
+自车线性减速到 0。与 `cut_in` / `cut_in_then_brake` 的区别是冲突目标不是
+变道车辆本身,而是变道后暴露出来的静止障碍;与 `lead_stationary` 的区别是
+静止车辆初始被前车遮挡,自车直到前车切出后才需要响应。
+
+**城市地图**:模板默认按生成路网的 `roadId=1 / lane=-1 / s0=50` 布景。
+在 `Town03`、`Town10HD_Opt` 等内置地图上运行时,用 `road_id`、`lane`、`s0`
+指定一段**同向至少两条车道、无路侧障碍的长直路**:
+
+```text
+run_scenario_in_carla(template="cut_out", map_name="Town10HD_Opt",
+ params_json='{"road_id": "12", "lane": "-1", "s0": 30}')
+```
+
+相对距离按两车中心点的直线距离计算,弯道会让"距离缩减"比沿路里程更慢,
+因此城市路段应尽量平直;路段内的静态车辆、路侧停放物需要调用方自行避开。
+
## 4. 对话示例
```text