diff --git a/gateway/README.md b/gateway/README.md
index 347a3af..16acd4a 100644
--- a/gateway/README.md
+++ b/gateway/README.md
@@ -22,7 +22,7 @@ UniServe Framework 的应用层网关，C++20 实现。
 | 密码哈希 | PBKDF2-HMAC-SHA256，100000 轮，16 字节随机盐，32 字节哈希 |
 | 密码强度校验 | 至少 8 字符；大写/小写/数字/特殊字符中至少 3 类 |
 | 邮箱格式校验 | 正则匹配 `^[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}$` |
-| 旧哈希自动迁移 | 登录时若发现 SHA256 旧哈希，验证通过后自动迁移为 PBKDF2 |
+| 旧哈希自动迁移 | 登录时若发现 SHA256 旧哈希，验证通过后自动迁移为 PBKDF2（⚠️ 当前源码中该迁移逻辑已被注释禁用，见 `main.cpp` L1102-1109，未生效） |
 | Token 机制 | `Base64(payload) + "_" + RSA-Sign(payload)`，验签 + 过期校验（默认 1 小时） |
 | 常数时间比较 | PBKDF2 验证用 `diff |= hash[i] ^ expected[i]` 防 timing attack |
 | CAPTCHA | 一次性、5 分钟过期，登录与注册均可选启用 |