diff --git a/docs/unified-ble-flow.md b/docs/unified-ble-flow.md
index b223426..17af9e4 100644
--- a/docs/unified-ble-flow.md
+++ b/docs/unified-ble-flow.md
@@ -137,6 +137,7 @@ async function runStandardFlow({ key, ssid, password }) {
 #### src/ble/discovery.js
 - `stopSearch`: `setSearching(false)` 提前到 `stopBluetoothDevicesDiscovery` 之前同步执行——部分机型原生停扫回调慢，等回调才翻转状态会让按钮长时间停在"搜索中"并串行阻塞连接等后续操作；`searchSessionId` 已递增、`acceptingDeviceEvents` 已关闭，先翻转状态安全
 - `connectDevice`: 由无条件 `stopSearch(false)` 改为仅在 `isSearching` 时停搜索，避免每次连接都白调一次原生停扫接口
+- 设备列表 UI 刷新加 300ms 节流（`emitDeviceListThrottled`）：`allowDuplicatesKey=true` 下目标设备广播包每秒到达数次且 RSSI 逐包变化，签名判重只拦"完全相同"的包；不节流时每包都触发 `onDeviceListChange` → React setState → 全列表重渲染，搜到设备后渲染线程被打满、点击排队卡死（表现为"搜到设备就无法停搜索"）。数据仍实时合入 `deviceMap`，仅通知 UI 频率受限；`resetDeviceMap`/`stopSearch` 绕过节流立即冲刷，`cleanupDiscovery` 补清节流定时器
 
 #### src/pages/device/ble-config.tsx
 - 补 `useDidHide` 停搜索：迁移版原只有 useEffect 卸载清理，`navigateTo` 进配网页/切后台时组件不卸载，扫描持续空转（对齐旧版 onHide/onUnload 双触发）