diff --git a/docs/debug-third-party-api.md b/docs/debug-third-party-api.md
index 2385cf1..fdbe65f 100644
--- a/docs/debug-third-party-api.md
+++ b/docs/debug-third-party-api.md
@@ -1,5 +1,26 @@
 # 客户现场调试指南 — 第三方接口联调
 
+## 前置：更新 Edge 设备可执行文件
+
+将 safesightd、safesight-edge-agent、safesight-edge-server 替换为最新版本：
+
+```bash
+tar xzf safesight-update.tar.gz
+cd safesight-update
+sudo systemctl stop safesightd safesight-edge-agent safesight-edge-server
+sudo cp safesightd /opt/safesightd/bin/
+sudo cp safesight-edge-agent /opt/safesight-edge-agent/
+sudo cp safesight-edge-server /opt/safesight-edge-server/bin/
+sudo chmod +x /opt/safesightd/bin/safesightd \
+  /opt/safesight-edge-agent/safesight-edge-agent \
+  /opt/safesight-edge-server/bin/safesight-edge-server
+sudo systemctl start safesightd safesight-edge-agent safesight-edge-server
+```
+
+> 本次更新修复了 agent 在 edge-server 热加载慢时错误回滚旧配置的问题。
+
+---
+
 ## 接口清单
 
 | 接口 | 地址 |
@@ -70,7 +91,11 @@ grep -oP '"(getTokenUrl|putMessageUrl|endpoint|bucket|access_key|tenantCode|url)
   | sort -u
 ```
 
-预期看到 `180.51.12.2` 的地址。如果全是空字符串，说明配置下发时集成服务未注入。
+预期看到 `180.51.12.2` 的地址。**如果全是空字符串**：
+
+1. 确认管理端「第三方服务」中地址已改为 `180.51.12.2`
+2. 用**向导**重新下发（不要用设备详情页的「下发当前设备分配」，那条路径不注入集成服务）
+3. 下发后再次执行上述 grep 确认地址已写入
 
 ### 实时跟踪告警和接口调用