diff --git a/docs/devlog.md b/docs/devlog.md
index 8e39108..891a4fa 100644
--- a/docs/devlog.md
+++ b/docs/devlog.md
@@ -4,6 +4,15 @@
 
 ---
 
+## 2026-09-04 — 故障补偿触发幅度量化说明（文档 V2.55，无代码改动）
+
+用户要求文档给出"多大的环境变化触发黄灯常亮"的具体数字。
+代码核实：触发 = dev=CAPVD−Origin > **+4×dlt**（纯比例制）连续 **2s**（ENV_WARN_WAIT=200，
+黄灯预判锁存）→ 连续 **7s**（ENV_RESYNC_WAIT=700）学习替换 Origin → 空闲 2s 黄灯灭。
+换算（L∝Xn²，dL/L≈2×dXn/Xn）：SENS=3 触发幅度 +0.15% Xn ≈ 等效电感量上升 +0.31%；
+SENS=0 为 +2.06% Xn ≈ +4.11%。仅处理 L 上升方向；L 下降=车辆语义冻结（10s 兜底更新）。
+spec 4.4.2 补量化表（分 SENS 档）；manual 4.x 故障补偿补一句。
+
 ## 2026-09-04 — 低Q 释放抗抖（固件 V4.36.19）
 
 > **固件版本：V4.36.19**。devlog 修订 V2.54。spec V2.35 / manual 已同步。
@@ -1922,6 +1931,7 @@ if (dev >= dlt_ORG × 4) {
 
 | 版本 | 时间 | 说明 |
 |------|------|------|
+| V2.55 | 2026-09-04 | 故障补偿触发幅度量化说明 (dev>+4×dlt; SENS=3≈电感+0.31%) |
 | V2.54 | 2026-09-04 | V4.36.19 低Q 释放抗抖: τ50ms 平滑判释放+带回×1.5 (REL_ALFA/REL_BAND_LO_MULT), 高/中Q 零影响 |
 | V2.53 | 2026-09-04 | V4.36.18 频率窗下界 20→18kHz (18~125kHz) |
 | V2.52 | 2026-09-04 | 安全复位观感勘误(无代码): 绿灯镜像继电器后复位指示变化; manual 4.5/spec 对齐实际行为 |
diff --git a/docs/product-manual.md b/docs/product-manual.md
index d057bbd..3a18a59 100644
--- a/docs/product-manual.md
+++ b/docs/product-manual.md
@@ -198,7 +198,7 @@ SW_5 = ON 时：车辆（金属）持续压线超过 **4 分钟**（LC_HOLD_TIME
 |------|------|------|------|------|
 | 环境校准学习中 | 呼吸 | 灭（无车） | **常亮** | 检测到**永久环境变化**（如旁置金属板被移走使基准被学低）：高位持续 **2 s** 黄灯预判**锁存**常亮，累计 **7 s**（V4.31 起，V4.26 曾 10s、更早 60s）后自动学习新基线并替换，恢复灵敏度 |
 
-- 线圈旁金属等目标在**上电时**在场会把空车基准学低；目标移走后检测高度会明显变低（V4.22 及以前需断电重上电或等基线慢跟恢复）。V4.24 起自动恢复；**V4.31 起节奏：约 2s 预判 → 累计 7s 触发学习 → 13s 替换 → 空闲 2s 恢复确认后灭（总 ~15s）**
+- 线圈旁金属等目标在**上电时**在场会把空车基准学低；目标移走后检测高度会明显变低（V4.22 及以前需断电重上电或等基线慢跟恢复）。V4.24 起自动恢复；**V4.31 起节奏：约 2s 预判 → 累计 7s 触发学习 → 13s 替换 → 空闲 2s 恢复确认后灭（总 ~15s）**。**触发幅度（2026-09-04 量化）：dev 超过 +4×进入带回（SENS=3 ≈ CAPVD 高于基线 0.15%，约等效电感量上升 0.31%；SENS=0 ≈ 2.06%/4.11%，分档表见技术规格）且持续不回落**
 - **黄灯常亮（锁存）= 环境异常预判/学习中**：一旦点亮，目标移走/回摆**不会立即灭灯**——需环境恢复正常（空闲）且稳定 **~2 s** 才解除。请勿在黄灯常亮期间移动线圈附近的金属目标（铁块静止 **7 s+** 也会被学入）
 - 黄灯优先级（V4.26）：断开快闪 > 故障补偿（环境预判/学习）常亮 > **线圈电感量不合理一长一短** > N 短闪（断开史）> 灭
 
diff --git a/docs/technical-spec.md b/docs/technical-spec.md
index e888216..4afe6c2 100644
--- a/docs/technical-spec.md
+++ b/docs/technical-spec.md
@@ -367,6 +367,24 @@ if (!VD_FLAG) {
 | 冻结超时 + 稳定性检查 | 防止永久冻结死锁（V2.3~2.5） |
 | 环境重校准（V4.24/26/30/31） | dev>+4×dlt 高位连续 7s（ENV_RESYNC_WAIT，V4.26 60s→10s，V4.30→8s，V4.31→7s）→ 判定永久环境变化 → 学习基线 B（空闲窗均值+判稳，黄灯常亮）→ 原子替换 Origin；铁块类瞬态 7s 内仍只冻结不污染 |
 
+**故障补偿/黄灯常亮触发幅度量化（2026-09-04 补充）**
+
+触发条件 = **dev = CAPVD − Origin > +4×dlt**（纯比例制，无绝对 counts 门槛；dlt = Origin×SensTable[SENS]>>16），且高位**连续**（期间回摆进 ±4dlt 窗口或目标靠近 dev<0 均清零重来）：
+- 连续 **2s**（ENV_WARN_WAIT=200）→ 黄灯常亮**预判锁存**（回摆不解除）
+- 连续 **7s**（ENV_RESYNC_WAIT=700）→ 判定永久环境变化 → 学习基线 B → 原子替换 Origin → 空闲连续 2s 黄灯灭（总 ~15s）
+
+仅处理 **CAPVD 高于 Origin**（等效电感量**上升**方向：铁磁体靠近 / 涡流型金属移走 / 环境 L 净升）。反方向（L 下降=车辆语义）冻结不学习，持续 ~10s 稳定后兜底更新（FREEZE_TIMEOUT，±2% 稳定窗）。
+
+| SENS 档 | SensTable 进入表 | dlt 占 Origin | **触发幅度（4×dlt）** | 折算等效电感量上升 | 折算频率下降 |
+|---|---|---|---|---|---|
+| 0（最低灵） | 337 | 0.514% | **+2.06%** | **+4.11%** | ≈ −1.02% |
+| 1 | 71 | 0.108% | **+0.43%** | **+0.87%** | ≈ −0.22% |
+| 2 | 38 | 0.058% | **+0.23%** | **+0.46%** | ≈ −0.12% |
+| 3（最高灵） | 25 | 0.038% | **+0.15%** | **+0.31%** | ≈ −0.08% |
+
+换算依据（43nF 板口径）：f = 240000/Xn；L = 2.533e7/(f²×C_nF) ⇒ L ∝ Xn²，小信号 dL/L ≈ 2×dXn/Xn ≈ 2×(dev/Origin)。
+现场实例（SENS=3，Origin=129868，dlt=49）：触发 CAPVD > 129868+196 = **130064**（+196 counts ≈ +0.15%）；日志 neg_var_freeze dev=+247~+2003（5×~41×dlt）均远超触发线。
+
 #### 4.4.3 基线更新速率（两阶段）
 
 | 阶段 | 窗口 | 周期 | 用途 |