diff --git a/docs/architecture.md b/docs/architecture.md
index 07ba159..d937bc9 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -31,7 +31,7 @@
 | `sse.rs` | 流式 SSE 跨协议转换 + usage 计量 |
 | `billing.rs` | 计量计费：token → 价格 → CNY 锚定点数（1 点 = 1 元，5 位小数）；高峰时段计价 |
 | `gift.rs` | 新人每日赠送（注册起 10 天，当日有效，惰性过期清理） |
-| `auth.rs` / `mail.rs` | Bearer 认证（API Key）+ argon2；SMTP 验证码（重试 3 次） |
+| `auth.rs` / `mail.rs` | Bearer 认证（API Key）+ argon2；SMTP 验证码（重试 2 次，共 3 次尝试） |
 | `db.rs` | SQLite 建表 + 幂等迁移 + seed（models 表启动时同步 config `[[models]]`；测试用户 seed 仅测试） |
 | `dao.rs` | 数据访问层 |
 | `routes/` | 认证 / 钱包 / 交易 / 仪表盘 / 共享 / 管理 / 运营者 API |
diff --git a/docs/user-stories.md b/docs/user-stories.md
index 36d7b17..cd6038a 100644
--- a/docs/user-stories.md
+++ b/docs/user-stories.md
@@ -15,7 +15,7 @@
 ## 2. 核心流程
 
 ### 注册 → 首次消费
-1. 登录页自助注册（邮箱验证码激活，未验证不可登录；验证码可重发，SMTP 失败重试 3 次）
+1. 登录页自助注册（邮箱验证码激活，未验证不可登录；验证码可重发，SMTP 失败重试 2 次、最多共 3 次尝试）
 2. 首次登录获得每日赠送点数（注册起 10 天 × 1 点/天，当日有效）
 3. 选择模型 → 网关调用（余额预检 → 路由选 key → 计费）
 4. 交易记录查看明细：模型 / Key 列 + 输入(非缓存) / 缓存 / 输出 / 总 Token 四列