docs(auth): 补 switchRole 前端提醒 + 反向 cleanup 场景表 + #2294

changelogs/2026-05/14_feat_admin_auth_refresh_token.md

@@ -179,7 +179,26 @@ STEP 9: POST /admin/auth/refresh {篡改 refresh}      -> 401
 
 ---
 
+## switchRole 提醒(@mmg 重要)
+
+切换角色 `POST /admin/auth/switch-role` 响应也包含新的 refreshToken/accessTokenExpiresIn/refreshTokenExpiresIn 字段。前端必须同时更新本地存储的 **accessToken 和 refreshToken**(背后 jti 已轮换,旧 refresh 立即失效)。不要只取 token 字段。
+
+## 已审视的反向 cleanup 场景
+
+| 场景 | 是否清 token | 说明 |
+|---|---|---|
+| logout | 清 access + refresh | 主动登出 |
+| changePassword | 清 access + refresh | 改密强制重登 |
+| deleteAdmin | 清 access + refresh (#2294 补) | 删 admin 防绕过 |
+| resetPassword | 清 access + refresh (#2294 补) | 超管重置他人密码 |
+| login 账号锁定 (失败 5 次) | 清 access + refresh (#2294 补 + 修旧 bug) | 可疑账号防已签发 token 继续生效 |
+| switchRole | 不主动清 (jti 轮转自动覆盖) | issueAdminTokens 写新 jti 覆盖旧 |
+| login 成功 | 不主动清 (同 switchRole) | — |
+| unlockAdmin | 不清 | 登录态本就无效 |
+
 ## 相关文档
 
 - Issue: [wx/HL#2283](https://git.1814.love:8443/wx/HL/issues/2283)
-- PR: [wx/HL#2285](https://git.1814.love:8443/wx/HL/pulls/2285) + hotfix [wx/HL#2287](https://git.1814.love:8443/wx/HL/pulls/2287) (补 user-service TokenInterceptor 白名单)
+- PR 主体: [wx/HL#2285](https://git.1814.love:8443/wx/HL/pulls/2285)
+- Hotfix #2287: 补 user-service TokenInterceptor 白名单
+- Hotfix #2294: 补 deleteAdmin/resetPassword/账号锁定 3 处 refresh cleanup + 锁定旧 bug