docs/api/api-documentation.md

@@ -11,6 +11,8 @@
 3. **验证码有效期**: 所有验证码有效期为5分钟
 4. **频率限制**: 验证码发送限制1次/分钟，注册限制10次/5分钟
 5. **测试模式**: 开发环境下邮件服务返回206状态码，验证码在响应中返回
+6. **冷却时间自动清除**: 注册、密码重置、验证码登录成功后会自动清除验证码冷却时间，方便后续操作
+7. **邮件模板修复**: 登录验证码现在使用正确的邮件模板，内容为"登录验证码"而非"密码重置"
 
 ### 错误处理规范
 - **409 Conflict**: 资源冲突（用户名、邮箱已存在）
@@ -24,6 +26,7 @@
 2. 邮箱注册流程：先发送验证码 → 检查409冲突 → 使用验证码注册
 3. 测试模式下验证码在响应中返回，生产环境需用户查收邮件
 4. 实现重试机制处理429频率限制错误
+5. 注册/重置密码成功后，验证码冷却时间会自动清除，可立即发送新验证码
 
 ---
 
@@ -945,6 +948,11 @@
 
 ## 📊 版本更新记录
 
+### v1.1.2 (2025-12-25)
+- **验证码冷却优化**: 注册、密码重置、验证码登录成功后自动清除验证码冷却时间
+- **用户体验提升**: 成功操作后可立即发送新的验证码，无需等待冷却时间
+- **代码健壮性**: 冷却时间清除失败不影响主要业务流程
+
 ### v1.1.1 (2025-12-25)
 - **邮箱冲突检测优化**: 发送邮箱验证码前检查邮箱是否已被注册
 - **用户体验提升**: 避免向已注册邮箱发送无用验证码

docs/api/openapi.yaml

@@ -1,8 +1,8 @@
 openapi: 3.0.3
 info:
   title: Pixel Game Server - Auth API
-  description: 像素游戏服务器用户认证API接口文档 - 包含验证码登录功能和邮箱冲突检测
-  version: 1.1.1
+  description: 像素游戏服务器用户认证API接口文档 - 包含验证码登录功能、邮箱冲突检测、验证码冷却优化和邮件模板修复
+  version: 1.1.3
   contact:
     name: API Support
     email: support@example.com
@@ -489,7 +489,7 @@ paths:
       tags:
         - auth
       summary: 发送登录验证码
-      description: 向用户邮箱或手机发送登录验证码
+      description: 向用户邮箱或手机发送登录验证码。邮件内容使用专门的登录验证码模板，标题为"登录验证码"，内容说明用于登录验证而非密码重置。
       operationId: sendLoginVerificationCode
       requestBody:
         required: true