diff --git a/README.md b/README.md
index 4ef8050..4c6687b 100755
--- a/README.md
+++ b/README.md
@@ -23,6 +23,16 @@ FastAdmin是一款基于ThinkPHP+Bootstrap的极速后台开发框架。
 > `uniapp/` 入库的是**源码快照**（不含构建产物 `unpackage/`）。小程序端真正的「上线」仍需用微信开发者工具
 > `cli upload` 上传版本（命令见 `uniapp/README.md` §8.2）；服务器与远程仓库里的 `uniapp/` 用于版本归档与协作。
 
+> ⚠️ `origin` 配了**两个 `pushurl`**（gitcode 镜像 + 服务器裸仓库）。实测 gitcode 的 ref 广播偶发滞后，
+> 会出现「只更新了服务器、镜像那一路报 `Everything up-to-date`」的**静默跳过**（2026-10-17 复现一次）。
+> 因此推送后务必两端校验 `refs/heads/main` 指向同一 commit：
+> ```bash
+> git ls-remote origin                                                    # 服务器裸仓库
+> git ls-remote https://gitcode.gynhc.com/GuiZhouChengXuRuanJianKaiFaLiYanXia/fenleixinxi.git   # 镜像
+> # 不一致时显式补推镜像：
+> git push ssh://git@gitcode.gynhc.com:2222/GuiZhouChengXuRuanJianKaiFaLiYanXia/fenleixinxi.git main:main
+> ```
+
 ---