diff --git a/README.md b/README.md
index 7125739..e6db6c8 100644
--- a/README.md
+++ b/README.md
@@ -337,6 +337,8 @@ RocketMQ 这边直接复用 rocketmq-spring 原生的 `rocketmq.*` 配置（`nam
 
 ## 已知限制 / TODO
 
+> ⚠️ **升级注意（redis-stream）**：订阅 stream 的定时裁剪**默认开启**（2026-07 起）。升级后每个订阅过的 stream 按 `redis-stream.trim.maxlen`（未配则 10 万条）封顶，**堆积超过封顶时最老的未消费消息会被直接删掉**——裁剪只按条数、不看消费进度。堆积可能超限的场景，升级前把 `trim.maxlen` 调大或配 0/负数关闭；容量按「可容忍的最大停机时长 × 生产速率」估算，详见「配置项」一节的 `redis-stream.*` 表。
+
 按优先级列，详细的在 [`docs/mq-starter-改进优化清单.md`](./docs/mq-starter-改进优化清单.md)。
 
 P0，放量到生产前想补的：